恢复店铺营销账户余额页面 #40

chenxi · 2026-08-13T11:25:53+08:00

chenxi commented

2026-08-13 11:25:53 +08:00

任务占用与边界

任务名称：恢复店铺营销账户余额页面
实际开发者：chenxi
目标结果：恢复淘系账户、拼多多账户月度余额表、筛选、分页与导出；其他平台保持未配置状态
预计及实际修改路径：Pages 控制器、营销余额导航、拼多多/淘系 Repository、JianSun 快照刷新器、余额 Blade、导出路由及对应测试
将写入的公共契约：marketing-account-balance 菜单；Pages::contentForMarketingAccountBalance；Pages::export；两个 Repository 的 paginateMonthlyBalances；monthly-balances 快照视图；business.pages.export 路由
仅复用、明确不修改：认证和公司识别；UpstreamQueryCacheFactory；普通营销账单逻辑；京东账单；店铺收款账单
数据源：jiansun dbo.pddSpreadBill、dbo.tmallTaoBaoSpreadBill，只读查询
明确不修改：其他余额平台、数据库结构、生产配置

开工碰撞检查

已检查最新 main 和全部远程任务分支
已搜索主线既有页面、接口、Repository 和查询
已区分将写入和仅复用契约
未发现未协调的业务契约重叠

协调结论：旧 feature/chenxi-marketing-balance-export 是恢复来源并由本 PR 取代；feature/limeng-quote-management 仅同改导航文件中的报价管理菜单，业务契约不重叠。当前 Mac 未安装 PowerShell，因此按预检脚本规则执行了等价只读检查。

实际改动

完成内容：恢复余额平台标签；淘系和拼多多按店铺/月汇总；恢复店铺/月筛选、查询、清除、导出、分页；其他平台显示未配置
Codex 实际修改：12 个受控文件，未包含环境配置或构建产物
新增或变更契约：同开工范围
与原计划差异：无；旧提交中混杂的京东及普通账单改动未移植

验证证据

正常流程：父页面自动进入淘系；淘系和拼多多均显示 11 列表头、筛选及 25 行真实月度数据
空数据/错误输入/无权限：非法月份归一为空；控制器保留上游错误提示；导出仅允许已授权的余额页及两平台
受影响旧功能：京东余额仍显示未配置；京东充值/消耗账单正常
自动测试：16 tests，100 assertions，全部通过；PHP 语法检查通过；git diff --check 通过
实际页面：本地 127.0.0.1:18088 已用内置浏览器验证

风险检查

不涉及金额、权限、审批、数据库迁移、生产配置或数据修复
涉及金额汇总，公式和分/元转换均有单元测试
未提交敏感内容
前端符合 DESIGN.md，复用 VIP 黑金令牌；无批准偏差

高风险影响与回滚：只读汇总展示，不写上游数据库、不迁移；回滚本 PR 即可。用户已授权恢复。

合并前复查

已重新拉取远程引用并检查实际范围
PR 测试结果已补齐且已移除 WIP
已按 origin/main...任务分支逐文件审核完整差异
无越界修改、重复实现、敏感内容或冲突
合并不会覆盖其他未合并任务
已授权当前 Codex 执行 Squash merge、验证 main 并清理分支
不涉及生产迁移、数据修复、删除、覆盖配置或部署

## 任务占用与边界 - 任务名称：恢复店铺营销账户余额页面 - 实际开发者：chenxi - 目标结果：恢复淘系账户、拼多多账户月度余额表、筛选、分页与导出；其他平台保持未配置状态 - 预计及实际修改路径：Pages 控制器、营销余额导航、拼多多/淘系 Repository、JianSun 快照刷新器、余额 Blade、导出路由及对应测试 - 将写入的公共契约：marketing-account-balance 菜单；Pages::contentForMarketingAccountBalance；Pages::export；两个 Repository 的 paginateMonthlyBalances；monthly-balances 快照视图；business.pages.export 路由 - 仅复用、明确不修改：认证和公司识别；UpstreamQueryCacheFactory；普通营销账单逻辑；京东账单；店铺收款账单 - 数据源：jiansun dbo.pddSpreadBill、dbo.tmallTaoBaoSpreadBill，只读查询 - 明确不修改：其他余额平台、数据库结构、生产配置 ## 开工碰撞检查 - [x] 已检查最新 main 和全部远程任务分支 - [x] 已搜索主线既有页面、接口、Repository 和查询 - [x] 已区分将写入和仅复用契约 - [x] 未发现未协调的业务契约重叠协调结论：旧 feature/chenxi-marketing-balance-export 是恢复来源并由本 PR 取代；feature/limeng-quote-management 仅同改导航文件中的报价管理菜单，业务契约不重叠。当前 Mac 未安装 PowerShell，因此按预检脚本规则执行了等价只读检查。 ## 实际改动 - 完成内容：恢复余额平台标签；淘系和拼多多按店铺/月汇总；恢复店铺/月筛选、查询、清除、导出、分页；其他平台显示未配置 - Codex 实际修改：12 个受控文件，未包含环境配置或构建产物 - 新增或变更契约：同开工范围 - 与原计划差异：无；旧提交中混杂的京东及普通账单改动未移植 ## 验证证据 - 正常流程：父页面自动进入淘系；淘系和拼多多均显示 11 列表头、筛选及 25 行真实月度数据 - 空数据/错误输入/无权限：非法月份归一为空；控制器保留上游错误提示；导出仅允许已授权的余额页及两平台 - 受影响旧功能：京东余额仍显示未配置；京东充值/消耗账单正常 - 自动测试：16 tests，100 assertions，全部通过；PHP 语法检查通过；git diff --check 通过 - 实际页面：本地 127.0.0.1:18088 已用内置浏览器验证 ## 风险检查 - [ ] 不涉及金额、权限、审批、数据库迁移、生产配置或数据修复 - [x] 涉及金额汇总，公式和分/元转换均有单元测试 - [x] 未提交敏感内容 - [x] 前端符合 DESIGN.md，复用 VIP 黑金令牌；无批准偏差高风险影响与回滚：只读汇总展示，不写上游数据库、不迁移；回滚本 PR 即可。用户已授权恢复。 ## 合并前复查 - [x] 已重新拉取远程引用并检查实际范围 - [x] PR 测试结果已补齐且已移除 WIP - [x] 已按 origin/main...任务分支逐文件审核完整差异 - [x] 无越界修改、重复实现、敏感内容或冲突 - [x] 合并不会覆盖其他未合并任务 - [x] 已授权当前 Codex 执行 Squash merge、验证 main 并清理分支 - [x] 不涉及生产迁移、数据修复、删除、覆盖配置或部署

chenxi added 1 commit 2026-08-13 11:25:53 +08:00

chore: reserve marketing balance restoration a071e4b9eb

chenxi added 1 commit 2026-08-13 11:39:36 +08:00

fix: restore marketing account balances on main 2506749570

chenxi changed title from ~~WIP: 恢复店铺营销账户余额页面~~ to 恢复店铺营销账户余额页面

2026-08-13 11:41:26 +08:00

chenxi merged commit 5511dfb221 into main

2026-08-13 11:41:42 +08:00

chenxi referenced this issue from a commit

2026-08-13 11:41:43 +08:00

恢复店铺营销账户余额页面 (#40)

Sign in to join this conversation.