root/Neo-ZQYY
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(spec): F1-5b D1-D4 P20 SPEC 同步 + audit dashboard 刷新 (W1)

Browse Source 
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:
Neo
2026-05-05 22:21:24 +08:00
parent 1e803e23cd
commit 5d4da0ae8c
3 changed files with 242 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
docs/audit/audit_dashboard.md
View File

@@ -1,6 +1,6 @@
# 审计一览表
> 自动生成于 2026-05-05 05:36:54，请勿手动编辑。
> 自动生成于 2026-05-05 22:20:03，请勿手动编辑。
## 时间线视图
@@ -8,6 +8,18 @@
|------|------|----------|----------|----------|------|------|
| 2026-05-05 | 项目级 | 2026-05-05 — Wave 1 F1-5a 完整走查(应查尽查版) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_backend_walkthrough.md) |
| 2026-05-05 | 项目级 | Wave 1 F1-5a — 沙箱 batch-run 接入 runtime_context(MVP + 漂移防御核心) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_sandbox_batch_run.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b A6 ETL 连接显式 client_encoding=UTF8 防御 | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_a6_etl_conn_utf8.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b BE-1 task-list 403 根因定位 + 修复(B 方案) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_be1_task_list_403_root_cause.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b BE-3 ai_run_logs runtime 写入回归测试 | 功能 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_be3_run_log_runtime_regression.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b MP-1 board-finance 储值充值字段复核(false alarm) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp1_recharge_field_clarification.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b MP-2 准备工作 + 沙箱时光机模块 spec | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp2_prep.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b MP-3 customer-detail lastService 业务日上界裁剪 | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp3_lastservice_upper_bound.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b MP-4 coach-detail id 边界保护 | 功能 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp4_coach_detail_id_guard.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b MP-5 coach-service-records 接入业务时钟 | 清理 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp5_coach_service_records_clock.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b T3 dispatcher runtime 单测 | 功能 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_t3_dispatcher_runtime.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b UI-3 AIDashboard sandbox 提示 + today_calls 分组 | 文档 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_ui3_aidashboard_sandbox.md) |
| 2026-05-05 | 项目级 | 2026-05-05 · F1-5b UI-5 AITriggerJobs runtime 列 | 清理 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_ui5_aitriggerjobs_runtime.md) |
| 2026-05-05 | 项目级 | 2026-05-05 — Wave 1 F1-5b Wave A 中段(T1+A1+A2+A3+Hook) | 文档 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_wave_a_partial.md) |
| 2026-05-05 | 项目级 | Wave 1 F2-1B — OpenAPI 抓取 + Prompt 同步 防御机制 hook | 清理 | 其他 | 极低 | [链接](changes/2026-05-05__wave1_f2_1b_defense_hooks.md) |
| 2026-05-05 | 项目级 | Wave 1 F3-2C — System Prompt 独立 MD 目录建立 + 拆分 + 修正认知错误 | 文档 | 其他 | 极低 | [链接](changes/2026-05-05__wave1_f3_2c_system_prompts_split.md) |
| 2026-05-04 | 项目级 | 累积基线变更 + 待验证清单（2026-04-15 ~ 2026-05-02） | bugfix | 其他 | 未知 | [链接](changes/2026-05-04__cumulative_baseline_pending_verification.md) |
@@ -276,6 +288,18 @@
|------|----------|----------|----------|------|------|
| 2026-05-05 | 2026-05-05 — Wave 1 F1-5a 完整走查(应查尽查版) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_backend_walkthrough.md) |
| 2026-05-05 | Wave 1 F1-5a — 沙箱 batch-run 接入 runtime_context(MVP + 漂移防御核心) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_sandbox_batch_run.md) |
| 2026-05-05 | 2026-05-05 · F1-5b A6 ETL 连接显式 client_encoding=UTF8 防御 | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_a6_etl_conn_utf8.md) |
| 2026-05-05 | 2026-05-05 · F1-5b BE-1 task-list 403 根因定位 + 修复(B 方案) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_be1_task_list_403_root_cause.md) |
| 2026-05-05 | 2026-05-05 · F1-5b BE-3 ai_run_logs runtime 写入回归测试 | 功能 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_be3_run_log_runtime_regression.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-1 board-finance 储值充值字段复核(false alarm) | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp1_recharge_field_clarification.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-2 准备工作 + 沙箱时光机模块 spec | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp2_prep.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-3 customer-detail lastService 业务日上界裁剪 | bugfix | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp3_lastservice_upper_bound.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-4 coach-detail id 边界保护 | 功能 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp4_coach_detail_id_guard.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-5 coach-service-records 接入业务时钟 | 清理 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp5_coach_service_records_clock.md) |
| 2026-05-05 | 2026-05-05 · F1-5b T3 dispatcher runtime 单测 | 功能 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_t3_dispatcher_runtime.md) |
| 2026-05-05 | 2026-05-05 · F1-5b UI-3 AIDashboard sandbox 提示 + today_calls 分组 | 文档 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_ui3_aidashboard_sandbox.md) |
| 2026-05-05 | 2026-05-05 · F1-5b UI-5 AITriggerJobs runtime 列 | 清理 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_ui5_aitriggerjobs_runtime.md) |
| 2026-05-05 | 2026-05-05 — Wave 1 F1-5b Wave A 中段(T1+A1+A2+A3+Hook) | 文档 | 其他 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_wave_a_partial.md) |
| 2026-05-05 | Wave 1 F2-1B — OpenAPI 抓取 + Prompt 同步 防御机制 hook | 清理 | 其他 | 极低 | [链接](changes/2026-05-05__wave1_f2_1b_defense_hooks.md) |
| 2026-05-05 | Wave 1 F3-2C — System Prompt 独立 MD 目录建立 + 拆分 + 修正认知错误 | 文档 | 其他 | 极低 | [链接](changes/2026-05-05__wave1_f3_2c_system_prompts_split.md) |
| 2026-05-04 | 累积基线变更 + 待验证清单（2026-04-15 ~ 2026-05-02） | bugfix | 其他 | 未知 | [链接](changes/2026-05-04__cumulative_baseline_pending_verification.md) |
@@ -433,6 +457,18 @@
|------|----------|----------|------|------|
| 2026-05-05 | 2026-05-05 — Wave 1 F1-5a 完整走查(应查尽查版) | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_backend_walkthrough.md) |
| 2026-05-05 | Wave 1 F1-5a — 沙箱 batch-run 接入 runtime_context(MVP + 漂移防御核心) | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5a_sandbox_batch_run.md) |
| 2026-05-05 | 2026-05-05 · F1-5b A6 ETL 连接显式 client_encoding=UTF8 防御 | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_a6_etl_conn_utf8.md) |
| 2026-05-05 | 2026-05-05 · F1-5b BE-1 task-list 403 根因定位 + 修复(B 方案) | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_be1_task_list_403_root_cause.md) |
| 2026-05-05 | 2026-05-05 · F1-5b BE-3 ai_run_logs runtime 写入回归测试 | 功能 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_be3_run_log_runtime_regression.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-1 board-finance 储值充值字段复核(false alarm) | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp1_recharge_field_clarification.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-2 准备工作 + 沙箱时光机模块 spec | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp2_prep.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-3 customer-detail lastService 业务日上界裁剪 | bugfix | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp3_lastservice_upper_bound.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-4 coach-detail id 边界保护 | 功能 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp4_coach_detail_id_guard.md) |
| 2026-05-05 | 2026-05-05 · F1-5b MP-5 coach-service-records 接入业务时钟 | 清理 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_mp5_coach_service_records_clock.md) |
| 2026-05-05 | 2026-05-05 · F1-5b T3 dispatcher runtime 单测 | 功能 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_t3_dispatcher_runtime.md) |
| 2026-05-05 | 2026-05-05 · F1-5b UI-3 AIDashboard sandbox 提示 + today_calls 分组 | 文档 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_ui3_aidashboard_sandbox.md) |
| 2026-05-05 | 2026-05-05 · F1-5b UI-5 AITriggerJobs runtime 列 | 清理 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_ui5_aitriggerjobs_runtime.md) |
| 2026-05-05 | 2026-05-05 — Wave 1 F1-5b Wave A 中段(T1+A1+A2+A3+Hook) | 文档 | 未知 | [链接](changes/2026-05-05__wave1_f1_5b_wave_a_partial.md) |
| 2026-05-05 | Wave 1 F2-1B — OpenAPI 抓取 + Prompt 同步 防御机制 hook | 清理 | 极低 | [链接](changes/2026-05-05__wave1_f2_1b_defense_hooks.md) |
| 2026-05-05 | Wave 1 F3-2C — System Prompt 独立 MD 目录建立 + 拆分 + 修正认知错误 | 文档 | 极低 | [链接](changes/2026-05-05__wave1_f3_2c_system_prompts_split.md) |
| 2026-05-04 | 累积基线变更 + 待验证清单（2026-04-15 ~ 2026-05-02） | bugfix | 未知 | [链接](changes/2026-05-04__cumulative_baseline_pending_verification.md) |

91
docs/audit/changes/2026-05-05__wave1_f1_5b_d1234_spec_sync.md Normal file
View File

@@ -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>