docs(audit): 全局收口反思 — 5 问追溯 + 洞口登记 + 文档规范化大工程立项

Neo 在 F1-6 Sprint 2 收尾后反思"项目全局控制度不够,到处没收口"。
经 5 问追溯调研(2 个子代理 + Bash 实证),识别 5 个未收口洞口 + 1 个
未明确登记的大工程,本次完成"登记 + 修订",实际收口动作待逐项推进。

5 个未收口洞口(已登记 backlog §七):
- P0 #3 F1-6 Sprint 3 范围描述误导(本次已修订 F1-6-tasks.md §4 拆分 3a/3b)
- P0 #5 Sprint 3/4 衔接判断错误(本次已纠正)
- P1 #1 3 项迁移后功能验证未做(IDE slash / 8 subagent / MCP 测试库)
- P1 #2 2026-04-15~05-02 累积基线 17 天工作待验证
- P2 #4 etl-coupon-detail 30+ 待调研 4 个月未定

文档规范化大工程立项(已登记 backlog §八):
- Neo 明确目标:规范化 / 归档 / 对账 / 去重 / 重构 / 零信息损失
- 范围 11 个 docs/ 子目录 + 各模块本地 docs
- 工程量 L+(数十小时,需多 sprint)
- 状态:立项,详细 spec 待 Neo 调度时立

落地修订:
- docs/_overview/architecture-evolution-backlog.md 追加 §七 §八
- docs/_overview/wave1-findings/F1-6-tasks.md §4 Sprint 3 拆分 3a/3b
- docs/audit/changes/2026-05-06__global_closure_reflection.md 反思全文

承认:Claude 在跨 sprint 衔接判断上有盲区,本次反思已纠正,未来 sprint 转换
前必须读完整 §4 范围描述,不靠记忆推断。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Neo
2026-05-06 01:58:18 +08:00
parent 3164c23168
commit e60cfc037c
4 changed files with 245 additions and 12 deletions

View File

@@ -104,19 +104,36 @@
## 四、Sprint 3 范围(待启动)
### 5 个助教/门店相关 P1 + MP-2 完整
> ⚠️ 2026-05-06 修订(全局收口反思后):原描述"需 ETL 团队配合"误导 Claude
> 推荐"跳过 Sprint 3 直推 Sprint 4"。**实际上 5 个 P1 指标(#6~#10)完全可独立做,
> 沿用 Sprint 1/2 模式;仅 MP-2 单项需 ETL 配合**,可拆分推进。详见架构演进
> backlog §七 第 3 项。
| # | 指标 | 备注 |
|---|------|------|
| 6 | 累计服务客户数(助教) | dws_assistant_customer_stats daily |
| 7 | 助教等级 | dws_assistant_daily_detail.assistant_level_code |
| 8 | 月度课时(助教) | dws_assistant_daily_detail.base_hours 聚合 |
| 9 | 月度计费金额(助教) | dws_assistant_daily_detail.total_ledger_amount 聚合 |
| 10 | 月度新增/流失会员 | dws_member_*_summary daily |
| **MP-2 完整 daily salary** | board-coach 月度面板 | **需 ETL 团队配合**:新建 dws_assistant_daily_salary 表 + ETL Excel 上传 UI 改造 |
### 5 个助教/门店相关 P1 指标(可立刻做,不依赖 ETL)+ MP-2 完整(独立子任务,需 ETL 配合)
### Sprint 3 估算
5 指标 ~ 3-4h + MP-2 完整 5-6h(含 ETL 改造) = **L ~ 8-10h**
| # | 指标 | 数据源 | 是否需 ETL 配合 |
|---|------|--------|---------------|
| 6 | 累计服务客户数(助教) | `dws_assistant_customer_stats` daily | **不需要**(走 Sprint 1/2 同款模式)|
| 7 | 助教等级 | `dws_assistant_daily_detail.assistant_level_code` | **不需要** |
| 8 | 月度课时(助教) | `dws_assistant_daily_detail.base_hours` 聚合 | **不需要** |
| 9 | 月度计费金额(助教) | `dws_assistant_daily_detail.total_ledger_amount` 聚合 | **不需要** |
| 10 | 月度新增/流失会员 | `dws_member_*_summary` daily | **不需要** |
| 11 | (Sprint 2 推迟项) 累计交易笔数 | 需 ETL 新增 `total_open_table_count` | **需要** |
| **MP-2 完整 daily salary** | 新建 `dws_assistant_daily_salary` 表 + Excel 上传 UI 改造 | **需要** |
### Sprint 3 拆分实施
**子 Sprint 3a(可立刻启动)**:5 个 P1 指标 #6~#10
- 沿用 Sprint 1/2 §3 五步流程
- 估算 ~ 3-4h
- 不依赖 ETL 团队
**子 Sprint 3b(等 ETL 配合)**:#11(累计交易笔数)+ MP-2 完整
- 需要先与 ETL 团队对齐:新建 `dws_assistant_daily_salary` + 新增 `total_open_table_count` + Excel 上传 UI 改造
- 估算 ~ 5-6h(含 ETL 改造)
### Sprint 3 总估算
5 P1 指标 ~ 3-4h + #11/MP-2 完整 5-6h = **L ~ 8-10h**(可拆 3a + 3b 独立推进)
---