Neo 4 件并行收口指示完成: P1 #1 — 3 项迁移后功能验证 全部 PASS: - 5 个 slash 命令文件全在(audit/db-docs/doc-sync/pre-change/spec-close) - 8 个 subagent 文件全在(本会话已成功调用 Explore 4 次实证) - 双测试库 SELECT 1 通过(test_etl_feiqiu + test_zqyy_app) - 详见 2026-05-06__closure_p1_1_migration_post_verification.md P1 #2 — 2026-04-15~05-02 累积基线 33 项对账(子代理深度对账): - 23 项已完成(70%)+ 5 项部分完成 + 5 项真正未收口 - 大部分被 W1/F1 sprint 体系接管(F1-5a/5b/F1-6/W1-T2/W1-T7) - 5 项真正未收口转登记 backlog §七 #9~#13(各自归到具体后续节点) - 详见 2026-05-06__closure_p1_2_cumulative_baseline_reconciliation.md docs/roadmap/ 目录合并入 backlog §七: - BACKLOG.md(2026-03-27 更新,60+ 项 P0-P2 待办)登记 #6 - 2026-02-24__fdw-dwd-to-core-migration-plan.md 登记 #7 - Neo 指示重要:roadmap 大多数任务"乍一看都适用",但很多逻辑细节 值得再深入调研 — 有些已不适用 / 有些冲突 / 有些被更好方式实现了 - 不批量标已完成或待办,需独立"BACKLOG.md 复核 sprint"逐项细化对账 Wave 0 全栈产品文档体系正式登记 §九: - 已完成 Wave 0(2026-05-04):01-product-overview.md(380 行) + 02a/02b 指纹矩阵 + admin-api-prd 151 端点 + 04-doc-conflicts 39 条 - 完整覆盖 WEB + 小程序 + 数据库 + 后端 + AI 应用矩阵 - 与 §八 文档规范化大工程关系:Wave 0 是骨架,§八 是后续精化重构 backlog §七 13 项洞口现状: - ✅ 已收口 5 项(#1 #2 #3 #5 #8) - ⏳ 待 Neo 评估 1 项(#4 etl-coupon-detail) - ⏳ 待独立 sprint 1 项(#6 BACKLOG.md 复核) - ⏳ 待对照 1 项(#7 fdw migration plan) - ⏳ 累积基线遗留 5 项(#9~#13 各归后续节点) dev 分支领先 origin/dev 9 commit(本会话累计)。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -48,6 +48,7 @@
|
||||
|------|------------|------|
|
||||
| 2026-05-06 | 创建本 backlog | F1-6 Sprint 2 #3 累计交易笔数调研发现 DWS 字段名与实算口径矛盾 + app7 直读 DWD 违规,Neo 决定将 DWD 孤立 + Core 中间件目标提上任务表 |
|
||||
| 2026-05-06 | 追加 §七 全局收口洞口清单 + §八 文档规范化整理大工程 | Neo 反思项目全局控制度,5 问追溯调研后立项 |
|
||||
| 2026-05-06 | §七 收口 #1 #2 完成 + 追加 #6~#13 + 新增 §九 全栈产品文档体系登记 | docs/roadmap/BACKLOG.md 60+ 项发现 + Wave 0 全栈文档体系实证 + 累积基线 33 项对账 |
|
||||
|
||||
---
|
||||
|
||||
@@ -61,11 +62,19 @@ Neo 发现"项目全局的控制度不够,有很多东西被漏了,到处都没
|
||||
|
||||
| # | 洞口 | 来源证据 | 状态 | 优先级 | 处理方式 |
|
||||
|---|------|---------|------|--------|---------|
|
||||
| 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 |
|
||||
| 1 | **3 项迁移后功能验证** | `docs/audit/changes/2026-05-02__claude_code_migration.md` L111-113 | ✅ 2026-05-06 已收口 | P1 | 实测 PASS:5 slash 命令文件 + 8 subagent 文件 + 双测试库 SELECT 1 全通过;详见 `2026-05-06__closure_p1_1_migration_post_verification.md` |
|
||||
| 2 | **2026-04-15 ~ 05-02 累积基线 33 项对账** | `docs/audit/changes/2026-05-04__cumulative_baseline_pending_verification.md` | ✅ 2026-05-06 已对账 | P1 | 子代理对账:23 完成(70%)+ 5 部分 + 5 真正未收口(转登记 #9~#13);详见 `2026-05-06__closure_p1_2_cumulative_baseline_reconciliation.md` |
|
||||
| 3 | **F1-6 Sprint 3 范围描述误导** | F1-6-tasks.md §4 把 MP-2 单项 ETL 依赖错误暗示成 Sprint 3 整体不可做 | ✅ 2026-05-06 已修订 | P0 | F1-6-tasks.md §4 已修订:Sprint 3a(5 个 P1 可独立做)+ Sprint 3b(MP-2 + #11 等 ETL) |
|
||||
| 4 | **etl-coupon-detail 30+ "待调研"标注** 4 个月未定 | `docs/specs/etl-coupon-detail/` | ⏳ 灰色 | P2 | 待 Neo 评估是否 Wave 1 解决 |
|
||||
| 5 | **Sprint 3 / 4 衔接判断错误** | Claude 在 Sprint 2 收尾时推荐"跳过 Sprint 3"是错误判断 | ✅ 2026-05-06 已纠正 | P0 | Sprint 2 收尾后正确顺序 = Sprint 3 (5/6 项可做) → Sprint 4 |
|
||||
| 6 | **`docs/roadmap/BACKLOG.md` 60+ 项 P0-P2 待办** | `docs/roadmap/BACKLOG.md`(2026-03-27 更新,258 行)| ⏳ **乍一看适用,但需细化对账** | P1 | **Neo 指示**:大多数任务"乍一看都适用",但很多逻辑细节值得再深入调研 — 有些已不适用 / 有些与现状冲突 / 有些被更好方式实现了。**不能简单"批量标已完成"或"批量标待办"**。需逐项做细化对账(可能与 Wave 1/F1 工作有大量交叠)。本身是一个独立的中等工作量任务(~ 2-3h),建议作为独立"BACKLOG.md 复核 sprint"启动 |
|
||||
| 7 | **`docs/roadmap/2026-02-24__fdw-dwd-to-core-migration-plan.md`** FDW 迁移方案 | `docs/roadmap/2026-02-24__fdw-dwd-to-core-migration-plan.md` | ⏳ 待对照 | P2 | 与 backlog §一 "DWD 孤立 + Core 中间件"目标完全一致,实际是同一目标的更早期 spec。需对照本 backlog §一确认是否仍代表当前方向,或已被本 backlog 取代 |
|
||||
| 8 | **Wave 0 全栈产品文档体系**(已完成,但需登记并纳入 §八文档规范化范围)| `docs/_overview/01-product-overview.md` 等 5 篇 | ✅ Wave 0 完成 | — | 详见 §九新增登记;文档规范化大工程(§八)是其下一阶段,即"对完整体系进一步精化和重构,零信息损失" |
|
||||
| 9 | (累积基线遗留)缓存分桶 + EventBus 生产观察 | 累积基线 3.1.3 | ⏳ 未收口 | P2 | F1-6 sprint 3 完成后补 audit |
|
||||
| 10 | (累积基线遗留)WebSocket 消费稳定性 | 累积基线 3.1.7 | ⏳ 未收口 | P2 | 上线灰度期(5-7 ~ 5-15)长期观察 |
|
||||
| 11 | (累积基线遗留)ETL 库完整 GUC 传递 26 视图 | 累积基线 3.5.5 | ⏳ 未收口 | P1 | 推迟 F1-5b Wave C(已规划)|
|
||||
| 12 | (累积基线遗留)finance_area_daily 会员分桶 vs DWS 规范 | 累积基线 3.7.2 | ⏳ 未收口 | P1 | 数据质量 Review,上线灰度期 |
|
||||
| 13 | (累积基线遗留)RLS 视图 pg_get_viewdef 全量重建 | 累积基线 3.7.3 | ⏳ 未收口 | P1 | 数据质量 Review + 视图清单专题 audit |
|
||||
|
||||
### 收口原则
|
||||
- 每项洞口完成后,出对应 audit 文档(`docs/audit/changes/2026-05-XX__closure_*.md`)
|
||||
@@ -122,3 +131,40 @@ Neo:"项目中的文档又多又零碎,分支理不清,只能逐一处理并全
|
||||
### 状态
|
||||
- ⏳ **立项**(2026-05-06 由 Neo 在反思时正式登记)
|
||||
- 详细 spec 待 Neo 调度时立(可能与 F1-6 阶段 B 收尾后启动)
|
||||
|
||||
---
|
||||
|
||||
## 九、Wave 0 全栈产品文档体系(已完成,登记并纳入 §八后续重构范围)
|
||||
|
||||
### 触发背景
|
||||
Neo 反思时问:"WEB 小程序 数据库 后端等项目全局的一个文档的任务,是否也规划了,
|
||||
还是已经完成了?"经子代理调研:**已完成 Wave 0(2026-05-04)**,但当时缺乏明确登记,
|
||||
本次正式登记并标注后续与 §八 文档规范化大工程的关系。
|
||||
|
||||
### Wave 0 完成清单
|
||||
|
||||
| 文档 | 完整度 | 内容 | 引用方 |
|
||||
|------|------|------|--------|
|
||||
| `docs/_overview/01-product-overview.md` | 95% | 380 行产品全景脑图,角色到 4 端映射,8 大章节 | F1-* sprint 引为标杆 |
|
||||
| `docs/_overview/02a-miniprogram-page-matrix.md` | 90% | 21 页小程序业务指纹矩阵(498 行)| W1-T1 / F1-5b MP-3/4/5 |
|
||||
| `docs/_overview/02b-adminweb-page-matrix.md` | 85% | 19 路由 admin-web 业务指纹矩阵(280 行)| F1-5b UI-1/2/3/4/5 |
|
||||
| `docs/_overview/admin-api-prd/00-overview.md` | 90% | 151 端点 API 全景(拆 5 批 PRD,W1-T7 批 1 完成)| W1-T7 P1-7 |
|
||||
| `docs/_overview/04-doc-conflicts.md` | 90% | 39 条文档冲突清单(已拍板)| W1 P0/P1/P2 反馈调研 |
|
||||
| `docs/_overview/00-index.md` | — | 主索引 + 维护协议 | 全 W1/F1 sprint |
|
||||
|
||||
### 完整覆盖范围
|
||||
- WEB 端(admin-web 19 路由 + tenant-admin)
|
||||
- 小程序端(21 页业务指纹)
|
||||
- 数据库端(`docs/_overview/01-product-overview.md §四 数据流` + `docs/database/` BD manual)
|
||||
- 后端端(`admin-api-prd 151 端点` + 后端架构)
|
||||
- AI 应用矩阵(8 个千问 APP 汇总)
|
||||
|
||||
### 当前状态
|
||||
- ✅ **已规划 + 已完成**(Wave 0,2026-05-04)
|
||||
- 🔄 **持续优化中**(W1/F1 sprint 推进时持续引用 + 增量更新)
|
||||
- ⏳ **待精细化**(§八 文档规范化大工程是其下一阶段,目标"对完整体系进一步规范化、去重、零信息损失重构")
|
||||
|
||||
### 与 §八 的关系
|
||||
Wave 0 文档体系是 §八 文档规范化大工程的**起点**(已有的全景索引体系),不是 §八 的目标产物。§八 的目标是把整个 docs/ 目录(11+ 子目录,200+ 篇 audit + N 篇 spec/PRD)按
|
||||
统一的"类型 + 作用"分类标准重构,Wave 0 已建立的全景索引体系是其规范的"骨架",
|
||||
具体规则、归档约定、信息精度防护待 §八 详细 spec 时立。
|
||||
|
||||
Reference in New Issue
Block a user