Files

Neo 509cf43284 chore(docs): Wave 0 调研产出 + P0/P1/P2 反馈调研

建立项目级标杆文档 docs/_overview/ 作为产品全景索引,
解决"PRD 零碎、文档膨胀、跨子系统调研无入口"的问题。

主要内容:
- 00-index 总索引 + 维护协议 + 与 CLAUDE.md 关系
- 01-product-overview 产品全景脑图(6 角色 / 6 子系统 / 数据流 /
  7 业务概念 / 8+1 AI 矩阵 / 22 术语)
- 02a-miniprogram-page-matrix 小程序 21 页业务指纹
- 02b-adminweb-page-matrix admin-web 19 路由业务指纹
- 03-test-spec 测试规范 (L1-L5 分层 + 走查模板 + 75-95 case 估算)
- 04-doc-conflicts 39 条冲突索引(P0×8 / P1×13 / P2×13 + 5 子项)
- 04a/b/c-conflicts-*-detail 业务故事卡(7 字段:关联/逻辑/影响/选项/判定)
- 05-orphan-pages-cleanup admin-web 6 孤儿页面处置(1 归档 + 4 保留)
- WAVES-MASTER-PLAN.md 全 Wave 主计划(0-5,共 22-32 工作日)
- WAVE-1-KICKOFF.md Wave 1 实施 kickoff
- GLOBAL-DECISION-DASHBOARD.md 全局决策仪表板

反馈调研产物:
- 04a-feedback/ P0 两轮反馈(8+8 项决策 + D-1/2/3 + F-1/2 子代理产出)
- 04b-feedback/ P1 两轮反馈(13+1+5 项 + E-1/2/3/4 + G-1/2 子代理产出)
- 04c-feedback/ P2 反馈(13 项 + 5 子项 + H-1/2/3 子代理产出)
- NEO-DECISIONS-LOG 累积决策记录

关键追加发现 8 处 D Bug(原蓝本 0):
- P0-3 看板沙箱接入(Wave 1 W1-T1)
- P0-5 致命 1 (4 处 fdw_etl 残留, 已修 commit 17f045a)
- P0-5 致命 2 (JWT aud 缺失, 已修 commit 17f045a)
- P0-6 clearAllTasks 守卫 (Wave 3)
- P0-8 DBViewer 黑名单漏 (已修 commit 17f045a)
- P1-3 task-detail 跳转传 task_id 而非 customer_id
- P2-7 board-finance 隐式 null
- 2 个独立 Bug (page_context.created_at + ClueCategory 字典)

参考: docs/_overview/00-index.md

2026-05-04 07:38:28 +08:00

4.1 KiB

Raw Blame History

NeoZQYY 产品全景索引

维护协议:产品全景文档 / 单独存放 / 标杆级 / 历史性过期文档冲突优先 Neo 确认

适用范围:Wave 1-5 验证、新人 onboarding、跨子系统调研、变更影响评估

文件索引

文件	内容	维护方	行数
`00-index.md`	本索引	主线	-
`01-product-overview.md`	产品全景脑图(角色 / 子系统 / 数据流 / 业务概念 / AI 矩阵)	Wave 0-A	380
`02a-miniprogram-page-matrix.md`	小程序 21 页业务指纹矩阵	Wave 0-B	498
`02b-adminweb-page-matrix.md`	admin-web 19 路由业务指纹矩阵	Wave 0-C	280
`03-test-spec.md`	测试规范(L1-L5 分层 + 判据 + 走查模板)	主线	-
`04-doc-conflicts.md`	39 条冲突索引(指向详细业务卡)	主线	-
`04a-conflicts-P0-detail.md`	P0 8 条业务故事卡(关联/逻辑/影响/选项/判定)	Wave 0-D-P0	324
`04b-conflicts-P1-detail.md`	P1 13 条业务故事卡	Wave 0-D-P1	380
`04c-conflicts-P2-detail.md`	P2 13 条紧凑业务卡	Wave 0-D-P2	344
`05-orphan-pages-cleanup.md`	6 个 admin-web 页面处置建议	Wave 0-C	200

使用场景

场景 1 — 编码前调研(`/pre-change`)

先读 01 找业务定位
读 02a 或 02b 找具体页面字段定义
查 04 看相关字段是否有冲突
如冲突未拍板,先问 Neo,不擅自下结论

场景 2 — 测试 / 验证(Wave 1-5)

读 03 选取该 Wave 的 L1-L5 范围
对每个 case 用 02a/02b 必现字段做判据
失败时按 03 §六 5 步排查,排除文档过期 / 角色 / 门店 / 数据缺 / 沙箱后再标 D
产出报告:docs/audit/changes/2026-05-04__verify_wave_<N>_<slug>.md

场景 3 — 新人 onboarding

读 01 建立产品认知(20 min)
读 02a 或 02b 找自己负责的端(30 min)
读 04 了解已知坑(10 min)
配合 CLAUDE.md 各子模块(自动加载)

场景 4 — 文档维护

任何 PRD / SPEC 更新 → 同步检查本目录 01-04 是否需要更新
任何代码改动后 → 检查是否产生新冲突,登记到 04
任何 Wave 验证发现新 D Bug → 登记到 04

维护协议

历史性过期判定

任何调研 / 验证中遇到「文档说 X,现状是 Y」:

先查 git log / docs/audit/changes/ 看是否有更晚 session 修改了实现
若确认是文档过期:在 04 登记后,以现状为准
若不确定:不要擅自下结论,提出来让 Neo 确认,产出标 待 Neo 确认

标杆级别

本目录下的 4 份核心文档(01/02a/02b/04)是项目级标杆,优先级:

代码现状 > 本目录文档 > docs/prd/* > docs/miniprogram-dev/* > 其他散落文档

零散文档归档建议(待 Neo 确认)

Wave 0 调研中识别到以下文档与本目录有重叠或可归档,等 Neo 拍板:

docs/miniprogram-dev/api-audit/*.md 21 份 → 已被 02a 整合,建议保留(细粒度仍有用)但加 _index.md 指向 02a 作主索引
docs/prd/Neo_Specs/review-audit/*.md 100+ 份 → 历史 SPEC 审阅条目,建议归档到 _archived/Neo_Specs/review-audit/(如果 Neo 觉得太散)
docs/prd/PRD审阅-Q&A.md PRD审阅-Q&A-R2.md → 早期 PRD 审阅,内容多已落地,建议保留作历史参考

本次不动这些文件,仅在本索引登记建议。

与现有 CLAUDE.md 的关系

CLAUDE.md	内容	与本目录关系
根 `CLAUDE.md`	项目结构 + 子系统索引	互补
`apps/backend/CLAUDE.md`	FastAPI 全局响应包装 / JWT / AI 集成	互补,被 `02b` 引用
`apps/etl/connectors/feiqiu/CLAUDE.md`	飞球数据规范(12 条 DWD 强制规则 + DWS 权威)	互补,被 `01 §五.5` `03 §三 L5` 引用
`db/CLAUDE.md`	DDL / 迁移 / RLS 双 schema 模板	互补,被 `01 §四数据流` `03 §三 L5` 引用

CLAUDE.md 是子模块自动加载的运行时约束,本目录是全局调研索引,职责不重叠。

变更日志

日期	事件	备注
2026-05-04	Wave 0 初始建立	A/B/C 三子代理产出 + 主线整合

4.1 KiB Raw Blame History