需求追溯矩陣範本(RTM, Requirements Traceability Matrix Template)

需求追溯矩陣範本(Requirements Traceability Matrix, RTM) 參照標準:ISO/IEC/IEEE 29148:2018(需求追溯)/ ISO/IEC/IEEE 29119-3:2021 文件用途:串起「需求 → 設計 → 實作 → 測試」,確認每條需求都被實作與驗證,且每段程式都有需求依據 適用階段:需求核准(G1)起持續維護,於設計核准(G2)與上線核准(G3)時檢查 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.7、2.4 節 📋 章節目錄 文件資訊 追溯矩陣 自動追溯設定 缺口與處理 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 RTM-{專案代碼}-{序號} 對應需求文件 {PRD/FRD/SRD 文件編號與版本} 最後更新 {YYYY-MM-DD}(由 CI 自動產生時填寫建置編號) 負責人 {BA/QA Lead} 📖 使用說明 前向追溯:每條需求都有設計、實作、測試 → 防止遺漏 反向追溯:每段程式與測試都對應到需求 → 防止鍍金與範圍蔓延 建議以「測試程式碼中的需求編號標註」自動產生,人工維護的 Excel 很快就會過時 💡 範例 項目 內容 文件編號 RTM-HRMS-001 對應需求文件 FRD-HRMS-001 v1.3、SRD-HRMS-001 v1.1 最後更新 2026-10-05(CI build #482) 負責人 QA Lead 黃小玲 2. 追溯矩陣 📝 範本 需求編號 需求摘要 來源 優先序 設計(SDD 章節/API) 實作(模組/類別) 測試案例 測試結果 狀態 {FR-xxx} {摘要} {BRD/CR 編號} {Must/Should/Could} {SDD x.y/METHOD /path} {模組/類別} {TC-xxx} {Pass/Fail/未執行} {✅/⏳/❌} 📖 使用說明 非功能需求(NFR)通常由效能或安全測試驗證,「測試案例」欄填寫測試報告編號 需求異動(CR)時,同步更新受影響的列並記錄 CR 編號 狀態判定:設計、實作、測試三欄都有值且測試 Pass 才是 ✅ 💡 範例 需求編號 需求摘要 來源 優先序 設計 實作 測試案例 測試結果 狀態 FR-LV-001 員工提交請假申請 BRD 3.1 Must SDD 5.2/POST /api/v1/leaves leave-service/LeaveService TC-LV-001-01~04 Pass ✅ FR-LV-002 特休額度不足時拒絕申請 BRD 3.1 Must SDD 5.2/422 Problem Details LeaveQuotaPolicy TC-LV-002-01~02 Pass ✅ FR-LV-005 主管代理人設定 CR-2026-011 Should SDD 5.4 DelegateService TC-LV-005-01 未執行 ⏳ NFR-PERF-001 請假查詢 p95 < 500 ms(200 TPS) SRD 4.1 Must SDD 8.1 快取 LeaveQueryService PT-RPT-2026-03(k6) Fail(620 ms) ❌ 3. 自動追溯設定 📝 範本 // 在自動化測試上標註需求編號(JUnit 5 以上) @Tag("{需求編號}") @DisplayName("{測試案例編號} {情境描述}") @Test void {測試方法名稱}() { /* ... */ } # 前向追溯缺口:需求清單中有、但測試程式碼中找不到的需求編號 grep -ohE "^\| (FR|NFR)-[A-Z]+-[0-9]{3}" docs/requirements/rtm.md | tr -d '| ' | sort -u > req.txt grep -rohE "@Tag\(\"(FR|NFR)-[A-Z]+-[0-9]{3}\"\)" src/test | grep -oE "(FR|NFR)-[A-Z]+-[0-9]{3}" | sort -u > tested.txt comm -23 req.txt tested.txt # 有輸出 → 有需求沒有自動化測試 comm -13 req.txt tested.txt # 有輸出 → 有測試沒有對應需求(反向追溯缺口) 📖 使用說明 正規表示式需配合專案的需求編號格式調整 由效能或安全測試驗證的 NFR 不會有 @Tag,應在比對前從 req.txt 排除,或改以測試報告編號人工確認 建議在 CI 中執行,前向缺口數量做為 G2/G3 閘門的檢查項目 💡 範例 @Tag("FR-LV-002") @DisplayName("TC-LV-002-01 特休剩餘 2 天時申請 3 天,回傳 422") @Test void shouldRejectWhenAnnualLeaveQuotaInsufficient() { /* ... */ } 4. 缺口與處理 📝 範本 缺口類型 需求/測試編號 原因 處理方式 負責人 期限 {前向/反向} {編號} {原因} {補測試/補需求/刪除程式} {姓名} {日期} 📖 使用說明 反向缺口(有程式沒需求)可能是鍍金,也可能是需求文件漏寫,需由 PO 判斷 缺口未處理完畢不得通過 G3 上線閘門(風險 L1 專案) 💡 範例 缺口類型 需求/測試編號 原因 處理方式 負責人 期限 前向 FR-LV-005 測試環境尚未建立代理人資料 補測試資料後執行 TC-LV-005-01 QA 陳 2026-10-08 反向 @Tag("FR-LV-099") 開發自行新增「批次匯出」功能,無需求 PO 決定移除功能 Tech Lead 王 2026-10-09 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的 RTM 是否正確。 ...

October 6, 2026 · 2 min · 385 words · Eric Cheng