<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>追溯 on Eric 個人部落格</title><link>https://chihhung.github.io/Blog/tags/%E8%BF%BD%E6%BA%AF/</link><description>Recent content in 追溯 on Eric 個人部落格</description><generator>Hugo</generator><language>zh-TW</language><lastBuildDate>Tue, 06 Oct 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://chihhung.github.io/Blog/tags/%E8%BF%BD%E6%BA%AF/index.xml" rel="self" type="application/rss+xml"/><item><title>需求追溯矩陣範本（RTM, Requirements Traceability Matrix Template）</title><link>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/templates/requirements/rtm_template/</link><pubDate>Tue, 06 Oct 2026 00:00:00 +0000</pubDate><guid>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/templates/requirements/rtm_template/</guid><description>&lt;h1 id="需求追溯矩陣範本requirements-traceability-matrix-rtm"&gt;需求追溯矩陣範本（Requirements Traceability Matrix, RTM）&lt;/h1&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;參照標準&lt;/strong&gt;：ISO/IEC/IEEE 29148:2018（需求追溯）/ ISO/IEC/IEEE 29119-3:2021&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;文件用途&lt;/strong&gt;：串起「需求 → 設計 → 實作 → 測試」，確認每條需求都被實作與驗證，且每段程式都有需求依據&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;適用階段&lt;/strong&gt;：需求核准（G1）起持續維護，於設計核准（G2）與上線核准（G3）時檢查&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;範本版本&lt;/strong&gt;：v2.0（2026-10-06）｜對應《軟體開發標準程序教學手冊》v2.0 第 3.7、2.4 節&lt;/p&gt;&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2 id="-章節目錄"&gt;📋 章節目錄&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href="#1-%E6%96%87%E4%BB%B6%E8%B3%87%E8%A8%8A"&gt;文件資訊&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#2-%E8%BF%BD%E6%BA%AF%E7%9F%A9%E9%99%A3"&gt;追溯矩陣&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#3-%E8%87%AA%E5%8B%95%E8%BF%BD%E6%BA%AF%E8%A8%AD%E5%AE%9A"&gt;自動追溯設定&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#4-%E7%BC%BA%E5%8F%A3%E8%88%87%E8%99%95%E7%90%86"&gt;缺口與處理&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#5-%E5%AF%A9%E6%9F%A5%E8%88%87%E9%A9%97%E8%AD%89"&gt;審查與驗證&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;h2 id="1-文件資訊"&gt;1. 文件資訊&lt;/h2&gt;
&lt;h3 id="-範本"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;內容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;文件編號&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;RTM-{專案代碼}-{序號}&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;對應需求文件&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;{PRD／FRD／SRD 文件編號與版本}&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;最後更新&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;{YYYY-MM-DD}（由 CI 自動產生時填寫建置編號）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;負責人&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;{BA／QA Lead}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;前向追溯：每條需求都有設計、實作、測試 → 防止遺漏&lt;/li&gt;
&lt;li&gt;反向追溯：每段程式與測試都對應到需求 → 防止鍍金與範圍蔓延&lt;/li&gt;
&lt;li&gt;建議以「測試程式碼中的需求編號標註」自動產生，人工維護的 Excel 很快就會過時&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;項目&lt;/th&gt;
&lt;th&gt;內容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;文件編號&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;RTM-HRMS-001&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;對應需求文件&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;FRD-HRMS-001 v1.3、SRD-HRMS-001 v1.1&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;最後更新&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;2026-10-05（CI build #482）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;負責人&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;QA Lead 黃小玲&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id="2-追溯矩陣"&gt;2. 追溯矩陣&lt;/h2&gt;
&lt;h3 id="-範本-1"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;需求編號&lt;/th&gt;
&lt;th&gt;需求摘要&lt;/th&gt;
&lt;th&gt;來源&lt;/th&gt;
&lt;th&gt;優先序&lt;/th&gt;
&lt;th&gt;設計（SDD 章節／API）&lt;/th&gt;
&lt;th&gt;實作（模組／類別）&lt;/th&gt;
&lt;th&gt;測試案例&lt;/th&gt;
&lt;th&gt;測試結果&lt;/th&gt;
&lt;th&gt;狀態&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;{FR-xxx}&lt;/td&gt;
&lt;td&gt;{摘要}&lt;/td&gt;
&lt;td&gt;{BRD／CR 編號}&lt;/td&gt;
&lt;td&gt;{Must／Should／Could}&lt;/td&gt;
&lt;td&gt;{SDD x.y／&lt;code&gt;METHOD /path&lt;/code&gt;}&lt;/td&gt;
&lt;td&gt;{模組／類別}&lt;/td&gt;
&lt;td&gt;{TC-xxx}&lt;/td&gt;
&lt;td&gt;{Pass／Fail／未執行}&lt;/td&gt;
&lt;td&gt;{✅／⏳／❌}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明-1"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;非功能需求（NFR）通常由效能或安全測試驗證，「測試案例」欄填寫測試報告編號&lt;/li&gt;
&lt;li&gt;需求異動（CR）時，同步更新受影響的列並記錄 CR 編號&lt;/li&gt;
&lt;li&gt;狀態判定：設計、實作、測試三欄都有值且測試 Pass 才是 ✅&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例-1"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;需求編號&lt;/th&gt;
&lt;th&gt;需求摘要&lt;/th&gt;
&lt;th&gt;來源&lt;/th&gt;
&lt;th&gt;優先序&lt;/th&gt;
&lt;th&gt;設計&lt;/th&gt;
&lt;th&gt;實作&lt;/th&gt;
&lt;th&gt;測試案例&lt;/th&gt;
&lt;th&gt;測試結果&lt;/th&gt;
&lt;th&gt;狀態&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;FR-LV-001&lt;/td&gt;
&lt;td&gt;員工提交請假申請&lt;/td&gt;
&lt;td&gt;BRD 3.1&lt;/td&gt;
&lt;td&gt;Must&lt;/td&gt;
&lt;td&gt;SDD 5.2／&lt;code&gt;POST /api/v1/leaves&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;leave-service&lt;/code&gt;／&lt;code&gt;LeaveService&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;TC-LV-001-01～04&lt;/td&gt;
&lt;td&gt;Pass&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;FR-LV-002&lt;/td&gt;
&lt;td&gt;特休額度不足時拒絕申請&lt;/td&gt;
&lt;td&gt;BRD 3.1&lt;/td&gt;
&lt;td&gt;Must&lt;/td&gt;
&lt;td&gt;SDD 5.2／422 Problem Details&lt;/td&gt;
&lt;td&gt;&lt;code&gt;LeaveQuotaPolicy&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;TC-LV-002-01～02&lt;/td&gt;
&lt;td&gt;Pass&lt;/td&gt;
&lt;td&gt;✅&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;FR-LV-005&lt;/td&gt;
&lt;td&gt;主管代理人設定&lt;/td&gt;
&lt;td&gt;CR-2026-011&lt;/td&gt;
&lt;td&gt;Should&lt;/td&gt;
&lt;td&gt;SDD 5.4&lt;/td&gt;
&lt;td&gt;&lt;code&gt;DelegateService&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;TC-LV-005-01&lt;/td&gt;
&lt;td&gt;未執行&lt;/td&gt;
&lt;td&gt;⏳&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;NFR-PERF-001&lt;/td&gt;
&lt;td&gt;請假查詢 p95 &amp;lt; 500 ms（200 TPS）&lt;/td&gt;
&lt;td&gt;SRD 4.1&lt;/td&gt;
&lt;td&gt;Must&lt;/td&gt;
&lt;td&gt;SDD 8.1 快取&lt;/td&gt;
&lt;td&gt;&lt;code&gt;LeaveQueryService&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;PT-RPT-2026-03（k6）&lt;/td&gt;
&lt;td&gt;Fail（620 ms）&lt;/td&gt;
&lt;td&gt;❌&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id="3-自動追溯設定"&gt;3. 自動追溯設定&lt;/h2&gt;
&lt;h3 id="-範本-2"&gt;📝 範本&lt;/h3&gt;
&lt;div class="highlight"&gt;
&lt;pre tabindex="0"&gt;&lt;code class="language-java" data-lang="java"&gt;// 在自動化測試上標註需求編號（JUnit 5 以上）
@Tag(&amp;#34;{需求編號}&amp;#34;)
@DisplayName(&amp;#34;{測試案例編號} {情境描述}&amp;#34;)
@Test
void {測試方法名稱}() { /* ... */ }&lt;/code&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;div class="highlight"&gt;
&lt;pre tabindex="0"&gt;&lt;code class="language-bash" data-lang="bash"&gt;# 前向追溯缺口：需求清單中有、但測試程式碼中找不到的需求編號
grep -ohE &amp;#34;^\| (FR|NFR)-[A-Z]&amp;#43;-[0-9]{3}&amp;#34; docs/requirements/rtm.md | tr -d &amp;#39;| &amp;#39; | sort -u &amp;gt; req.txt
grep -rohE &amp;#34;@Tag\(\&amp;#34;(FR|NFR)-[A-Z]&amp;#43;-[0-9]{3}\&amp;#34;\)&amp;#34; src/test | grep -oE &amp;#34;(FR|NFR)-[A-Z]&amp;#43;-[0-9]{3}&amp;#34; | sort -u &amp;gt; tested.txt
comm -23 req.txt tested.txt # 有輸出 → 有需求沒有自動化測試
comm -13 req.txt tested.txt # 有輸出 → 有測試沒有對應需求（反向追溯缺口）&lt;/code&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;h3 id="-使用說明-2"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;正規表示式需配合專案的需求編號格式調整&lt;/li&gt;
&lt;li&gt;由效能或安全測試驗證的 NFR 不會有 &lt;code&gt;@Tag&lt;/code&gt;，應在比對前從 &lt;code&gt;req.txt&lt;/code&gt; 排除，或改以測試報告編號人工確認&lt;/li&gt;
&lt;li&gt;建議在 CI 中執行，前向缺口數量做為 G2／G3 閘門的檢查項目&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例-2"&gt;💡 範例&lt;/h3&gt;
&lt;div class="highlight"&gt;
&lt;pre tabindex="0"&gt;&lt;code class="language-java" data-lang="java"&gt;@Tag(&amp;#34;FR-LV-002&amp;#34;)
@DisplayName(&amp;#34;TC-LV-002-01 特休剩餘 2 天時申請 3 天，回傳 422&amp;#34;)
@Test
void shouldRejectWhenAnnualLeaveQuotaInsufficient() { /* ... */ }&lt;/code&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;hr&gt;
&lt;h2 id="4-缺口與處理"&gt;4. 缺口與處理&lt;/h2&gt;
&lt;h3 id="-範本-3"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;缺口類型&lt;/th&gt;
&lt;th&gt;需求／測試編號&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;th&gt;處理方式&lt;/th&gt;
&lt;th&gt;負責人&lt;/th&gt;
&lt;th&gt;期限&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;{前向／反向}&lt;/td&gt;
&lt;td&gt;{編號}&lt;/td&gt;
&lt;td&gt;{原因}&lt;/td&gt;
&lt;td&gt;{補測試／補需求／刪除程式}&lt;/td&gt;
&lt;td&gt;{姓名}&lt;/td&gt;
&lt;td&gt;{日期}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明-3"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;反向缺口（有程式沒需求）可能是鍍金，也可能是需求文件漏寫，需由 PO 判斷&lt;/li&gt;
&lt;li&gt;缺口未處理完畢不得通過 G3 上線閘門（風險 L1 專案）&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例-3"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;缺口類型&lt;/th&gt;
&lt;th&gt;需求／測試編號&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;th&gt;處理方式&lt;/th&gt;
&lt;th&gt;負責人&lt;/th&gt;
&lt;th&gt;期限&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;前向&lt;/td&gt;
&lt;td&gt;FR-LV-005&lt;/td&gt;
&lt;td&gt;測試環境尚未建立代理人資料&lt;/td&gt;
&lt;td&gt;補測試資料後執行 TC-LV-005-01&lt;/td&gt;
&lt;td&gt;QA 陳&lt;/td&gt;
&lt;td&gt;2026-10-08&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;反向&lt;/td&gt;
&lt;td&gt;&lt;code&gt;@Tag(&amp;quot;FR-LV-099&amp;quot;)&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;開發自行新增「批次匯出」功能，無需求&lt;/td&gt;
&lt;td&gt;PO 決定移除功能&lt;/td&gt;
&lt;td&gt;Tech Lead 王&lt;/td&gt;
&lt;td&gt;2026-10-09&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id="5-審查與驗證"&gt;5. 審查與驗證&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本節供審查者使用，也用來檢查 AI 依本範本產出的 RTM 是否正確。&lt;/p&gt;</description></item></channel></rss>