61 lines
4.6 KiB
Markdown
61 lines
4.6 KiB
Markdown
# Requirements Traceability Matrix — Dungeon Sweeper
|
||
|
||
> 生成：2026-09-12 · 源：`docs/architecture/architecture.md` §Technical Requirements Baseline（63 条）+ ADR-0001~0005 · 2026-09-15 雾格移除清理（a4-001/002 需求文本与载体同步现行文档）
|
||
> 门检查口径：**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~003/005~008 | 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~010, a2-001~010, b2-001~004/006, b4-001~009, b1-003~009/011 | 各系统行为契约（详见 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 立项时 |
|