traceability-matrix.md 6.5 KB
四向追溯矩阵
| 字段 | 值 |
|---|---|
| 版本 | v0.4(阶段② 设计文档列填充) |
| 最后更新日期 | 2026-10-14 |
| 状态 | 骨架 · 「测试用例」列随编码逐行填充 |
| 本次变更原因 | 阶段② 设计规范四件套 + API 契约 + 数据访问层设计产出后,填充「设计文档」与「数据/接口」两列 |
规则依据:rules/02 开发流程与文档同步(四向追溯矩阵)。🔴 必备文档。 四向:需求(FR) ←→ 用户画像 ←→ 设计文档 ←→ 测试用例。 任何 FR 若在此矩阵中缺任一向,视为未完成。 本文件是矩阵唯一事实源(SPEC §四 只留导航指针,不维护副本)。
设计文档代号:
| 代号 | 文档 |
|---|---|
令牌 |
docs/02-design/design-system/设计令牌.md v2.0 |
布局 |
docs/02-design/design-system/双端布局规范.md v2.0 |
组件 |
docs/02-design/design-system/组件规范.md v1.0 |
数据层 |
docs/02-design/architecture/数据访问层设计.md |
API |
docs/03-interface/api/API-契约.md |
ADR-006 |
docs/02-design/decisions/ADR-006-视觉基线对齐原型.md |
主矩阵
| FR 编号 | 需求名 | 用户画像 | 验收标准 | 设计文档 | 数据/接口 | 测试用例 | 状态 |
|---|---|---|---|---|---|---|---|
| FR-01 | 端分流与导航 | 全部 | AC-01.1~4 | 数据层§五 DeviceService · 组件§2.1/§3.1 |
数据层§四.1 |
待定 | 设计就绪 |
| FR-02 | 登录与鉴权 | 全部 | AC-02.1~7 | 数据层§五 SessionService · 组件§2.2 login |
API§2.4 / §3(R1,R4,R5) |
待定 | 设计就绪 |
| FR-03 | 通讯录 | P1 / P2 | AC-03.1~4 | 组件§2.2 contacts / §3.2 contacts · 数据层§四.1 |
API§2.1 |
待定 | 设计就绪 |
| FR-04 | 会话(IM 中枢) | P1 | AC-04.1~11 | 组件§四-1/2/3(气泡/composer/文件卡)· 布局§2.3 |
API§2.3/§2.5 · 数据层§五 ChatService |
待定 | 设计就绪 |
| FR-05 | 项目 | P2 | AC-05.1~3 | 组件§2.2 projects / §四-8(split-workspace)· 布局§4.1 |
API§2.2(byProject)· 数据层§四.1 |
待定 | 设计就绪 |
| FR-06 | 事件 | P2 / P3 | AC-06.1~4 | 组件§四-6(day-group)/§四-11(filter-chips) |
数据层§四.1(派生口径) |
待定 | 设计就绪 |
| FR-07 | 工作台 | P2 / P3 | AC-07.1~4 | 组件§四-4(metric-block)/§四-12(live-card) |
API§2.1 · 数据层§五 LiveService |
待定 | 设计就绪 |
| FR-07b | 任务看板(多任务真源) | P2 / P3 | AC-07b.1~6 | 组件§2.2 tasks / §3.2 tasks · 布局§2.3 |
API§2.6 · 数据层§五 TasksService |
待定 | ✅ 已纳入 · 设计就绪(⚠️ 依赖云函数) |
| FR-08 | 成果 | P1 | AC-08.1~4 | 组件§四-10(file-preview) |
API§2.2(list) |
待定 | 设计就绪 |
| FR-09 | 数字生命详情 | 全部 | AC-09.1~4 | 组件§四-4 · 布局§2.3 |
API§2.1 |
待定 | 设计就绪 |
| FR-10 | 我的 | 全部 | AC-10.1~3 | 组件§2.2 mine · 令牌§四(accent 9 色) |
数据层§五 ThemeService/SessionService |
待定 | 设计就绪 |
| FR-11 | 语音通话 | P1 | AC-11.1~3 | 布局§六(/call/:id 落点) |
— | — | 🅿️ 增项·暂缓(禁建组件) |
| FR-12 | UI 规范符合性 | — (横切) | AC-12.1~6 | 令牌全文 + 组件§六 · ADR-006 |
— | verify:ui 断言脚本 |
设计就绪 |
| FR-13 | 无障碍基线 | — (横切) | AC-13.1~4 | 令牌§七.3 · 布局§3.2/§3.3/§3.5 |
— | verify:ui + 实测 |
设计就绪 |
| FR-14 | 单一事实源与轮询收敛 | — (横切) | AC-14.1~3 | 数据层§五(轮询 4→1 收敛表) |
数据层§一(分层硬约束) |
待定 | 设计就绪 |
| FR-15 | 代码洁净度 | — (横切) | AC-15.1~3 | 数据层§七 · 令牌§十二 |
— | lint + verify:ui |
设计就绪 |
| FR-16 | 旧版替换迁移 | 全部 | AC-16.1~4 | 布局§六(旧键 + 旧路径清单) |
数据层§五 DeviceService |
待定 | 设计就绪 |
| FR-17 | 三类画像信息架构适配 | 全部 | AC-17.1~3 | 令牌§一 · 布局§四 · 《用户画像.md》 |
— | 待定 | 设计就绪 |
| FR-18 | 范围冻结声明 | — (治理) | — | — | — | — | ✅ 已确认 |
| FR-19 | 移动端聚合首页 | P1 | AC-19.1~4 | 组件§3.2 home / §四-6 |
数据层§六.1(分区独立三态) |
待定 | 设计就绪 |
| FR-20 | 超管可见范围 | P2 | AC-20.1~3 | API§五(ACL 口径) |
API§五(服务端为准) |
待定 | 设计就绪 |
非功能需求追溯
| NFR | 类别 | 验证方式 | 设计依据 | 状态 |
|---|---|---|---|---|
| NFR-01 | 性能 | 构建产物体积断言(≤400KB gzip) | 数据层§八 + 路由懒加载 |
待实现 |
| NFR-02 | 性能 | 产物 chunk 分析(Matrix SDK 独立 chunk) | 数据层§五 ChatService |
待实现 |
| NFR-03 | 安全 | 密钥扫描脚本(前端零服务端密钥) | API§1.2/§3.1(密钥全在服务端) |
待实现 |
| NFR-04 | 安全 | 服务端权威判定评审 | API§2.4 / §五 |
设计就绪 |
| NFR-05 | 兼容 | 双端视口冒烟 + 多宽度布局断言 | 布局§一/§四(实测值) |
设计就绪 |
| NFR-06 | 可测 | npm test + 冒烟退出码 |
数据层§七 · 《实施计划》§四 |
待实现 |
| NFR-07 | 可追踪 | 本矩阵完整性 | — | 维护中 |
阶段② 设计产出物 → 需求覆盖核对
| 设计产出物 | 覆盖的 FR | 缺口 |
|---|---|---|
设计令牌.md v2.0 |
FR-10 · FR-12 · FR-13 · FR-17 | — |
双端布局规范.md v2.0 |
FR-01 · FR-05 · FR-11 · FR-13 · FR-16 · FR-17 | — |
组件规范.md |
FR-03~FR-09 · FR-12(AC-12.6 门槛 30,实列 57) | — |
API-契约.md |
FR-02 · FR-04 · FR-05 · FR-07 · FR-07b · FR-08 · FR-20 | kanban 接收端未实现(FR-07b 阻塞项) |
数据访问层设计.md |
FR-06 · FR-14 · FR-19 | — |
ADR-006 |
FR-12 · FR-17 | — |
结论:21 条 FR 中 20 条已挂设计文档;FR-11(语音通话)为增项暂缓、FR-18 为治理条款,按规则无需设计文档。
无缺口;唯一外部阻塞是 FR-07b 的云函数接收端(已在 API§六 列出)。
变更传播链(rules/11 必须规则 2)
需求变更时必须沿链逐层更新,缺一不可:
用户画像 / PRD → 技术方案 → 数据库 ER 图 → API 文档 → 测试用例 → 修改留痕
使用纪律
- 编码阶段每完成一个 FR,补「测试用例」列并标注验证证据。
- 交付验收时,本矩阵中状态非
已通过的行 = 未完成项,不得宣称完成。 - 设计文档变更时,回本文件核对受影响行,不得让矩阵陈旧(第 2 轮评审 N2 的教训)。