fmode-app/docs

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	生效	🔴 综合日志,按动作逐条追加(⚠️ 12:43–13:46 段曾误删,已重建,见文首说明)

01-requirements/ 需求文档

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

02-design/ 设计文档

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

ADR 清单

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

03-interface/ 接口文档

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

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 契约的逆向来源)