docs(spec): F1-5b D1-D4 P20 SPEC 同步 + audit dashboard 刷新 (W1)
F1-5b 大量代码改动落地后,同步 P20 SPEC 反映现状,防止文档与代码偏差。 D1 §6 与 ETL 影子衔接: - 新增 §6.1 "F1-5b 收益":app 视图业务日上界裁剪范围 + 后端读取层 + 写入层 sandbox 隔离 + 业务架构边界(zqyy_app 永不建 RLS) + 跨连接器扩展性 D2 §10 跨模块覆盖矩阵更新: - §10.1 后端服务层:5 个 ? 项核实更新为 X 或 —,各项补 commit 引用 * task_generator / coach_service / customer_service / dispatcher / admin_service - §10.2 AI 提示词:app8_consolidate ? 标"F1-5b 范围外,Wave 2 / F1-6 audit" - §10.3 小程序页面:新增 coach-service-records 行(MP-5);board-* 系列 ? → —(后端走 board_service);customer-detail 备注补 MP-3 + MP-4 D3 §11 已知遗漏: - §11.1 设计共识:新增 zqyy_app 永不建 RLS(A4) + batch_id 命名规约(A5) - §11.2 已知 hack:补 F1-5b T3 间接覆盖说明 - 新增 §11.3 F1-5b 已收口的 11 项遗留 hack ✓ - 新增 §11.4 推迟到 F1-6 沙箱时光机阶段 B 的 4 项 ⏳ - 新增 §11.5 推迟到 F1-7+ 阶段 C 的 3 项 ⏳ D4 §15 变更记录 + §15.1 收益总结 + §12 任务清单: - §15 新增 4 行(F1-5a 走查 / F1-5b Wave A / Wave B / 沙箱时光机 spec) - 新增 §15.1 F1-5b 收益总结:7 大类已落地 + 业务价值 + 未落地指引 - §12 任务清单:T11/T12/T13 F1-5b 三批次摘要 + T18/T19 F1-6/F1-7+ 排期 - audit dashboard 自动刷新(scripts/audit/gen_audit_dashboard.py) 扫描 165 条审计记录(含本次 F1-5b 全部 commit) 无代码改动,纯文档同步。F1-6 启动可直接引用 sandbox-replay-engine-spec + P20 SPEC §11.4/§11.5 排期登记。 审计:docs/audit/changes/2026-05-05__wave1_f1_5b_d1234_spec_sync.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,91 @@
|
||||
# 2026-05-05 · F1-5b D1-D4 P20 SPEC 同步 + audit dashboard 刷新
|
||||
|
||||
> Wave 1 / F1-5b Wave B 第 8-11 项任务(详见 `docs/_overview/wave1-findings/F1-5b-tasks.md` §4.2 顺序 22-25)
|
||||
>
|
||||
> 工作量评估 4 × S/XS / 合计 ~ 2h(实际 ~ 30min,文档批量同步)
|
||||
|
||||
## 背景
|
||||
|
||||
F1-5b 大量代码改动落地后,需要同步 P20 SPEC 反映现状,防止文档与代码现状偏差。
|
||||
|
||||
D1-D4 任务范围:
|
||||
- **D1**:P20 SPEC §6 与 ETL 影子衔接(F1-5b 收益登记)
|
||||
- **D2**:P20 SPEC §10 跨模块覆盖矩阵(? 项核实更新为 X 或 —)
|
||||
- **D3**:P20 SPEC §11 已知遗漏(F1-5b 收口的 hack + 推迟到 F1-6/F1-7+ 的待办)
|
||||
- **D4**:P20 SPEC §15 变更记录 + audit dashboard 刷新
|
||||
|
||||
## 改动清单
|
||||
|
||||
### D1 — §6 与 ETL 影子衔接 + F1-5b 收益(`§6.1`)
|
||||
|
||||
[docs/prd/specs/P20-runtime-context-sandbox.md](docs/prd/specs/P20-runtime-context-sandbox.md):
|
||||
- §6 末尾新增 §6.1 "F1-5b 收益(2026-05-05 D1)"
|
||||
- 5 项收益:app 视图业务日上界裁剪范围 / 后端读取层 / 写入层 sandbox 隔离 / 业务架构边界澄清(zqyy_app 永不建 RLS) / 跨连接器扩展性
|
||||
|
||||
### D2 — §10 跨模块覆盖矩阵更新
|
||||
|
||||
[§10.1 后端服务层](docs/prd/specs/P20-runtime-context-sandbox.md):
|
||||
- `task_generator.py`: 业务日上界 ? → X(F1-5b T3 unit test 5/5 PASS 间接覆盖 dispatcher 传递 site_id)
|
||||
- `coach_service.py`: task_runtime_filter ? → —(MP-3 _build_coach_tasks 加业务日上界,commit 96dae0c)
|
||||
- `customer_service.py`: 加 X(MP-3 lastService 上界 + ref_date 提至模块顶部)
|
||||
- `ai/dispatcher.py`: 读 RuntimeContext ? → X(间接通过 context.site_id → run_log_svc,T3 测试覆盖)
|
||||
- `ai/admin_service.py`: 读 RuntimeContext ? → X(F1-5b A1 改造完成,4 处 CURRENT_DATE → business_date)
|
||||
- 全列各项均补 commit 引用,可追溯
|
||||
|
||||
[§10.2 AI 提示词](docs/prd/specs/P20-runtime-context-sandbox.md):
|
||||
- `app8_consolidate`: ? 标"F1-5b 范围外,Wave 2 / F1-6 audit"
|
||||
|
||||
[§10.3 小程序页面](docs/prd/specs/P20-runtime-context-sandbox.md):
|
||||
- `coach-service-records`: 新增行,标 X(F1-5b MP-5 onLoad + loadData + switchMonth 4 处 new Date() 替换)
|
||||
- `board-finance / board-customer / board-coach`: ? → —(后端走 board_service,前端无需 runtime-clock,F1-5b MP-1 复核 PASS;board-coach 推迟 F1-6)
|
||||
- `customer-detail`: 备注补 F1-5b MP-3 后端上界 + MP-4 id guard
|
||||
|
||||
### D3 — §11 已知遗漏
|
||||
|
||||
[docs/prd/specs/P20-runtime-context-sandbox.md](docs/prd/specs/P20-runtime-context-sandbox.md):
|
||||
- §11.1 设计共识保留:新增 2 项(zqyy_app 永不建 RLS / batch_id 命名规约)
|
||||
- §11.2 已知 hack:补 F1-5b T3 已覆盖间接调用的说明
|
||||
- **新增 §11.3 F1-5b 已收口的遗留 hack**:11 项 ✓ 标记 commit
|
||||
- **新增 §11.4 推迟到 F1-6 沙箱时光机阶段 B 的待办**:4 项 ⏳(MP-2 完整实施 / ETL Excel 上传 / 14 P1 / 5 P2)
|
||||
- **新增 §11.5 推迟到 F1-7+ 阶段 C 的远期目标**:3 项 ⏳(3 P3 / sandbox_audit_log / app8 audit)
|
||||
- §11.6 完整待办指向(原 §11.3 重排)
|
||||
|
||||
### D4 — §15 变更记录 + §15.1 F1-5b 收益总结 + audit dashboard
|
||||
|
||||
[§15 变更记录](docs/prd/specs/P20-runtime-context-sandbox.md):
|
||||
- 新增 4 行:F1-5a 走查 / F1-5b Wave A / F1-5b Wave B / 沙箱时光机模块 spec 产出
|
||||
- 新增 §15.1 F1-5b 收益总结:7 大类已落地能力 + 业务价值 + 未落地能力指引
|
||||
|
||||
[§12 任务清单](docs/prd/specs/P20-runtime-context-sandbox.md):
|
||||
- 原 T11(生产库迁移)→ T14(顺延)
|
||||
- 新增 T11/T12/T13:F1-5b 三大批次 commit 摘要
|
||||
- 新增 T18(F1-6 阶段 B)/ T19(F1-7+ 阶段 C)
|
||||
|
||||
[docs/audit/audit_dashboard.md](docs/audit/audit_dashboard.md):
|
||||
- 自动刷新(`scripts/audit/gen_audit_dashboard.py`)
|
||||
- 扫描 165 条审计记录(含本次 F1-5b 全部 commit)
|
||||
|
||||
## 影响范围
|
||||
|
||||
| 项 | 影响 | 验证 |
|
||||
|----|------|------|
|
||||
| 后端 / 前端 / DB | **无代码改动**,纯文档同步 | — |
|
||||
| 历史审计记录 | audit dashboard 自动重建索引,旧记录链接保持有效 | 165 条全扫描 PASS |
|
||||
| F1-6 启动依据 | sandbox-replay-engine-spec.md 已就位 + P20 SPEC §11.4/§11.5 排期登记 | F1-6 启动时直接引用 |
|
||||
|
||||
## 测试
|
||||
|
||||
无新增测试,纯文档改动。
|
||||
|
||||
## 风险与未覆盖
|
||||
|
||||
- **§13 已知冲突**(BD_Manual / Steps 弹窗等)未本次修订:跨度大,留 F1-6 / Wave 2 处理
|
||||
- **§14 成果层走查**清单未本次更新:F1-5b 多次 Playwright + weixin-devtools-mcp 走查已记入各项审计文档,后续若做"F1-5b 全套走查截图归档"再 patch §14
|
||||
|
||||
## 回滚策略
|
||||
|
||||
git revert 即可,无副作用。
|
||||
|
||||
## Co-Authored-By
|
||||
|
||||
Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
||||
Reference in New Issue
Block a user