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

40 lines
2.1 KiB
Markdown
Raw Normal View History

2026-08-11 13:32:21 +08:00
# 父任务执行计划
父任务不直接修改产品代码;按以下顺序启动、检查并集成子任务。
## 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;这些动作仍需用户明确授权。