4.4 KiB
4.4 KiB
Requirements Traceability Matrix — Dungeon Sweeper
生成：2026-09-12 · 源：
docs/architecture/architecture.md§Technical Requirements Baseline（63 条）+ ADR-0001~0005 门检查口径：Foundation 层零缺口 = 每条 Foundation TR 都有明确裁决载体（专项 ADR，或经 design-review 门禁的 Approved GDD 契约 + 本架构文档章节），无未决项。 状态图例：✅ 已覆盖 · 🔶 待 ADR（非 Foundation，随对应系统开工前裁决）· ⏳ 随未设计系统
覆盖总览
| 层 | TR 数 | 专项 ADR 覆盖 | GDD 契约 + 架构文档覆盖 | 待裁决 |
|---|---|---|---|---|
| Foundation | 36 | ADR-0001（a3-004）· ADR-0004（d2-014/016）· ADR-0005（d2-010/gc-002） | 32 条（D2/A3/A4/B3 GDD 均 Approved + 架构文档所有权/API 节） | 0 ✅ |
| Core | 21 | ADR-0001（b1-001/002）· ADR-0002（—） | 19 条 | 2（a1-011/012 → ADR-0006） |
| Feature | 2 | — | b1 对账协议等 | 0（b1-010 文档承载） |
| Presentation / Platform | 4 | ADR-0002（gc-008） | gc-006/007 文档 | 2（gc-004/005 随 D1/B5） |
Foundation 层逐条（36 条——零缺口核验）
| TR | 需求 | 裁决载体 |
|---|---|---|
| d2-001~003 | 单一事实源 / ConfigDB 单点 / schema 先行 10 表 | D2 GDD（Approved）+ architecture.md §Module Ownership |
| d2-004 | 进度键 + R1 floor 解析 | D2 GDD R1 + architecture.md §API Boundaries |
| d2-005/006 | RngService 封闭流 / R2 派生与黄金向量 | D2 GDD R2 + architecture.md 原则 3 |
| d2-007 | 校验双通道 + 夹具注入 | D2 GDD + ADR-0004（载体） |
| d2-008 | 加载期/运行期致命 | D2 GDD Rule 6 |
| d2-009 | D2 零 UI 依赖 | D2 GDD Rule 7 + ADR-0003（core 隔离）+ architecture.md 原则 1 |
| d2-010 | SCHEMA_VERSION 版本化 | ADR-0005 |
| d2-011 | debug override 链 | D2 GDD R3 |
| d2-012 | 热重载状态机 + reload gate | D2 GDD + B1 GDD（唯一调用方） |
| d2-013 | 诊断收集器 | D2 GDD 校验双通道节 |
| d2-014 | 冒烟框架协议 | ADR-0004 |
| d2-015 | RNG 快照 = seed + 计数器 | ADR-0005 |
| d2-016 | 项目级静态扫描域 | ADR-0004（S1–S8） |
| a3-001 |
AP/RAP 账本、仲裁、相位机、refresh、表承载、last_round_end | A3 GDD（Approved）+ architecture.md |
| a3-004 | round_end 双发射源 | ADR-0001（round_end_board / round_end_stopped） |
| a4-001/002 | 变异框架 + 雾行跨字段校验 | A4 GDD（Approved） |
| a4-003/004 | 生成期布置执行归 A1 / 零特判 | A4 GDD + A1/A2 GDD |
| b3-001~006 | 统一容器 / 时限量纲 / 五 API / 三分支 / 快照 / 不 clamp | B3 GDD（Approved） |
Core / Feature / Presentation 层（27 条）
| TR | 需求 | 载体 | 状态 |
|---|---|---|---|
| a1-001 |
各系统行为契约（详见 architecture.md §TR Baseline） | 各 GDD（Approved）+ architecture.md §Module Ownership / §API Boundaries；事件类（a2-002/003、b1-001/002）由 ADR-0001 承载 | ✅ |
| a1-011 | 度量独立入口三函数 | 🔶 待 ADR-0006（生成性能与异步化——A1 OQ2/OQ3） | 🔶 |
| a1-012 | F2c 成本闸 / 生成性能姿态 | 🔶 待 ADR-0006（Core 层，A1 开工前裁决；切片证据已背书同步方案） | 🔶 |
| b2-005（注：face 归属实为 b2 OQ1 项） | query_attack/ambush_grant_plan 两 face | 🔶 待 ADR-0007（单位 API face 归属——B2 OQ1/OQ5） | 🔶 |
| gc-004 | 双舞台资产管线 | ⏳ B5 前美术测试 → ADR-0011 | ⏳ |
| gc-005 | 视觉锚三硬约束 | 🔶 D1 GDD（未写——MVP 层最后一块；切片教训四条为其硬输入） | 🔶 |
| gc-006/007 | 性能预算 / 平台输入 | technical-preferences + ADR-0002（窗口基座） | ✅ |
| gc-008 | 渲染器选择 | ADR-0002 | ✅ |
待裁决 ADR 队列（全部非 Foundation）
| ADR | 议题 | 触发时机 |
|---|---|---|
| ADR-0006 | 生成性能与异步化（A1 OQ2/OQ3 + 度量独立入口确认） | A1 生产实现前 |
| ADR-0007 | B2/B1 两 face 归属 + HeroTable 单行校验落点 | B2 生产实现前 |
| ADR-0008 | 零伤害死局跨字段护栏落点 | D2 生产化前 |
| ADR-0009 | 切片机制正式化（轮内刷新 / RewardSupplyController / LevelTable / grant_node_active / clear_blast） | 正式化批 |
| ADR-0010~0013 | A1 熔断 / B5 舞台 / A5 显影 / D3 存档格式（契约已由 ADR-0005 锁定） | 各系统 GDD 立项时 |