# 四向追溯矩阵:【项目名称】

> 文件命名:`docs/04-quality/traceability-matrix.md`(每项目一份,持续更新)。四向关联:需求 FR ↔ 测试 AC/用例 ↔ 代码提交 ↔ 库 Schema 变更(见 02-开发流程与文档同步.md 规则 12)。任何需求修改、代码编写、数据库调整发生时在此登记,并在操作追踪条目中填写四向编号。

| 字段 | 值 |
|---|---|
| 版本号 | v1.0 |
| 最后更新日期 | YYYY-MM-DD |
| 状态 | 生效 |
| 本次变更原因 | 首次创建 |

## 一、追溯总表

| 需求 FR | 验收 AC | 测试用例 | 代码提交 | Schema 变更 | 状态 |
|---|---|---|---|---|---|
| FR-001 | AC-001 | 用例名/路径 | commit 短哈希 | 变更日期+说明 | 已验收/开发中/待测试 |
| | | | | | |

## 二、变更登记(按时间追加)

| 日期 | 变更类型(需求/代码/数据库) | 四向编号 | 变更内容 | 关联操作追踪条目 | 关联留痕文档 |
|---|---|---|---|---|---|
| | | | | | |

## 三、矩阵完整性检查(每次评审/验收时核对)

- [ ] 每个 FR 至少关联一条 AC 与一个测试用例
- [ ] 每处代码提交关联到对应 FR(提交信息注明)
- [ ] 每次 Schema 变更关联到对应 FR 与变更留痕
- [ ] 无孤儿需求(有 FR 无实现)、无无源实现(有代码无 FR)