# fmode-app-v2 文档导航索引

| 字段 | 值 |
|---|---|
| 版本 | v2.0 |
| 最后更新日期 | 2026-10-14 |
| 状态 | 生效 |
| 本次变更原因 | 阶段①→② 已切换;补齐 API 契约、数据访问层设计、组件规范、实施计划、ADR-006 等新产出物的索引 |

> 规则依据:rules/11 文档体系。**新增/修改文档必须同步更新本索引**(必须规则 7)。

---

## 当前阶段

**阶段② 设计建模 + 设计系统**(规范包阶段视图 2/4,加载 7 个模块)

| 门禁 | 条件 | 状态 |
|---|---|---|
| G1~G3 | SPEC 草案 / 用户确认 FR·AC / 画像·RACI·流程图 | ✅ |
| G4 | ER 图落位 | 🟡 草案(❓ 待核,**不阻塞**) |
| G5 | 评审员子代理评审 | ✅ **通过**(5 轮收敛) |
| G6 | 阶段①→② 切换 | ✅ |
| **G-D1** | **关键页面原型经用户确认** | 🟡 **原型已敲定,待 UI 细节目视确认** |
| 设计建模 | 数据范式 + API 契约评审通过 | 🟡 API 契约已产出,待评审 |

**下一步**:设计规范与原型目视确认(G-D1)→ 阶段③ 编码(按《2026-10-14-v2实施计划.md》滚动交付)。

---

## 目录导航

### 00-tracking/ 全程追踪(黄金规则 10)
| 文档 | 状态 | 说明 |
|---|---|---|
| [操作追踪.md](00-tracking/操作追踪.md) | 生效 | 🔴 综合日志,按动作逐条追加(⚠️ 12:43–13:46 段曾误删,已重建,见文首说明) |

### 01-requirements/ 需求文档
| 文档 | 状态 | 说明 |
|---|---|---|
| [prd/SPEC-20261014-fmode-app-v2-草案.md](01-requirements/prd/SPEC-20261014-fmode-app-v2-草案.md) | 已过 5 轮评审 | **21 条 FR** + 13 条 NFR;含 5 条裁决派生需求 |
| [prd/PRD-20261014-fmode-app-v2.md](01-requirements/prd/PRD-20261014-fmode-app-v2.md) | 生效 | 产品需求文档 |
| [personas/用户画像.md](01-requirements/personas/用户画像.md) | 生效 | 三类画像 × 9 个模块的矩阵 |
| [raci/RACI.md](01-requirements/raci/RACI.md) | 生效 | 权责矩阵 + 跨角色协作接口 |
| [交接文档-阶段1至2.md](01-requirements/交接文档-阶段1至2.md) | 生效 | 阶段①交付清单、门禁状态、阶段②约束 C1–C8、遗留 L1–L8 |
| [stories/访谈-20261014-现状调研汇总.md](01-requirements/stories/访谈-20261014-现状调研汇总.md) | 生效 | 4 份存量调研报告汇总 |
| [stories/访谈-20261014-第二轮裁决记录.md](01-requirements/stories/访谈-20261014-第二轮裁决记录.md) | 生效 | 裁决 ×5:任务看板纳入 / 通话暂缓 / 安全不处理 / 替换上线 / 三类画像 + 范围冻结 |
| [stories/访谈-20261014-第三轮裁决记录.md](01-requirements/stories/访谈-20261014-第三轮裁决记录.md) | 生效 | 裁决 11(先看原型)/ 裁决 12(视觉方向) |
| [stories/访谈问卷-20261014-v2需求挖掘.md](01-requirements/stories/访谈问卷-20261014-v2需求挖掘.md) | 全部完结 | — |

### 02-design/ 设计文档
| 文档 | 状态 | 说明 |
|---|---|---|
| [plans/2026-10-14-v2实施计划.md](02-design/plans/2026-10-14-v2实施计划.md) | 🔴 **生效(编码基线)** | 阶段②收尾 → 阶段③ 四层推进 + 10 个滚动里程碑 + 验证体系 |
| [plans/2026-10-14-v2重建方案.md](02-design/plans/2026-10-14-v2重建方案.md) | 生效 | 重建总方案(三支柱 + 路线图 + 风险) |
| [plans/调研-20261014-多任务并行可行性.md](02-design/plans/调研-20261014-多任务并行可行性.md) | 生效 | 多任务接入调研:Agent 侧具备,仅缺云函数接收端 |
| [design-system/设计令牌.md](02-design/design-system/设计令牌.md) | **v2.0 定稿** | 令牌名 = ui-kit,取值 = 敲定原型;8 档字号 / 4 档圆角的 name→value 对照表 |
| [design-system/双端布局规范.md](02-design/design-system/双端布局规范.md) | **v2.0 定稿** | 断点阶梯(实测)/ 四栏尺寸(实测)/ 触达区 / 安全区 / 居中基准 |
| [design-system/组件规范.md](02-design/design-system/组件规范.md) | **v1.0 定稿** | 11+11 页 × 底座组件拼装清单;目录边界规则;14 项必须自建组件 |
| [design-system/ui-kit底座盘点.md](02-design/design-system/ui-kit底座盘点.md) | 生效 | 桌面 75 + 移动 70 组件;令牌;6 条已知限制 |
| [design-system/同类产品参考调研.md](02-design/design-system/同类产品参考调研.md) | 生效 | 429 行;断点 1150 实测结论来源 |
| [architecture/数据访问层设计.md](02-design/architecture/数据访问层设计.md) | 🔴 **生效(编码基线)** | `FmodeApi` 抽象层 + `ParseApi`/`MockApi` 开关;领域模型唯一类型定义;轮询 4→1 收敛 |
| [architecture/业务流程图.md](02-design/architecture/业务流程图.md) | 生效 | 5 张 mermaid 图 |
| [database/ER-图-草案.md](02-design/database/ER-图-草案.md) | 🟡 草案·待核对 | mermaid ER 图,❓ 标记未证实字段 |
| decisions/ADR-001~006 | ✅ 6 份 | 见下表 |

