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
This commit is contained in:
Neo
2026-05-04 07:38:28 +08:00
parent c6453829a6
commit 509cf43284
44 changed files with 10789 additions and 0 deletions

View File

@@ -0,0 +1,87 @@
# 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`)
1. 先读 `01` 找业务定位
2.`02a``02b` 找具体页面字段定义
3.`04` 看相关字段是否有冲突
4. 如冲突未拍板,**先问 Neo**,不擅自下结论
### 场景 2 — 测试 / 验证(Wave 1-5)
1.`03` 选取该 Wave 的 L1-L5 范围
2. 对每个 case 用 `02a/02b` 必现字段做判据
3. 失败时按 `03 §六` 5 步排查,排除文档过期 / 角色 / 门店 / 数据缺 / 沙箱后再标 D
4. 产出报告:`docs/audit/changes/2026-05-04__verify_wave_<N>_<slug>.md`
### 场景 3 — 新人 onboarding
1.`01` 建立产品认知(20 min)
2.`02a``02b` 找自己负责的端(30 min)
3.`04` 了解已知坑(10 min)
4. 配合 `CLAUDE.md` 各子模块(自动加载)
### 场景 4 — 文档维护
- 任何 PRD / SPEC 更新 → 同步检查本目录 `01-04` 是否需要更新
- 任何代码改动后 → 检查是否产生新冲突,登记到 `04`
- 任何 Wave 验证发现新 D Bug → 登记到 `04`
## 维护协议
### 历史性过期判定
任何调研 / 验证中遇到「文档说 X,现状是 Y」:
1. 先查 `git log` / `docs/audit/changes/` 看是否有更晚 session 修改了实现
2. 若**确认是文档过期**:在 `04` 登记后,以现状为准
3. 若**不确定**:**不要擅自下结论**,提出来让 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 三子代理产出 + 主线整合 |