修复上游业务页面快照完整性 #2

Merged
WuYongJie merged 2 commits from fix/WuYongJie-upstream-snapshot-readiness into main 2026-08-03 18:22:46 +08:00
Owner

任务占用与边界

  • 任务名称:修复上游业务页面快照完整性
  • 实际开发者:WuYongJie
  • 任务来源/团队分工:项目负责人反馈生产业务页面空数据、503 与首份快照长期未生成
  • 目标结果:所有已接入上游的页面能够公平生成列表、汇总和筛选项快照;未放行范围明确列出并走生产授权
  • 预计修改路径:modules/EcommerceFinance/Services/UpstreamQueryCache.php;tests/Unit/EcommerceFinance/JianSunQueryCacheTest.php
  • 预计页面或路由:所有使用 upstream snapshots 的业务页面与 workspace-data 接口
  • 预计 Controller / Repository:不修改业务 Repository;修复共享 UpstreamQueryCache 调度
  • 数据源、表/视图和字段:jiansun 已有固定只读 Repository;不新增表、不改字段
  • 上游 source_key / scope:jiansun;goods.、invoice-deductions.、taobao-alipay-bills.* 及既有快照范围
  • 权限名、菜单键或共享组件:不修改
  • 明确不修改的范围:不写生产数据库、不迁移、不部署、不修改上游 SQL 与业务金额逻辑

开工碰撞检查

  • Codex 已执行 scripts/codex-task-preflight.ps1
  • 已检查最新 main 和所有远程任务分支
  • 已搜索主线既有页面、接口、Repository 和数据查询
  • 未发现当前计划文件重叠

相关分支、重叠项与协调结论:两个历史本地共享数据库分支涉及 Pages.php 等文件;本任务缩小为 UpstreamQueryCache 与对应单测,不与其重叠。

实际改动

  • 完成内容:WIP
  • Codex 实际修改的文件:WIP
  • 新增或变更的公共契约:WIP
  • 与原计划的差异:WIP

验证证据

  • 正常流程:WIP
  • 空数据/错误输入/无权限场景:WIP
  • 受影响旧功能:WIP
  • 自动测试及结果:WIP
  • 实际页面、接口或只读业务查询结果:WIP

风险检查

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

高风险影响、回滚和授权状态:代码修复本身不写生产数据;生产 allowed_scopes 调整、快照生成和部署必须另行取得明确授权。

合并前复查

  • 已重新拉取远程引用并用实际修改范围再次运行碰撞检查
  • PR 不再是 WIP:,所有测试结果已经补齐
  • Codex 已重新读取原始需求和验收标准,并逐文件审核完整 diff
  • Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果
  • 合并顺序不会覆盖其他未合并任务
  • 已授权当前任务的 Codex执行 Squash merge、验证 main 并清理任务分支
  • 如涉及生产迁移、数据修复、删除、覆盖配置或部署,已另行取得对应高风险授权
