WuYongJie/CaiWuXiTong
1
0
Fork 0
Code Issues Pull Requests 5 Packages Projects Releases Wiki Activity

京东营销账户账单接入 JianSun #17

Closed
chenxi wants to merge 3 commits from feature/chenxi-jd-wallet-upstream into main
pull from: feature/chenxi-jd-wallet-upstream
merge into: WuYongJie:main
Conversation 0 Commits 3 Files Changed 7 +540 -30
chenxi commented 2026-08-06 18:04:16 +08:00
Collaborator
Copy Link

任务占用与边界

  • 任务名称：京东营销账户账单接入 JianSun
  • 实际开发者：chenxi
  • 目标结果：京东充值、消耗子页按附件字段读取工作平台数据，支持店铺/日期筛选、万元汇总和分页
  • 数据源：jiansun；dbo.jd_spreadBills、dbo.jd_costBills；固定字段只读查询
  • 页面：billing-transactions/marketing-account-bills/jd-wallet
  • 明确不修改：其他营销账户页、生产数据库、上游表结构、权限和部署

实际改动

  • 新增 JdWalletBillRepository，归一化京东充值和消耗字段，统一金额为元，消耗负值按绝对值展示。
  • 京东页面改为上游只读专用表格，保留充值/消耗子页，汇总金额显示万元，筛选和分页保留查询参数。
  • JianSunSnapshotRefresher 登记 jd-wallet-bills.recharge/consumption 的 list、summary、options scope。
  • 更新京东页面测试并新增 Repository 归一化测试。

验证证据

  • 83 tests passed, 881 assertions：Business 页面及 EcommerceFinance 单元测试。
  • 本地真实充值页：25 条明细，汇总 2,007.22 万元，分页可用。
  • 本地真实消耗页：25 条明细，汇总 1,943.81 万元，分页可用。
  • 日期筛选 2026-08-03：返回 127 条消耗账单，分页链接保留筛选参数。
  • 本地应用容器仅重启清理 PHP 运行缓存，未重建镜像、未执行迁移。

风险检查

  • 涉及金额和上游数据库读取：只读 SQL、参数化绑定、无写操作；回滚为回退本提交。
  • 生产部署前需在 JianSun 连接的 allowed_scopes 精确加入 jd-wallet-bills.recharge.* 和 jd-wallet-bills.consumption.*，不使用全局通配符。
  • 未提交 .env、密码、Token 或真实财务文件。
  • 前端符合 DESIGN.md 黑金令牌和表格规范。

协作兼容边界

  • 本 PR 仅写入 app/Http/Controllers/Business/Pages.php 中营销账户的 jd-wallet 专用处理，以及京东钱包账单的 Repository、刷新器、嵌入表格和对应测试。
  • 本 PR 不修改通用 business.pages.show 路由、Pages::show()、config/business_navigation.php、通用导航或权限契约。
  • 只在 config/business_navigation.php 和独立测试文件中新增页面的任务，可以并行进行：将 business.pages.show 声明为“仅复用、不修改”即可；不得编辑本 PR 的 Pages.php、Repository、刷新器或视图文件。
  • 如后续任务确实需要改动上述共享实现，必须先在 WIP PR 中改为“将写入”，重新运行预检并与本 PR 协调。
## 任务占用与边界 - 任务名称：京东营销账户账单接入 JianSun - 实际开发者：chenxi - 目标结果：京东充值、消耗子页按附件字段读取工作平台数据，支持店铺/日期筛选、万元汇总和分页 - 数据源：jiansun；dbo.jd_spreadBills、dbo.jd_costBills；固定字段只读查询 - 页面：billing-transactions/marketing-account-bills/jd-wallet - 明确不修改：其他营销账户页、生产数据库、上游表结构、权限和部署 ## 实际改动 - 新增 JdWalletBillRepository，归一化京东充值和消耗字段，统一金额为元，消耗负值按绝对值展示。 - 京东页面改为上游只读专用表格，保留充值/消耗子页，汇总金额显示万元，筛选和分页保留查询参数。 - JianSunSnapshotRefresher 登记 jd-wallet-bills.recharge/consumption 的 list、summary、options scope。 - 更新京东页面测试并新增 Repository 归一化测试。 ## 验证证据 - `83 tests passed, 881 assertions`：Business 页面及 EcommerceFinance 单元测试。 - 本地真实充值页：25 条明细，汇总 2,007.22 万元，分页可用。 - 本地真实消耗页：25 条明细，汇总 1,943.81 万元，分页可用。 - 日期筛选 `2026-08-03`：返回 127 条消耗账单，分页链接保留筛选参数。 - 本地应用容器仅重启清理 PHP 运行缓存，未重建镜像、未执行迁移。 ## 风险检查 - 涉及金额和上游数据库读取：只读 SQL、参数化绑定、无写操作；回滚为回退本提交。 - 生产部署前需在 JianSun 连接的 `allowed_scopes` 精确加入 `jd-wallet-bills.recharge.*` 和 `jd-wallet-bills.consumption.*`，不使用全局通配符。 - 未提交 `.env`、密码、Token 或真实财务文件。 - 前端符合 `DESIGN.md` 黑金令牌和表格规范。 ## 协作兼容边界 - 本 PR 仅写入 `app/Http/Controllers/Business/Pages.php` 中营销账户的 `jd-wallet` 专用处理，以及京东钱包账单的 Repository、刷新器、嵌入表格和对应测试。 - 本 PR **不修改**通用 `business.pages.show` 路由、`Pages::show()`、`config/business_navigation.php`、通用导航或权限契约。 - 只在 `config/business_navigation.php` 和独立测试文件中新增页面的任务，可以并行进行：将 `business.pages.show` 声明为“仅复用、不修改”即可；不得编辑本 PR 的 `Pages.php`、Repository、刷新器或视图文件。 - 如后续任务确实需要改动上述共享实现，必须先在 WIP PR 中改为“将写入”，重新运行预检并与本 PR 协调。
chenxi added 1 commit 2026-08-06 18:30:33 +08:00
chenxi changed title from WIP: 京东营销账户账单接入 JianSun to 京东营销账户账单接入 JianSun 2026-08-06 18:30:57 +08:00
chenxi added 1 commit 2026-08-06 18:39:31 +08:00
chenxi added 1 commit 2026-08-07 10:20:17 +08:00
WuYongJie closed this pull request 2026-08-11 12:23:59 +08:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aaron chenxi DoDo huilan jj404877757 limeng qiuxiang renshen shanshi sumu wangshu yueyang yutu zhoushengchen WuYongJie
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WuYongJie/CaiWuXiTong#17
No description provided.
Delete Branch "feature/chenxi-jd-wallet-upstream"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?