1688营销账户账单接入 #12

chenxi · 2026-08-06T15:16:31+08:00

chenxi commented

2026-08-06 15:16:31 +08:00

开工时标题使用 WIP: <任务名称> 并先填写“任务占用与边界”。Codex 已完成独立合并前自审。

任务占用与边界

任务名称：1688营销账户账单接入
实际开发者：chenxi
任务来源/团队分工：根据 Alibaba.xlsx 模板接入 JianSun 工作平台数据
目标结果：现有 Alibaba 子页面支持真实账单筛选、分页、汇总
预计修改路径：Pages Controller、EcommerceFinance Repository/快照刷新器、Alibaba Blade、相关测试
预计页面或路由：billing-transactions/marketing-account-bills/taobao-wechat（历史 slug，界面标题 Alibaba）
预计 Controller / Repository：Business\Pages；AlibabaBillRepository
数据源、表/视图和字段：jiansun / dbo.alibaba_bill；id、shopName、tradeDay、tradeTypeName、tradeAMTIn、tradeAMTOut
上游 source_key / scope：jiansun；marketing-account-bills.alibaba.list|summary|options
权限名、菜单键或共享组件：复用现有营销账户账单页面权限与 taobao-wechat 页签键；缓存按公司/权限隔离
明确不修改的范围：营销账户余额、上游数据、数据库结构、写入/导入逻辑、其他业务模块

查询边界：固定只读参数化 SQL；列表最多 100 条/页，按 tradeDay DESC, id DESC；列表/汇总 TTL 120 秒，选项 TTL 3600 秒；无数据保留筛选器和空状态，上游不可用显示局部错误。

开工碰撞检查

Codex 已执行 scripts/codex-task-preflight.ps1（本机无 pwsh，已执行等价人工检查）
已检查最新 main 和所有远程任务分支
已搜索主线既有页面、接口、Repository 和数据查询
未发现重叠；或已在下方写明相关分支和协调结论

相关分支、重叠项与协调结论：供应商应付分支和 migration compatibility hotfix 均与本任务路径、页面、表、source_key/scope 无重叠。

实际改动

完成内容：接入 Alibaba 真实明细、店铺/产品类型/日期筛选、四项汇总、分页、空状态和错误状态；登记后台快照刷新范围。
Codex 实际修改的文件：app/Http/Controllers/Business/Pages.php；modules/EcommerceFinance/Repositories/AlibabaBillRepository.php；modules/EcommerceFinance/Services/JianSunSnapshotRefresher.php；resources/views/banking/marketing_alibaba_bills/partials/embedded-table.blade.php；两项单元测试文件。
新增或变更的公共契约：marketing-account-bills.alibaba.list、.summary、.options；页面参数 shop_name、product_type、from、to。
与原计划的差异：未新增重复的 alibaba slug；复用当前界面已显示为 Alibaba 的历史 taobao-wechat 子页面。

验证证据

正常流程：本地实际页面展示五列、筛选、汇总和分页；2026-06-30 返回 48 条，入账 1500.00 元、出帐 6397.57 元、净额 -4897.57 元。
空数据/错误输入/无权限场景：2030-01-01 空结果页面正常；日期参数只接受 Y-m-d；页面继续复用既有侧边栏权限；上游异常返回局部错误状态。
受影响旧功能：营销账单页签与京东子视图回归测试通过。
自动测试及结果：本次相关 8 个测试、34 个断言全部通过。完整套件 365 通过，4 个与本次无关的既有失败：对账复数文案、两个 dashboard 302、空金额组件。
实际页面、接口或只读业务查询结果：真实只读查询 26018 条总记录、74 个店铺��项、16 个��品类型；桌面和 390px 移动宽度实际验证通过，移动表格局部横向滚动。

风险检查

不涉及金额、权限、审批、数据库迁移、生产配置或数据修复
如涉及上述高风险内容，已在下方写明影响、回滚和所需授权
未提交 .env、密码、Token、私钥、真实财务数据、生产日志或构建产物
前端改动符合 DESIGN.md；无前端改动则写“不适用”

高风险影响、回滚和授权状态：涉及只读金额汇总，不写上游、不迁移数据库。回滚为回退本 PR。生产共享配置尚未开放新 scope，本 PR 不执行生产配置变更或部署；发布前需按 SOP 单独登记精确范围并完成双实例快照验收。

合并前复查

已重新拉取远程引用并用实际修改范围再次运行碰撞检查
PR 不再是 WIP:，所有测试结果已经补齐
Codex 已重新读取原始需求和验收标准，并逐文件审核 origin/main...任务分支 的完整 diff
Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果
合并顺序不会覆盖其他未合并任务
已授权当前任务的 Codex 执行 Squash merge、验证 main 并清理任务分支
如涉及生产迁移、数据修复、删除、覆盖配置或部署，已另行取得对应高风险授权（本 PR 不执行这些操作）

