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>

docs/_overview/architecture-evolution-backlog.md

@@ -47,3 +47,78 @@
 | 日期 | 决策 / 变更 | 触发 |
 |------|------------|------|
 | 2026-05-06 | 创建本 backlog | F1-6 Sprint 2 #3 累计交易笔数调研发现 DWS 字段名与实算口径矛盾 + app7 直读 DWD 违规,Neo 决定将 DWD 孤立 + Core 中间件目标提上任务表 |
+| 2026-05-06 | 追加 §七 全局收口洞口清单 + §八 文档规范化整理大工程 | Neo 反思项目全局控制度,5 问追溯调研后立项 |
+
+---
+
+## 七、全局收口洞口清单(2026-05-06 反思,逐项收口)
+
+### 触发背景
+Neo 发现"项目全局的控制度不够,有很多东西被漏了,到处都没有收口"。
+经 5 问追溯调研(子代理 + Bash 实证),发现以下 5 个未收口洞口。
+
+### 收口清单
+
+| # | 洞口 | 来源证据 | 状态 | 优先级 | 处理方式 |
+|---|------|---------|------|--------|---------|
+| 1 | **3 项迁移后功能验证未做** | `docs/audit/changes/2026-05-02__claude_code_migration.md` L111-113 标"待用户后续验证" | ⏳ 待验 | P1 | (a) IDE 中输入 `/audit` 等 5 个 slash 命令是否能加载;(b) 8 个 subagent 通过 `Agent` 工具调用是否正常;(c) MCP 测试库 `pg-etl-test` / `pg-app-test` `SELECT 1` 通过 — 各自 ~ 2 分钟,出补做 audit |
+| 2 | **2026-04-15 ~ 05-02 累积基线 17 天工作待验证** | `docs/audit/changes/2026-05-04__cumulative_baseline_pending_verification.md` 文件名即"待验证",commit `caf179a` 把 17 天工作打包成 1 个 commit | ⏳ 待验 | P1 | 读该 audit 文档列举的待验证项,逐项验证或推迟到具体 wave 验证(F1-5a/F1-5b 走查实际已部分覆盖,需对账)|
+| 3 | **F1-6 Sprint 3 范围描述误导** | F1-6-tasks.md §4 把 MP-2 单项 ETL 依赖错误暗示成 Sprint 3 整体不可做,导致 Claude 推荐"跳过 Sprint 3 直推 Sprint 4" | ⏳ 待修订 | P0 | 修订 F1-6-tasks.md §4,明确 5 个 P1 指标(#6~#10)可独立做,仅 MP-2 依赖 ETL 配合 |
+| 4 | **etl-coupon-detail 30+ "待调研"标注** 4 个月未定 | `docs/specs/etl-coupon-detail/` design.md + requirements.md(package_services / coupon_details_list 等) | ⏳ 灰色 | P2 | 由 Neo 评估是否在 Wave 1 解决;若是登记到 W1 任务清单,若否明确推迟到指定阶段 |
+| 5 | **Sprint 3 / 4 衔接判断错误** | Claude 在 Sprint 2 收尾时推荐"跳过 Sprint 3"是错误判断 | 已识别 | P0 | 本次反思已纠正,Sprint 2 收尾后正确顺序 = Sprint 3 (5/6 项可做) → Sprint 4 |
+
+### 收口原则
+- 每项洞口完成后,出对应 audit 文档(`docs/audit/changes/2026-05-XX__closure_*.md`)
+- 完成后标 ✅ 并补 commit 引用
+- 不再让"待验证 / 待调研"在文档中无限期挂着
+
+---
+
+## 八、文档规范化整理(大工程,长期立项)
+
+### 触发背景
+Neo:"项目中的文档又多又零碎,分支理不清,只能逐一处理并全部文档按类型和作用
+重构合并去重等。但我不想损失任何的信息精度。这是一个很重很大的工程。"
+
+调研背景(子代理 2 实证 2026-05-06):**没有找到明确的"2026-01-01 至今文档整理"
+任务记录**,只有零散的局部整理痕迹(2026-02-13 BD manual 整理 / 2026-02-15 docs/database
+合并 / 2026-04-06 v1 整理 1155 文件)。本立项即明确该任务正式登记。
+
+### 工程目标(Neo 定义)
+
+1. **规范化**:项目内所有文档按类型和作用归类
+2. **归档**:过期内容统一归档(不删除)
+3. **对账**:不符合项目实时状态的文档,逐一对比分析原因
+4. **去重 + 合并**:多文档同主题/重叠内容,合并去重
+5. **重构**:目录结构按"类型 + 作用"重新组织
+6. **零信息损失** (关键约束):**不损失任何精度**,即使整理过程也保留原文留底
+
+### 范围估算(初步,详细 spec 待立)
+
+- `docs/_overview/`(产品全景索引)
+- `docs/audit/`(审计记录,200+ 篇 audit 文档)
+- `docs/prd/`(PRD + 决策卡 + 反馈)
+- `docs/database/`(BD manual + DDL)
+- `docs/specs/`(spec 文档,含 etl-coupon-detail 等)
+- `docs/ai/`(AI prompt 体系)
+- `docs/contracts/`(OpenAPI 契约)
+- `docs/guides/`(开发指南)
+- `docs/miniprogram-dev/`(小程序开发)
+- `docs/architecture/`(架构总览)
+- `docs/ai-env-history/`(迁移历史)
+- 各模块内 `docs/`(模块本地文档)
+
+### 工程量初判
+- 大概率 **L+ 工作量**(数十小时,需要分多个 sprint)
+- 必须有明确 spec 设计(类型分类标准 / 归档约定 / 去重原则 / 信息损失防护)
+- 不在 F1-6 阶段 B 做,作为独立任务在 F1-6 完成后或并行启动
+
+### 执行原则
+- 先 spec 后施工(不做无规划重构)
+- 每次提交 1 个目录或 1 个主题,不批量乱动
+- 整理前留下 git 备份点(全文档 tar 归档 _DEL/ )
+- 整理后做信息精度核对(diff 比对关键内容)
+
+### 状态
+- ⏳ **立项**(2026-05-06 由 Neo 在反思时正式登记)
+- 详细 spec 待 Neo 调度时立(可能与 F1-6 阶段 B 收尾后启动)

docs/_overview/wave1-findings/F1-6-tasks.md

@@ -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 独立推进)
 
 ---