指南 · 需求
需求可追溯性與變更影響:關聯需要、需求、設計與測試
收聽本指南 27 分鐘
需求可追溯性是一份紀錄,說明每項需求從何而來、設計中有什麼實現它,以及有什麼顯示它已被滿足。它最主要的回報是變更影響:當需求變更時,關聯會告訴您有哪些東西必須重新檢查。本指南涵蓋追溯關聯的類型與方向、向前與向後追溯、涵蓋缺口與孤立項目、可疑關聯以及可追溯性矩陣,並以一個 CubeSat 模型為完整範例。
本頁內容
什麼是需求可追溯性
需求很少單獨存在。它回應某個利害關係人需要,可能被展開為較低層級的需求,由某個功能或元件執行,並由某項測試或分析檢查。可追溯性就是這些項目之間一組明確、有紀錄的關聯。每條關聯都指明其兩端,並說明關係是什麼:「3.1 Orbit Average Power is satisfied by 1.3.1 Solar Arrays」是一條追溯;設計報告中提到太陽能板的一句話則不是。
這些關聯形成一張網,從利害關係人需要出發,經過系統與子系統需求,延伸到架構與驗證。ISO/IEC/IEEE 15288 在多個技術流程中要求這張網:利害關係人需要追溯到將其正式化的需求,系統需求追溯到它們所分配到的架構元素,而每項需求都追溯到驗證它的活動。INCOSE 系統工程手冊將可追溯性視為一組良好需求整體所具備的特性,而不是在最後才產出的一份獨立文件。
為什麼要追溯需求:首先是變更影響
建立關聯需要心力,維持其正確需要更多心力,因此了解它們的回報會有幫助。四種用途承載了大部分的價值,而第一種是大多數團隊開始追溯的原因。
- 變更影響。變更之前,關聯會顯示它會波及什麼:哪些較低層級的需求、功能、元件、分析與測試依賴於被變更的項目。變更之後,同樣的關聯會告訴團隊要重新檢查什麼。沒有關聯,答案就取決於誰還記得設計(請參閱 變更影響分析指南)。
- 涵蓋率。每項需求都應該由設計中的某個東西實現,並由驗證中的某個東西檢查。關聯能讓缺少的項目顯現出來,遠在整合測試或客戶發現之前。
- 符合性與正當性。合約、安全標準與審查都要求證據,證明每項需求都已滿足,而且設計中沒有任何東西是無緣無故存在的。從需要到需求、到設計、再到測試的追溯,就是這項證據。
- 變更管制。當需求在議定之後變更時,與它關聯的項目必須重新審查,而且審查必須有紀錄。關聯會告訴變更委員會要重新審查什麼,並讓團隊能證明審查確實發生過。
只在階段結束時為稽核而追溯的團隊,付出了成本,卻得不到大部分的好處。在撰寫需求與設計時就建立的關聯,建立成本較低,而且在變更來臨時就已就位。變更影響的答案也只會與關聯一樣完整:應該有關聯卻沒有的項目,對它而言是看不見的,完整範例就說明了這一點。
需要與需求
可追溯性從需求之上開始。需要 是利害關係人對系統的期望,以利害關係人自己的用語表達:「Farm customers need fresh imagery of their fields at least twice a week in the growing season.」需求 則是系統據以建造與驗證的工程陳述:「The mission shall revisit each target region within 72 hours.」
兩者在目的與形式上都不同:
| 需要 | 需求 | |
|---|---|---|
| 擁有者 | 利害關係人:使用者、操作者、客戶、主管機關 | 工程團隊,與利害關係人議定 |
| 語言 | 利害關係人自己的用語,通常是定性的 | 精確、可量測,每個陳述一個「shall」 |
| 確認或驗證 | 確認:交付的系統做到利害關係人所需要的事 | 驗證:系統以測試、分析、檢驗或示範證明符合陳述 |
| 典型數量 | 數十項 | 數百到數千項,分布在多個層級 |
第一條追溯將每項需要關聯到將其正式化的需求。沒有需求的需要,是設計不會處理的利害關係人期望。在最高層級沒有需要的需求,要嘛是應該寫成需要的隱含假設,要嘛是沒有人要求的需求。如何將需要轉化為格式良好的需求,是 撰寫良好需求指南 的主題。驗證與確認指南 則說明每項需要如何取得自己的確認事件。
追溯關聯的種類
大多數方法與工具都使用一小組關聯類型。各自的名稱不同,但意義是穩定的。每種類型回答不同的問題,使用符合事實的最具體類型,能讓關聯對報告與檢查有用。範例取自本指南稍後使用的 CubeSat。
| 關聯(從上游端讀取) | 從 → 到 | 回答的問題 | 範例 |
|---|---|---|---|
| derived by(derives from) | 需求 → 由它展開的需求 | 哪些需求是由這一項展開並加入設計細節的? | 1.5 Daily Collection Volume → 3.1 Orbit Average Power:成像負載決定了功率需要 |
| decomposed by(父項與子項) | 需求 → 其組成部分 | 哪些較低層級的陳述共同構成這一項? | 1.6 Revisit Time → 1.6.1 Ground Track Repeat 與 1.6.2 Off-Nadir Imaging |
| refined by | 需求 → 更精確的需求 | 哪個陳述以數值、公差或條件表達相同的意圖? | 「Recover from safe mode quickly」→「resume imaging within 6 hours of a safe mode entry」 |
| satisfied by / allocated to | 需求 → 功能、元件、介面、分析 | 設計中有什麼實現這項需求? | 3.1 → F3.1 Convert Sunlight to Power、1.3.1 Solar Arrays |
| verified by | 需求 → 測試案例、分析、檢驗、示範 | 有什麼顯示這項需求是否已滿足? | 3.1 → TC-06 Solar Array Power Test |
| traced to | 需要或需求 → 任何相關項目 | 當以上都不適用或關係尚未確定時,有什麼對應這個陳述? | N2 Twice-Weekly Revisit → 1.6 Revisit Time |
關於這張表有三點說明。衍生 需求是父項使其成為必要的新陳述;分解 需求是父項的一部分,當其各部分都滿足時,父項就滿足了。分配 與 滿足 常被當作同義詞使用;有些方法先將需求分配給元件,再說該元件的設計滿足它,只有當團隊確實分別審查這兩者時,這個區分才值得保留。而單純的 追溯 是最弱的關聯:它只說明兩個項目有關,不說明如何相關。它適用於需要到需求的關聯以及早期尚未確定的分配;一旦關係確定,就以具體的類型取代它。
方向
每條關聯都有方向,而大多數團隊使用的慣例是從驅動的項目指向回應的項目:從需要到需求,從父需求到衍生需求,從需求到設計元素與測試。關聯可以從任一端讀取(「3.1 is satisfied by the solar arrays」、「the solar arrays satisfy 3.1」),但它是一條關聯,只記錄一次。
方向正是讓變更影響得以運作的關鍵。上游端的變更會讓其下游的每個項目都受到質疑;下游端的變更通常不會使其上方的需求失效,雖然這可能表示設計不再滿足它。在變更後標示關聯的工具,依靠這個方向來決定要標示哪一端。
SysML 使用者會知道這些關聯就是帶有構造型的相依:«deriveReqt»、«refine»、«satisfy»、«verify» 與 «trace»。在 SysML 中,箭頭從相依元素畫向需求(測試案例指向它所驗證的需求),這與上面的讀法相反。意義相同,只有繪圖慣例不同。SysML v2 教學 說明 satisfy 與 verify 在文字表示法中如何撰寫。
向前與向後可追溯性
可追溯性從兩個方向檢查。
- 向前(向下):從每項需要到涵蓋它的需求,從每項需求到滿足它的設計元素與驗證它的測試。向前追溯回答「我們被要求的一切是否都已建造並檢查?」
- 向後(向上):從每項測試、功能或元件回到它所服務的需求,從每項需求回到某項需要或父需求。向後追溯回答「我們所建造的一切是否都有理由?」
當兩者都成立時,需求集合就具有 雙向可追溯性。實務上,向前的缺口顯示缺少的工作,向後的缺口則顯示多餘的工作:過度設計、從先前產品沿用的設計元素、檢查了沒有人要求之事的測試,或是有人在沒有來源的情況下加入的需求。
涵蓋缺口與孤立項目
追溯網的兩種失效都有名稱。
- 涵蓋缺口 是缺少應有關聯的需求:沒有任何東西滿足、或沒有任何東西驗證的末端需求。要檢查末端需求,也就是沒有子需求的需求。父項透過其子項獲得涵蓋,若要求父項也有直接關聯,會產生重複的關聯。
- 孤立項目 是沒有上游關聯的項目:不滿足任何需求的功能、元件或分析,不驗證任何需求的測試案例,或沒有父項的衍生需求。孤立項目不一定是錯的。飛行備品是為了整合作業而存在,此時修正方式可能是補上缺少的需求,而不是刪除項目。無論如何,孤立項目都是團隊必須回答的問題。
涵蓋率數字(「94% 的末端需求已分配」)對追蹤進度很有用,但團隊實際依據的是未涵蓋項目的清單。補上缺少的關聯、判定該需求不是末端需求,或刪除不需要的需求,都可以關閉缺口。
孤立項目對變更影響也很重要。應該對應某項需求卻沒有關聯的項目,在該需求變更時不會被標示。下面的範例中就有一個。
變更後的可疑關聯
關聯記錄的是在某個時間點做出的判斷:「這個元件,依目前的設計,實現了這項需求,依目前的寫法。」當需求的文字或數值變更時,這個判斷可能不再成立。可疑關聯 是在上次審查之後,其上游端發生變更的關聯。關聯不會被刪除,也不會被假定已失效;它會被標示,直到有人查看另一端的項目並做出決定。Holarch 將這些列為 待檢查的連結。
清除可疑關聯是一次小型審查:
- 閱讀變更了什麼:舊的與新的文字,或是變動的屬性。
- 檢查下游端的項目。衍生需求是否仍然成立?元件是否仍然實現該需求?測試是否仍然檢查新的數值?
- 如果仍然成立,清除標示並記錄原因,例如「Function text has no power value; no change needed.」
- 如果不再成立,變更下游項目(或對它提出變更),然後清除標示。如果關聯本身已不再正確,就移除它。
紀錄與決定同樣重要。附有留言與姓名而清除的可疑關聯,是給下一次審查的證據,證明變更已被追蹤到底;未經查看就大量清除的標示比沒有標示更糟,因為它聲稱了一次並未發生的審查。
並非每次編輯都需要產生標示。修正需求名稱中的錯字,不應該讓二十個項目進入審查;而將功率位準從 28 W 改為 30 W 則必須如此。各工具劃分這條界線的方式不同;有用的問題是,這項變更是否可能使下游的判斷變成錯的。
可追溯性矩陣
可追溯性矩陣以網格顯示兩組項目之間的關聯:例如列為需求,欄為功能、元件或測試案例。儲存格中的標記表示該列與該欄有關聯。每項需求一列、並有一欄列出其關聯項目的表格,也常被稱為可追溯性矩陣(下面的下載檔就是這種形式);網格形式較容易掃視缺口,因為空白的列或欄很顯眼。
解讀矩陣:
- 空白的列 是涵蓋缺口:一項沒有關聯到任何欄的需求。
- 空白的欄 是孤立項目:沒有任何列關聯到的功能、元件或測試。
- 有許多標記的列 可能是一項範圍太廣、應該拆分的需求。
- 有許多標記的欄 是許多需求所依賴的設計元素;對它的變更影響範圍很廣。
矩陣是關聯的一種檢視,而不是關聯存放的地方。將關聯保存在人工維護的試算表中的團隊會發現,試算表與設計會逐漸脫節;從模型產生的矩陣則永遠與模型同樣新。
需求驗證矩陣是一種相關的檢視,列出每項需求及其驗證方法、驗證活動與其結果。它是同一組關聯的驗證面;需求驗證矩陣(RVTM)指南 以同一顆 CubeSat 說明它。
完整範例:EO-1 CubeSat
範例是 EO-1,一顆以四個光譜波段拍攝農地的虛構 6U CubeSat。它與 端對端 MBSE 範例專案 是同一個模型,在 Holarch 中建構為 LML 專案:需求是規格 SRS-001 EO-1 System Requirements Specification 中的 Requirement(共 32 項),功能是編號 F1 到 F11 並有子功能的 Action,元件是 Asset,測試則是 Test Case TC-01 到 TC-20。這些功能來自 同一任務的功能分析。
需要與需求
示範專案在 來源 屬性中記錄每項需求的出處:Customer Needs Statement CNS-1、Mission Concept Review 或 Derived (systems analysis)。屬性只能指名一份文件;它無法被追蹤、計數或標示。因此模型也將客戶研討會中的三項利害關係人需要記錄為 Statement,每項都追溯到將其正式化的需求。N1 到 N3 是 EO-1 參考模型(v1.0)以及在 Holarch 2.2.1 或更新版本中建立的示範專案的一部分。
| 需要 | 陳述 | 追溯到 |
|---|---|---|
| N1 Same-Day Crop Stress Alerts | 農業客戶需要在過境當天得知作物逆境。 | 6.2 Image Delivery(下傳後 6 小時內)、6.5 Planning Cycle Time(100 分鐘內) |
| N2 Twice-Weekly Revisit | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | 1.6 Revisit Time(72 小時內) |
| N3 Field-Level Vegetation Maps | 農業客戶需要細緻到足以區分相鄰田地的植被地圖。 | 1.2 Ground Sample Distance(4.5 m)、1.4 Spectral Bands(四個波段,450 nm 到 900 nm) |
在需要之下,規格使用了全部三種需求對需求的關聯。1.6 Revisit Time 分解 為 1.6.1 Ground Track Repeat(3 天)與 1.6.2 Off-Nadir Imaging(25 度):兩者共同達成 72 小時的重訪。3.1 Orbit Average Power 衍生自 1.5 Daily Collection Volume,3.3 Depth of Discharge 衍生自 1.7 Mission Lifetime:沒有客戶要求某個功率位準或電池限制,但沒有它們,就無法達成成像量與 730 天的壽命。因此像 3.1 這樣的需求上方沒有需要,這是正確的:它的父項是另一項需求。
電源需求的關聯
第 3 節 Electrical Power 是很適合仔細閱讀的一部分。下表依模型列出滿足與驗證每項需求的項目:
| 需求 | Satisfied by(功能) | Satisfied by(元件) | Satisfied by(其他) | Verified by |
|---|---|---|---|---|
| 3.1 Orbit Average Power | F3、F3.1 | 1.3.1 Solar Arrays | EQ-1.1 Solar Power Generation、EQ-1.4 Power Margin Check | TC-06 Solar Array Power Test(通過) |
| 3.2 Battery Capacity | F3、F3.2 | 1.3.2 Battery Pack | TC-07 Battery Capacity Test(通過) | |
| 3.3 Depth of Discharge | F3、F3.3 | EQ-1.2 Battery Depth of Discharge、OPS.10、IF-21 | TC-07 Battery Capacity Test(通過) | |
| 3.4 Bus Regulation | F3、F3.3 | 1.3.3 Power Distribution Unit | IF-01 到 IF-04、IF-20、IF-22(電源線) | TC-18 Bus Regulation Inspection(通過) |
| 3.5 Battery Thermal Control | (無) | (無) | (無) | (無) |
| 3.6 Array Deployment | F2 Deploy Solar Arrays | 1.6 Structure and Thermal | IF-19 Deployment Switch Harness | TC-19 Array Deployment Test(未執行) |
F3 Generate and Store Power 滿足四項需求,其子功能 F3.1 到 F3.3 將它們分給太陽能板、電池與電源分配單元。滿足 3.4 的電源線是介面;介面控制文件指南 會將它們追蹤到 ICD 中。
解讀矩陣:一個缺口與一個孤立項目
以六項電源需求為列、設計與測試項目為欄,矩陣(6 列、17 欄、21 條關聯)一眼就能看出:
- 3.5 Battery Thermal Control 是涵蓋缺口:它的列是空白的。設計中沒有任何東西讓電池保持溫暖,也沒有測試檢查它。這項需求本身也很薄弱(「keep the battery warm enough (TBD)」),而這兩個問題是相關的:沒有數值的需求很難分配,也不可能測試。需求撰寫指南 改寫了它。
- EQ-1.3 Orbit-Average Array Power 是孤立項目:它的欄是空白的。它從峰值功率、日照比例與功率路徑效率計算軌道平均的太陽能板輸出,這正是 3.1 所約束的量,但它卻不滿足任何需求。它的同類 EQ-1.4 Power Margin Check 關聯到 3.1;EQ-1.3 則被遺漏了。
- F3 Generate and Store Power 承載四項需求,因此對它的變更會波及這四項。TC-07 驗證兩項(3.2 與 3.3)。
- 驗證儲存格顯示測試狀態:TC-06、TC-07 與 TC-18 已通過,TC-19 尚未執行。涵蓋率與驗證狀態是不同的問題:3.6 由一項尚未執行的測試涵蓋。
在整份規格中,同樣的檢查找到六項有缺口的末端需求:2.5 Safe Mode Recovery、3.5 與 6.4 Operator Interface 既沒有被滿足也沒有被驗證,而 1.5 Daily Collection Volume、4.4 Downlink Encryption 與 6.5 Planning Cycle Time 已被滿足但沒有被驗證。1.6 Revisit Time 沒有自己的測試,但不算缺口:它是父項,透過 1.6.1 與 1.6.2 獲得涵蓋。在電源部分之外,S-1 Spare Reaction Wheel 完全沒有關聯,是一個有正當理由的典型孤立項目(供整合使用的飛行備品),但仍值得做出一個記錄在案的決定。零件 1.2.1 Reaction Wheel Assembly 與 1.2.2 Star Tracker 沒有直接滿足任何需求,但執行了滿足需求的功能,因此是間接追溯;只看直接關聯的檢查會誤把它們當成孤立項目。
變更影響:3.1 從 28 W 變為 30 W
初步設計審查之後,軌道平均負載增加到 26 W,因此 3.1 從 28 W 提高到 30 W,以保持 15% 的裕度。關聯使六個項目變成可疑:1.3.1 Solar Arrays、F3 Generate and Store Power、F3.1 Convert Sunlight to Power、EQ-1.1 Solar Power Generation、EQ-1.4 Power Margin Check 與 TC-06 Solar Array Power Test。TC-06 的通過不會延續:依 EQ-1.3,75.1 W 的峰值只得出 27.9 W 的軌道平均功率,低於 30 W。上面找到的孤立項目 EQ-1.3 則完全沒有被標示。變更影響分析指南 逐步追蹤這項變更,從變更請求一直到結案的紀錄。
下載可追溯性表格與檢查清單
- EO-1 需求可追溯性矩陣(CSV):變更後 SRS-001 的全部 32 項需求,每項一列,包含狀態、來源、父項與子項、derived from 與 derived by、refined by(本模型未使用)、satisfied by(功能、元件、其他)、含測試狀態的 verified by、涵蓋判定,以及 3.1 上的六條可疑關聯。它由示範模型產生,因此與上面的矩陣一致。需要 N1 到 N3 是 Statement 而不是需求,因此不在其中。
- 含 EO-1 改寫前後範例的需求品質檢查清單(CSV):來自 撰寫良好需求指南 的完整檢查清單,可在審查中使用。
需求品質檢查清單
可追溯性取決於兩端陳述的品質。含糊的需求無法分配或驗證,因此會顯示為涵蓋缺口;沒有理由的需求,在可疑標示詢問下游項目是否仍然成立時,就無從判斷。EO-1 規格刻意包含三項薄弱的需求:2.5 Safe Mode Recovery(「should recover … quickly … as appropriate」)、3.5 Battery Thermal Control(「warm enough (TBD)」)與 6.4 Operator Interface(「user friendly and/or easy to use」);3.5 也是上面矩陣中的涵蓋缺口。對追溯最重要的檢查是:每個陳述一項義務、含條件的可量測數值、記錄在案的理由、向上的關聯,以及具有由陳述推導出之準則的驗證方法。撰寫良好需求指南 提供完整的檢查清單,以及這三項的改寫前後對照。
常見錯誤
| 錯誤 | 出了什麼問題 | 較好的做法 |
|---|---|---|
| 關聯氾濫:將看起來相關的一切都關聯起來 | 每次變更都會標示數十個項目,審查者不再閱讀標示,而影響分析會顯示整個模型。 | 只關聯真實存在、且在變更後會有人審查的關係。使用最具體的關聯類型。 |
| 分析缺少關聯 | 計算需求數值的方程式與預算,在需求變更時不會被標示(上面的 EQ-1.3)。 | 將每項分析關聯到其計算或檢查數值的需求。 |
| 無法追溯的「shall」文字:埋在規格段落中的需求 | 一個句子無法單獨被關聯、計數或標示。同一段落中的兩個「shall」命運相同。 | 每個項目一項需求,具有自己的識別碼,每個陳述一個「shall」。 |
| 追溯到文件而不是項目 | 「3.4 is satisfied by the EPS Design Description」沒有說明是設計的哪一部分,而且無論文件如何變更,這條關聯都會存留。 | 追溯到功能、元件、介面或測試案例。如果文件描述了這些項目,就將文件關聯到它們。 |
| 所有關係都使用單純的追溯 | 涵蓋檢查尋找的是滿足與驗證關聯,因此會回報不存在的缺口,或漏掉真正的缺口。 | 一般追溯只保留給需要與尚未確定的關聯;在適用之處使用 derive、satisfy 與 verify。 |
| 追溯父項而不是末端項目 | 父項與其子項上有重複的關聯,而在某個子項缺少時,涵蓋率看起來卻是完整的。 | 分配並驗證末端需求;父項透過它們獲得涵蓋,就像 1.6 透過 1.6.1 與 1.6.2 一樣。 |
| 未經審查就大量清除可疑標示 | 紀錄聲稱了一次並未發生的審查。 | 清除時為每個項目,或為一起審查的每組項目,附上簡短理由。 |
| 只在最後追溯一次 | 為了稽核而憑記憶重建關聯,會漏掉過程中發生的變更。 | 在撰寫需求與設計時就建立關聯,並在每個里程碑審查缺口。 |
關於驗證
verify 關聯回答的是需求是否由某項驗證活動涵蓋;它不說明需求是否已被滿足。那來自活動的結果:TC-04 Pointing Accuracy Test 驗證 2.1,結果未通過。為每項需求規劃方法(測試、分析、檢驗或示範)、執行活動,並沿著需求階層彙總結果,是 需求驗證矩陣 的工作。驗證活動也可以是分析或模擬;MBSE 範例以成像過境的模擬估計 6.5 Planning Cycle Time,而 蒙地卡羅指南 說明如何解讀這類結果。這裡描述的追溯關聯就是它的輸入。
在 Holarch 中試試看
在 LML 專案中,每條追溯都是兩個實體之間的關係,在一處建立的關聯會出現在屬性面板、矩陣、Spider 圖與 Requirement 圖以及 RVTM 中。
- 以 管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程) 建立示範專案。其規格中已含有 3.1 的變更與六個可疑連結。
- 開啟 驗證 → 可追溯性矩陣。按一下 列 標籤並設定查詢
class:Requirement AND number:3.*;按一下 欄 標籤並設定查詢,例如class:Action OR class:TestCase。 - 勾選 僅缺口,查看沒有關聯的列。選擇一種關係,例如 satisfied by,然後按一下空白儲存格建立關聯,例如從 EQ-1.3 到 3.1。
- 開啟 需要與需求 → 待檢查的連結,在某一列按一下 差異,然後使用 標記為已審查… 並附上留言。
- 在矩陣中按一下 匯出…,將網格匯出為 Excel 或 CSV。
驗證 → 模型檢查 會列出未分配或未驗證的末端需求,而實體的 開啟位置 ▾ → Spider 會在變更之前執行影響分析。完整參考資料位於 可追溯性,可疑關聯規則則位於 待檢查的連結。
下一步
- Holarch 中的需要與需求:在同一個模型中處理文件、品質檢查、基準線與可追溯性。
- 可追溯性說明文件:關係類型、可追溯性矩陣、Spider 圖與涵蓋檢查。
- 需求說明文件:撰寫、核准需求並為其建立基準線,以及待檢查的連結頁面。