# 四向追溯矩阵

| 字段 | 值 |
|---|---|
| 版本 | 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 文档  →  测试用例  →  修改留痕
```

---

## 使用纪律

1. 编码阶段每完成一个 FR,补「测试用例」列并标注验证证据。
2. 交付验收时,本矩阵中状态非 `已通过` 的行 = 未完成项,不得宣称完成。
3. 设计文档变更时,回本文件核对受影响行,不得让矩阵陈旧(第 2 轮评审 N2 的教训)。