Holarch

指南 · 需求

需求可追溯性與變更影響:關聯需要、需求、設計與測試

收聽本指南 27 分鐘

需求可追溯性是一份紀錄,說明每項需求從何而來、設計中有什麼實現它,以及有什麼顯示它已被滿足。它最主要的回報是變更影響:當需求變更時,關聯會告訴您有哪些東西必須重新檢查。本指南涵蓋追溯關聯的類型與方向、向前與向後追溯、涵蓋缺口與孤立項目、可疑關聯以及可追溯性矩陣,並以一個 CubeSat 模型為完整範例。

本頁內容
  1. 什麼是需求可追溯性
  2. 為什麼要追溯需求:首先是變更影響
  3. 需要與需求
  4. 追溯關聯的種類
    1. 方向
  5. 向前與向後可追溯性
  6. 涵蓋缺口與孤立項目
  7. 變更後的可疑關聯
  8. 可追溯性矩陣
  9. 完整範例:EO-1 CubeSat
    1. 需要與需求
    2. 電源需求的關聯
    3. 解讀矩陣:一個缺口與一個孤立項目
    4. 變更影響:3.1 從 28 W 變為 30 W
    5. 下載可追溯性表格與檢查清單
  10. 需求品質檢查清單
  11. 常見錯誤
  12. 關於驗證
  13. 在 Holarch 中試試看
  14. 下一步

什麼是需求可追溯性

需求很少單獨存在。它回應某個利害關係人需要,可能被展開為較低層級的需求,由某個功能或元件執行,並由某項測試或分析檢查。可追溯性就是這些項目之間一組明確、有紀錄的關聯。每條關聯都指明其兩端,並說明關係是什麼:「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 將這些列為 待檢查的連結。

清除可疑關聯是一次小型審查:

  1. 閱讀變更了什麼:舊的與新的文字,或是變動的屬性。
  2. 檢查下游端的項目。衍生需求是否仍然成立?元件是否仍然實現該需求?測試是否仍然檢查新的數值?
  3. 如果仍然成立,清除標示並記錄原因,例如「Function text has no power value; no change needed.」
  4. 如果不再成立,變更下游項目(或對它提出變更),然後清除標示。如果關聯本身已不再正確,就移除它。

紀錄與決定同樣重要。附有留言與姓名而清除的可疑關聯,是給下一次審查的證據,證明變更已被追蹤到底;未經查看就大量清除的標示比沒有標示更糟,因為它聲稱了一次並未發生的審查。

並非每次編輯都需要產生標示。修正需求名稱中的錯字,不應該讓二十個項目進入審查;而將功率位準從 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 RevisitFarm 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 PowerF3、F3.11.3.1 Solar ArraysEQ-1.1 Solar Power Generation、EQ-1.4 Power Margin CheckTC-06 Solar Array Power Test(通過)
3.2 Battery CapacityF3、F3.21.3.2 Battery PackTC-07 Battery Capacity Test(通過)
3.3 Depth of DischargeF3、F3.3EQ-1.2 Battery Depth of Discharge、OPS.10、IF-21TC-07 Battery Capacity Test(通過)
3.4 Bus RegulationF3、F3.31.3.3 Power Distribution UnitIF-01 到 IF-04、IF-20、IF-22(電源線)TC-18 Bus Regulation Inspection(通過)
3.5 Battery Thermal Control(無)(無)(無)(無)
3.6 Array DeploymentF2 Deploy Solar Arrays1.6 Structure and ThermalIF-19 Deployment Switch HarnessTC-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 規格刻意包含三項薄弱的需求: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 中。

  1. 以 管理專案 → 專案檔案 ▾ → 新增示範專案 → CubeSat(引導式系統工程) 建立示範專案。其規格中已含有 3.1 的變更與六個可疑連結。
  2. 開啟 驗證 → 可追溯性矩陣。按一下 列 標籤並設定查詢 class:Requirement AND number:3.*;按一下 欄 標籤並設定查詢,例如 class:Action OR class:TestCase。
  3. 勾選 僅缺口,查看沒有關聯的列。選擇一種關係,例如 satisfied by,然後按一下空白儲存格建立關聯,例如從 EQ-1.3 到 3.1。
  4. 開啟 需要與需求 → 待檢查的連結,在某一列按一下 差異,然後使用 標記為已審查… 並附上留言。
  5. 在矩陣中按一下 匯出…,將網格匯出為 Excel 或 CSV。

驗證 → 模型檢查 會列出未分配或未驗證的末端需求,而實體的 開啟位置 ▾ → Spider 會在變更之前執行影響分析。完整參考資料位於 可追溯性,可疑關聯規則則位於 待檢查的連結。

下一步