zhixing-system/.trellis/tasks/archive/2026-08/08-11-market-data-sync-performance-audit/implement.md

父任务执行计划

父任务不直接修改产品代码；按以下顺序启动、检查并集成子任务。

1. 子任务顺序

1. 完成 08-11-market-sync-concurrency-storage。
   • 先锁定并发、频控、数据库池和批量接口。
   • 完成后运行后端全量质量门禁和无网络基准。
2. 完成 08-11-market-integrity-check-api。
   • 以前一子任务的连接池与 advisory lock 契约为依赖。
   • 完成迁移、只读检查、后台任务和 HTTP 契约后运行后端全量门禁。
3. 完成 08-11-market-integrity-check-web。
   • 只消费已冻结的 HTTP 模型和状态值。
   • 完成导航、路由、触发/轮询和问题展示后运行前端全量门禁。

2. 集成检查

• 检查三个子任务的字段、状态和路径完全一致。
• 模拟同步持锁时触发检查，以及检查持锁时启动同步，确认不会并发修改/读取快照。
• 确认检查批次不影响首页最近同步、selection 数据源选择或 CLI 退出码。
• 确认运行检查时不会构造或调用 Tushare adapter。
• 运行迁移 upgrade/downgrade（测试数据库可用时）并核对 schema metadata。
• 运行根目录 ./dev.sh check 与 ./dev.sh test。
• 检查四种 Compose config。

3. 生产验收与回退

• 首次部署先执行迁移，再用少量股票/测试环境验证 8 worker 和共享频控日志。
• 生产正常批次记录总耗时、频控次数、累计冷却时间、失败数和覆盖率；目标约 30 分钟。
• 如频控导致失败率上升，通过 ZHIXING_MARKET_DATA_MAX_WORKERS 降低并发。
• 完整性检查先在非交易时段触发；确认只产生检查表写入，不改变事实表行数或 CSV mtime。

4. 完成门禁

• 三个子任务 acceptance criteria 全部有实际验证证据。
• 父 PRD 中所有 acceptance criteria 可映射到子任务测试或生产验收项。
• 完成 trellis-check 后再评估是否有经用户批准、值得提升到 .trellis/spec/ 的规则。
• 不自动 commit、push、archive；这些动作仍需用户明确授权。