> 开工时标题使用 `WIP: <任务名称>` 并先填写“任务占用与边界”。Codex 已完成独立合并前自审。 ## 任务占用与边界 - 任务名称：1688营销账户账单接入 - 实际开发者：chenxi - 任务来源/团队分工：根据 Alibaba.xlsx 模板接入 JianSun 工作平台数据 - 目标结果：现有 Alibaba 子页面支持真实账单筛选、分页、汇总 - 预计修改路径：Pages Controller、EcommerceFinance Repository/快照刷新器、Alibaba Blade、相关测试 - 预计页面或路由：`billing-transactions/marketing-account-bills/taobao-wechat`（历史 slug，界面标题 Alibaba） - 预计 Controller / Repository：`Business\Pages`；`AlibabaBillRepository` - 数据源、表/视图和字段：`jiansun` / `dbo.alibaba_bill`；`id`、`shopName`、`tradeDay`、`tradeTypeName`、`tradeAMTIn`、`tradeAMTOut` - 上游 `source_key` / `scope`：`jiansun`；`marketing-account-bills.alibaba.list|summary|options` - 权限名、菜单键或共享组件：复用现有营销账户账单页面权限与 `taobao-wechat` 页签键；缓存按公司/权限隔离 - 明确不修改的范围：营销账户余额、上游数据、数据库结构、写入/导入逻辑、其他业务模块查询边界：固定只读参数化 SQL；列表最多 100 条/页，按 `tradeDay DESC, id DESC`；列表/汇总 TTL 120 秒，选项 TTL 3600 秒；无数据保留筛选器和空状态，上游不可用显示局部错误。 ## 开工碰撞检查 - [ ] Codex 已执行 `scripts/codex-task-preflight.ps1`（本机无 pwsh，已执行等价人工检查） - [x] 已检查最新 `main` 和所有远程任务分支 - [x] 已搜索主线既有页面、接口、Repository 和数据查询 - [x] 未发现重叠；或已在下方写明相关分支和协调结论相关分支、重叠项与协调结论：供应商应付分支和 migration compatibility hotfix 均与本任务路径、页面、表、source_key/scope 无重叠。 ## 实际改动 - 完成内容：接入 Alibaba 真实明细、店铺/产品类型/日期筛选、四项汇总、分页、空状态和错误状态；登记后台快照刷新范围。 - Codex 实际修改的文件：`app/Http/Controllers/Business/Pages.php`；`modules/EcommerceFinance/Repositories/AlibabaBillRepository.php`；`modules/EcommerceFinance/Services/JianSunSnapshotRefresher.php`；`resources/views/banking/marketing_alibaba_bills/partials/embedded-table.blade.php`；两项单元测试文件。 - 新增或变更的公共契约：`marketing-account-bills.alibaba.list`、`.summary`、`.options`；页面参数 `shop_name`、`product_type`、`from`、`to`。 - 与原计划的差异：未新增重复的 `alibaba` slug；复用当前界面已显示为 Alibaba 的历史 `taobao-wechat` 子页面。 ## 验证证据 - 正常流程：本地实际页面展示五列、筛选、汇总和分页；2026-06-30 返回 48 条，入账 1500.00 元、出帐 6397.57 元、净额 -4897.57 元。 - 空数据/错误输入/无权限场景：2030-01-01 空结果页面正常；日期参数只接受 Y-m-d；页面继续复用既有侧边栏权限；上游异常返回局部错误状态。 - 受影响旧功能：营销账单页签与京东子视图回归测试通过。 - 自动测试及结果：本次相关 8 个测试、34 个断言全部通过。完整套件 365 通过，4 个与本次无关的既有失败：对账复数文案、两个 dashboard 302、空金额组件。 - 实际页面、接口或只读业务查询结果：真实只读查询 26018 条总记录、74 个店铺��项、16 个��品类型；桌面和 390px 移动宽度实际验证通过，移动表格局部横向滚动。 ## 风险检查 - [ ] 不涉及金额、权限、审批、数据库迁移、生产配置或数据修复 - [x] 如涉及上述高风险内容，已在下方写明影响、回滚和所需授权 - [x] 未提交 `.env`、密码、Token、私钥、真实财务数据、生产日志或构建产物 - [x] 前端改动符合 `DESIGN.md`；无前端改动则写“不适用” 高风险影响、回滚和授权状态：涉及只读金额汇总，不写上游、不迁移数据库。回滚为回退本 PR。生产共享配置尚未开放新 scope，本 PR 不执行生产配置变更或部署；发布前需按 SOP 单独登记精确范围并完成双实例快照验收。 ## 合并前复查 - [x] 已重新拉取远程引用并用实际修改范围再次运行碰撞检查 - [x] PR 不再是 `WIP:`，所有测试结果已经补齐 - [x] Codex 已重新读取原始需求和验收标准，并逐文件审核 `origin/main...任务分支` 的完整 diff - [x] Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果 - [x] 合并顺序不会覆盖其他未合并任务 - [x] 已授权当前任务的 Codex 执行 Squash merge、验证 `main` 并清理任务分支 - [x] 如涉及生产迁移、数据修复、删除、覆盖配置或部署，已另行取得对应高风险授权（本 PR 不执行这些操作）

chenxi added 1 commit 2026-08-06 16:05:20 +08:00

接入 Alibaba 营销账户账单 43eb6ae1a3

chenxi changed title from ~~WIP: 1688营销账户账单接入~~ to 1688营销账户账单接入

2026-08-06 16:06:44 +08:00

chenxi merged commit a9fd2cfb37 into main

2026-08-06 16:07:31 +08:00

chenxi referenced this issue from a commit

2026-08-06 16:07:33 +08:00

接入 1688 营销账户账单 (#12)

Sign in to join this conversation.