#### ADR 清单
| 编号 | 标题 |
|---|---|
| [ADR-001](02-design/decisions/ADR-001-工程底座选型.md) | 工程底座选型(Angular 20.3 + Tailwind 3.4 + ui-kit 整目录) |
| [ADR-002](02-design/decisions/ADR-002-设计令牌唯一真源.md) | 设计令牌唯一真源 |
| [ADR-003](02-design/decisions/ADR-003-单一事实源.md) | 单一事实源 |
| [ADR-004](02-design/decisions/ADR-004-双端双套路由树.md) | 双端双套路由树,不做响应式换布局 |
| [ADR-005](02-design/decisions/ADR-005-语义色收敛单轨.md) | 语义色收敛单轨 |
| [ADR-006](02-design/decisions/ADR-006-视觉基线对齐原型.md) | **视觉基线以敲定原型为准,令牌采用 ui-kit 词汇表承载原型取值** |

### 03-interface/ 接口文档
| 文档 | 状态 | 说明 |
|---|---|---|
| [api/API-契约.md](03-interface/api/API-契约.md) | 🔴 **生效(编码基线)** | 5 个云函数 + 7 个 REST 端点 + Parse 数据表 + ACL 口径 + 8 项待服务端核对 |
| [待问Agent-20261014-多任务接入核实.md](03-interface/待问Agent-20261014-多任务接入核实.md) | **待转发** | 6 组 16 问,直接复制发给容器 Agent |

### 04-quality/ 质量保障
| 文档 | 状态 | 说明 |
|---|---|---|
| [traceability-matrix.md](04-quality/traceability-matrix.md) | 骨架 | 🔴 四向追溯矩阵(编码阶段逐行填充) |
| review/2026-10-14-SPEC-ER评审-第1轮.md | 已归档 | 不通过(严重 7 / 一般 11 / 提示 7) |
| review/2026-10-14-SPEC-ER评审-第2轮.md | 已归档 | 不通过(严重 4 / 一般 5 / 提示 2) |
| review/2026-10-14-SPEC-ER评审-第3轮.md | 已归档 | 不通过(仅 2 项残留) |
| review/2026-10-14-SPEC-ER评审-第4-5轮.md | 已归档 | ✅ **通过 —— G5 门禁** |
| review/ | — | 设计规范评审报告(本次)待归档 |

### 其它目录
| 目录 | 状态 | 说明 |
|---|---|---|
| 05-operations/ | 待产出 | 部署 / 监控 |
| 06-standards/ | 待产出 | 技术栈 / 踩坑记录 |
| 07-records/ | 待产出 | 修改留痕(YYYY-MM-DD-功能名) |

---

## 🔴 必备文档状态(rules/11)

| 必备项 | 状态 |
|---|---|
| `docs/README.md` | ✅ 本文件 |
| `docs/00-tracking/操作追踪.md` | ✅ |
| `docs/01-requirements/prd/PRD-*.md` | ✅ |
| `docs/02-design/decisions/ADR-*.md` | ✅ 6 份 |
| `docs/03-interface/api/` | ✅ |
| `docs/04-quality/traceability-matrix.md` | 🟡 骨架(编码阶段填充) |
| `docs/07-records/` | ⬜ 待产出 |

---

## 存量项目参考(只读,不修改)

旧项目 `E:\work\fmode-app` 保留原地作为迁移参考:
- `docs/04-quality/2026-10-13-UI规范符合性审计.md` — UI 量化审计
- `docs/03-interface/` — Hermes 上报链路与云函数调研
- `docs/02-design/database/ER-图.md` — 旧 ER 图
- `docs/00-tracking/` — 旧操作追踪
- `src/app/core/` — 服务层与云函数调用点(API 契约的逆向来源)