# 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 三子代理产出 + 主线整合 |