## 任务占用与边界 - 任务名称:修复上游业务页面快照完整性 - 实际开发者:WuYongJie - 任务来源/团队分工:项目负责人反馈生产业务页面空数据、503 与首份快照长期未生成 - 目标结果:所有已接入上游的页面能够公平生成列表、汇总和筛选项快照;未放行范围明确列出并走生产授权 - 预计修改路径:modules/EcommerceFinance/Services/UpstreamQueryCache.php;tests/Unit/EcommerceFinance/JianSunQueryCacheTest.php - 预计页面或路由:所有使用 upstream snapshots 的业务页面与 workspace-data 接口 - 预计 Controller / Repository:不修改业务 Repository;修复共享 UpstreamQueryCache 调度 - 数据源、表/视图和字段:jiansun 已有固定只读 Repository;不新增表、不改字段 - 上游 source_key / scope:jiansun;goods.*、invoice-deductions.*、taobao-alipay-bills.* 及既有快照范围 - 权限名、菜单键或共享组件:不修改 - 明确不修改的范围:不写生产数据库、不迁移、不部署、不修改上游 SQL 与业务金额逻辑 ## 开工碰撞检查 - [x] Codex 已执行 scripts/codex-task-preflight.ps1 - [x] 已检查最新 main 和所有远程任务分支 - [x] 已搜索主线既有页面、接口、Repository 和数据查询 - [x] 未发现当前计划文件重叠 相关分支、重叠项与协调结论:两个历史本地共享数据库分支涉及 Pages.php 等文件;本任务缩小为 UpstreamQueryCache 与对应单测,不与其重叠。 ## 实际改动 - 完成内容:WIP - Codex 实际修改的文件:WIP - 新增或变更的公共契约:WIP - 与原计划的差异:WIP ## 验证证据 - 正常流程:WIP - 空数据/错误输入/无权限场景:WIP - 受影响旧功能:WIP - 自动测试及结果:WIP - 实际页面、接口或只读业务查询结果:WIP ## 风险检查 - [ ] 不涉及金额、权限、审批、数据库迁移、生产配置或数据修复 - [x] 如涉及上述高风险内容,已在下方写明影响、回滚和所需授权 - [x] 未提交 .env、密码、Token、私钥、真实财务数据、生产日志或构建产物 - [x] 前端改动符合 DESIGN.md;无前端改动,不适用 高风险影响、回滚和授权状态:代码修复本身不写生产数据;生产 allowed_scopes 调整、快照生成和部署必须另行取得明确授权。 ## 合并前复查 - [ ] 已重新拉取远程引用并用实际修改范围再次运行碰撞检查 - [ ] PR 不再是 WIP:,所有测试结果已经补齐 - [ ] Codex 已重新读取原始需求和验收标准,并逐文件审核完整 diff - [ ] Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果 - [ ] 合并顺序不会覆盖其他未合并任务 - [ ] 已授权当前任务的 Codex执行 Squash merge、验证 main 并清理任务分支 - [ ] 如涉及生产迁移、数据修复、删除、覆盖配置或部署,已另行取得对应高风险授权
WuYongJie added 1 commit 2026-08-03 18:12:28 +08:00
WuYongJie added 1 commit 2026-08-03 18:20:30 +08:00
WuYongJie changed title from WIP: 修复上游业务页面快照完整性 to 修复上游业务页面快照完整性 2026-08-03 18:21:18 +08:00
Author
Owner

合并前自审完成。

  • 实际改动:首份/过期快照按等待时间公平调度,避免新列表请求长期挤掉 summary/options;不提高每轮查询数量。
  • 文件:modules/EcommerceFinance/Services/UpstreamQueryCache.php;tests/Unit/EcommerceFinance/JianSunQueryCacheTest.php。
  • 自动测试:13 passed,140 assertions;两个 PHP 文件语法检查通过。
  • 生产只读核查:45 个固定上游查询均能执行;板材扣款已显示有效记录;货款对账生产 503 是 goods.* 未放行;发票扣款列表 195 条,但 summary/options 尚无首份快照。
  • 风险:代码不写生产数据、不调整金额逻辑。生产 allowed_scopes、首份快照生成和部署仍需单独高风险授权。
  • 自审:已重新拉取 main、复跑碰撞检查、检查完整 diff、确认仅 2 个任务文件且无敏感内容。
合并前自审完成。 - 实际改动:首份/过期快照按等待时间公平调度,避免新列表请求长期挤掉 summary/options;不提高每轮查询数量。 - 文件:modules/EcommerceFinance/Services/UpstreamQueryCache.php;tests/Unit/EcommerceFinance/JianSunQueryCacheTest.php。 - 自动测试:13 passed,140 assertions;两个 PHP 文件语法检查通过。 - 生产只读核查:45 个固定上游查询均能执行;板材扣款已显示有效记录;货款对账生产 503 是 goods.* 未放行;发票扣款列表 195 条,但 summary/options 尚无首份快照。 - 风险:代码不写生产数据、不调整金额逻辑。生产 allowed_scopes、首份快照生成和部署仍需单独高风险授权。 - 自审:已重新拉取 main、复跑碰撞检查、检查完整 diff、确认仅 2 个任务文件且无敏感内容。
WuYongJie merged commit e144a3562c into main 2026-08-03 18:22:46 +08:00
WuYongJie deleted branch fix/WuYongJie-upstream-snapshot-readiness 2026-08-03 18:22:47 +08:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WuYongJie/CaiWuXiTong#2
No description provided.