軟件需求規(guī)格說明編寫指南(438B)

密級： （軟件項目名稱）軟件需求規(guī)格說明 標 識： 版 本：頁 數(shù)：擬 制：SQA審核：審 核：批 準：擬制部門：XXXXXXXXXX研究所年月日修改文檔歷史記錄：日 期版本說 明修改人目 錄1 范圍11.1 標識11.2 系統(tǒng)概述11.3 文檔概述12 引用文檔13 需求13.1 要求的狀態(tài)和方式13.2 CSCI能力需求43.2.X（CSCI能力）43.3 CSCI外部接口需求53.3.1 接口標識和接口圖53.3.X（接口的項目唯一的標識符）53.4 CSCI內(nèi)部接口需求73.5 CSCI內(nèi)部數(shù)據(jù)需求83.6 適應(yīng)性需求93.7 安全性需求93.8 保密性需求93.9 CSCI環(huán)境需求103.10 計算機資源需求103.10.1 計算機硬件需求103.10.2 計算機硬件資源使用需求103.10.3 計算機軟件需求103.11 軟件質(zhì)量因素113.12 設(shè)計和實現(xiàn)約束113.13 人員需求113.14 培訓(xùn)需求123.15 后勤保障需求123.16 其它需求123.17 驗收、交付和包裝需求（修改有關(guān)內(nèi)容）123.18 需求的優(yōu)先順序和關(guān)鍵程度124 合格性規(guī)定125 需求可追蹤性136 注釋131 范圍1.1 標識【本條應(yīng)描述本文檔所適用的系統(tǒng)和軟件的完整標識，適用時，包括其標識號、名稱、縮略名、版本號及發(fā)布號?！渴纠合到y(tǒng)標識如下：a) 已批準的標識號：b) 產(chǎn)品名稱：XXXXXXc) 產(chǎn)品代號：XXXXXXd) 版本號：XXXXXe) 縮略名：1.2 系統(tǒng)概述【本條應(yīng)概述本文檔所適用的系統(tǒng)和軟件的用途。它還應(yīng)描述系統(tǒng)與軟件的一般特性；概述系統(tǒng)開發(fā)、運行和維護的歷史；標識項目的需方、用戶、開發(fā)方和保障機構(gòu)；標識當(dāng)前和計劃的運行現(xiàn)場；列出其它有關(guān)文檔?！渴纠篴) 軟件用途：b) 系統(tǒng)概述：c) 需方：XXXXX d) 開發(fā)方：軟件開發(fā)組e) 運行環(huán)境：XXXXXf) 相關(guān)文檔：以下描述相關(guān)技術(shù)數(shù)據(jù)內(nèi)容:1) 軟件開發(fā)計劃2) 軟件研制任務(wù)書3) 。1.3 文檔概述【本條應(yīng)概述文檔的用途和內(nèi)容，并描述與它的使用有關(guān)的保密性方面的要求?！? 引用文檔【本章應(yīng)列出引用文檔的編號、標題、編寫單位、修訂版及日期，還應(yīng)標識所有不能通過正常采購活動得到的文檔的來源?！? 需求3.1 要求的狀態(tài)和方式【如果要求CSCI在多種狀態(tài)或多種方式下運行，并且不同的狀態(tài)或方式具有不同的需求，則應(yīng)標識和定義每一種狀態(tài)和方式。狀態(tài)和方式的例子包括：空閑、就緒、活動、事后分析、訓(xùn)練、降級、緊急情況、備份、戰(zhàn)時和平時等。可以僅用狀態(tài)描述CSCI，也可僅用方式、用方式中的狀態(tài)、狀態(tài)中的方式、或其他有效的方式描述CSCI。如果不需要多種狀態(tài)或方式，應(yīng)如實陳述，而不需要進行人為的區(qū)分；如果需要多種狀態(tài)和/或方式，應(yīng)使本規(guī)格說明中的每個或每組需求與這些狀態(tài)和方式相對應(yīng)，對應(yīng)關(guān)系可以在本條或本條所引用的附錄中，通過表格或其它方式加以指明，也可以在該需求出現(xiàn)的章條中加以聲明?！渴纠?.2 CSCI能力需求【為詳細說明與CSCI各個能力相關(guān)的需求，本條可分為若干子條?！癈SCI能力需求”中的“能力”為一組相關(guān)需求，可用“功能”、“主題”、“對象”、或其他適合表示需求的詞替代。】示例：3.2.X（CSCI能力）【本條應(yīng)標識必需的每一個CSCI能力，并詳細說明與該能力有關(guān)的需求。如果該能力可以更清晰地分解成若干子能力，則應(yīng)分條對子能力進行說明。需求應(yīng)詳細說明所需的CSCI行為，包括適用的參數(shù)，如響應(yīng)時間、吞吐時間、其它時限約束、時序、精度、容量、優(yōu)先級、連續(xù)運行需求和在基本運行條件下允許的偏差；適當(dāng)時，需求還應(yīng)包括在異常條件、非許可條件或超限條件下所需的行為，錯誤處理需求和任何為保證在緊急時刻運行的連續(xù)性而引入到CSCI中的規(guī)定。在確定與CSCI所接收的輸入和CSCI所產(chǎn)生的輸出有關(guān)的需求時，應(yīng)考慮在3.3.X給出的要考慮的主題列表?！?* 此段引用G B_T 計算機軟件文檔編制規(guī)范 8567-2006對于每一類功能或者對于每一個功能，需要具體描寫其輸入、處理和輸出的需求。a. 說明描述此功能要達到的目標、所采用的方法和技術(shù)，還應(yīng)清楚說明功能意圖的由來和背景。b. 輸入包括：1） 詳細描述該功能的所有輸入數(shù)據(jù)，如：輸入源、數(shù)量、度量單位、時間設(shè)定和有效輸入范圍等。2） 指明引用的接口說明或接口控制文件的參考資料。c. 處理定義對輸入數(shù)據(jù)、中間參數(shù)進行處理以獲得預(yù)期輸出結(jié)果的全部操作。包括：1） 輸入數(shù)據(jù)的有效性檢查。2） 操作的順序，包括事件的時間設(shè)定。3） 異常情況的響應(yīng)，例如溢出、通信故障、錯誤處理等。4） 受操作影響的參數(shù)。5） 用于把輸入轉(zhuǎn)換成相應(yīng)輸出的方法。6） 輸出數(shù)據(jù)的有效性檢查。d. 輸出1） 詳細說明該功能的所有輸出數(shù)據(jù)，例如，輸出目的地、數(shù)量、度量單位、時間關(guān)系、有效輸出范圍、非法值的處理、出錯信息等。2） 有關(guān)接口說明或接口控制文件的參考資料。*/示例：【CSU1】功能描述模塊名稱項目唯一標識號模塊用途物理/數(shù)學(xué)模型模塊實現(xiàn)功能模塊性能要求子模塊名稱對應(yīng)的分配需求容錯設(shè)計需求模塊輸入輸出輸入輸出名稱類型用途3.3 CSCI外部接口需求【本條可分為若干個小條來規(guī)定關(guān)于CSCI的外部接口的需求（若有）。本條可引用一個或多個接口需求規(guī)格說明（IRS）或包含這些需求的其它文檔?！?.3.1 接口標識和接口圖【本條應(yīng)標識所需要的CSCI外部接口（即，與涉及共享、提供或交換數(shù)據(jù)的其它實體的關(guān)系）。每一個接口的標識應(yīng)包括項目唯一的標識符，（若適用）應(yīng)通過名稱、編號、版本、引用文檔來指明接口實體（系統(tǒng)、配置項、用戶等）。該標識應(yīng)聲明哪些實體具有固定的接口特性（要給出這些接口實體的接口需求）；說明哪些實體正在開發(fā)或修改之中（這些實體已有各自的接口需求）。應(yīng)該通過一張或多張接口圖來描述這些接口?！?.3.X（接口的項目唯一的標識符）【本條（從3.3.2開始）應(yīng)通過項目唯一標識符來標識CSCI外部接口，應(yīng)簡要地標識接口實體。視需要可分小條描述為實現(xiàn)該接口提出的該CSCI的需求。該接口所涉及的其它實體的接口特性應(yīng)作為假定予以描述，或以“當(dāng)未涵蓋的實體這么做時，本CSCI應(yīng)該”的形式加以敘述，而不作為針對其它實體的需求。本條可引用其它文檔（例如數(shù)據(jù)字典、通信協(xié)議標準、用戶接口標準）代替在此所描述的信息。（若適用）需求應(yīng)包括如下內(nèi)容，并以任何適合于需求的順序給出，還應(yīng)從接口實體的角度說明這些特性之間的區(qū)別（例如對數(shù)據(jù)元素的大小、頻率或其它特性的不同期望值）：a）CSCI必須分配給該接口的優(yōu)先級；b）對要實現(xiàn)的接口類型的要求（例如實時數(shù)據(jù)傳送、數(shù)據(jù)的儲存和檢索等）；c）CSCI必須提供、儲存、發(fā)送、存取、接收的各個數(shù)據(jù)元素所要求的特性，例如：1) 名稱/標識符：（1）項目唯一的標識符；（2）非技術(shù)（自然語言）名稱；（3）數(shù)據(jù)元素名稱；（4）技術(shù)名（如在代碼或數(shù)據(jù)庫中的變量名或字段名）；（5）縮略名或同義名。2) 數(shù)據(jù)類型（字母數(shù)字、整數(shù)等）；3) 大小和格式（如：字符串的長度和標點符號）；4) 計量單位（如：m等）；5) 可能值的范圍或枚舉（如：0-99）；6) 準確性（正確程度）和精度（有效數(shù)字位數(shù)）；7) 優(yōu)先級別、定時、頻率、容量、序列以及其他約束條件（例如數(shù)據(jù)元素是否可以被更新、業(yè)務(wù)規(guī)則是否適用）；8) 保密性約束；9) 來源（設(shè)置/發(fā)送實體）和接收者（使用/接收實體）。d）CSCI必須提供、存儲、發(fā)送、訪問、接收的數(shù)據(jù)元素組合體（記錄、消息、文件、數(shù)組、顯示、報表等）所要求的特性，例如：1) 名稱/標識符：（1）項目唯一的標識符；（2）非技術(shù)（自然語言）名稱；（3）技術(shù)名稱（如在代碼或數(shù)據(jù)庫中的記錄名或數(shù)據(jù)結(jié)構(gòu)名）；（4）縮略名或同義名。2) 包中的數(shù)據(jù)元素及其結(jié)構(gòu)（編號、順序和成組情況）；3) 介質(zhì)（例如磁盤）以及在介質(zhì)上數(shù)據(jù)元素/包的結(jié)構(gòu)；4) 顯示和其它輸出的視聽特性（例如顏色、布局、字體、圖標和其它顯示元素、峰鳴音和亮度）；5) 包之間的關(guān)系，如排序/存取特性；6) 優(yōu)先級、時序、頻率、容量、序列及其它約束，例如包是否可以被更新、業(yè)務(wù)規(guī)則是否適用；7) 保密性約束；8) 來源（設(shè)置/發(fā)送實體）和接收者（使用/接收實體）。e）CSCI必須使用的接口的通信方法所要求的特性。如：1) 項目唯一的標識符；2) 通信鏈接/帶寬/頻率/介質(zhì)及其特性；3) 消息格式；4) 流控制（如：序列編號和緩沖區(qū)分配）；5) 周期/非周期傳送的數(shù)據(jù)傳送速率，傳輸間隔 ；6) 路由、尋址、命名約定；7) 傳輸服務(wù)，包括：優(yōu)先權(quán)和等級；8) 安全性/保密性考慮，如：加密、用戶鑒別、隔離和審核。f）CSCI必須使用的接口的協(xié)議所要求的特性，如：1) 項目唯一的標識符；2) 協(xié)議的優(yōu)先級別/層次；3) 打包，包括拆包和重新打包、路由和尋址；4) 合法性檢查、錯誤控制和恢復(fù)過程；5) 同步，包括建立連接、保持和終止；6) 狀態(tài)、標識及任何其它報告的特性。g）其它所需要的特性，例如接口實體的物理兼容性（尺寸、公差、負載和接插件的兼容性等）、電壓等?！渴纠罕鞽 外部接口標識接口名稱接口標識號接口簡述接口文檔來源文檔名稱章節(jié)號注：接口文檔來源填入相應(yīng)定義該接口的文件資料，可填寫多個。3.4 CSCI內(nèi)部接口需求【本條應(yīng)描述施加于CSCI內(nèi)部接口的需求（若有）。如果所有內(nèi)部接口都留待設(shè)計時再描述，那么應(yīng)在此如實陳述。如果指定了這樣的需求，應(yīng)考慮本文檔的3.3條中描述的主題?！渴纠喉攲幽K內(nèi)部接口描述接口名稱接口項目唯一標識號接口簡述接口傳遞的信息概述例：敵我目標設(shè)別內(nèi)部接口示意圖表x 【功能模塊名】內(nèi)部接口描述接口名稱接口項目唯一標識號接口簡述接口傳遞的信息概述3.5 CSCI內(nèi)部數(shù)據(jù)需求【本條應(yīng)描述施加于CSCI內(nèi)部數(shù)據(jù)的需求（若有），包括對CSCI中數(shù)據(jù)庫和數(shù)據(jù)文件的需求（若有）。如果關(guān)于內(nèi)部數(shù)據(jù)的所有決策都留待設(shè)計時再考慮，那么應(yīng)在此如實陳述。如果施加了這樣的需求，那么本文檔的3.3.X c）和3.3.X d）條應(yīng)列出需考慮的主題?！渴纠篊SCI數(shù)據(jù)消息數(shù)據(jù)消息描述數(shù)據(jù)消息描述項目唯一標識號名稱項目唯一標識號名稱項目唯一標識號CSCI數(shù)據(jù)元素CSCI數(shù)據(jù)元素要求數(shù)據(jù)元素描述數(shù)據(jù)元素格式數(shù)據(jù)元素長度測量單位極限值/值域精確度精度/分辨率名稱項目唯一標識號3.6 適應(yīng)性需求【本條應(yīng)描述關(guān)于CSCI將提供的與安裝有關(guān)的數(shù)據(jù)（如場地的經(jīng)緯度或場地所在地的賦稅代碼）的需求（若有），應(yīng)指定對要求CSCI使用的運行參數(shù)（如指明與運行有關(guān)的目標常數(shù)或數(shù)據(jù)記錄的參數(shù)）的需求，這些運行數(shù)可以根據(jù)運行需要而改變?！?.7 安全性需求【本條應(yīng)描述關(guān)于防止或盡可能降低對人員、財產(chǎn)和物理環(huán)境產(chǎn)生意外危險的CSCI需求（若有）。例子包括：CSCI必須提供的安全措施，以便防止意外動作（例如意外地發(fā)出一個“自動導(dǎo)航關(guān)閉”命令）和無動作（例如發(fā)出“自動導(dǎo)航關(guān)閉”命令失?。?。本條還應(yīng)包括關(guān)于系統(tǒng)的核部件的CSCI需求（若有），若適用應(yīng)包括預(yù)防意外爆炸以及與核安全規(guī)則保持一致等方面的需求?！渴纠罕鞽 CSCI的安全性需求CSCI的安全性需求綜述CSCI的功能模塊名稱安全性等級安全需求描述安全需求指標注:a) 用文字或上表描述可能為避免人員、財產(chǎn)和物理環(huán)境等潛在危害的安全需求指標；b) 如有必要，對核心或有要求的功能模塊要逐個給出其安全性描述。3.8 保密性需求【本條應(yīng)描述與維護保密性有關(guān)的CSCI需求（若有）。（若適用）這些需求應(yīng)包括：CSCI必須在其中運行的保密性環(huán)境、所提供的保密性的類型和級別、CSCI 須經(jīng)受的保密性風(fēng)險、減少此類風(fēng)險所需的安全措施、必須遵循的保密性政策、CSCI必須具備的保密性責(zé)任、保密性認證/認可必須滿足的準則等?！渴纠罕鞽 保密性需求CSCI保密性需求綜述CSCI的功能模塊名稱保密性需求注：a) 用文字或上表描述為避免敏感數(shù)據(jù)可能的丟失所作的保密性需求設(shè)計；b) 如有必要，對有要求的功能模塊要逐個給出其保密性需求描述。3.9 CSCI環(huán)境需求【本條應(yīng)描述CSCI的運行環(huán)境需求（若有）。如在其上運行CSCI的計算機硬件和操作系統(tǒng)。（對計算機資源的其它需求見3.10）?！渴纠罕鞽 環(huán)境要求資源名稱用途硬件/軟件配置說明3.10 計算機資源需求3.10.1 計算機硬件需求【本條應(yīng)描述針對本CSCI必須使用的計算機硬件的需求（若有）。（若適合）這些需求應(yīng)包括：各類設(shè)備的數(shù)量；處理機、存儲器、輸入/輸出設(shè)備、輔助存儲器、通信/網(wǎng)絡(luò)設(shè)備及所需其它設(shè)備的類型、大小、容量和其它所需的特性?！渴纠罕鞽 計算機硬件設(shè)備名稱數(shù)量配置名稱硬件配置說明3.10.2 計算機硬件資源使用需求【本條應(yīng)描述本CSCI的計算機硬件資源使用需求（若有），例如：最大允許利用的處理機能力、內(nèi)存容量、輸入/輸出設(shè)備的能力、輔助存儲設(shè)備容量和通信/網(wǎng)絡(luò)設(shè)備的能力。這些需求（例如陳述為每一個計算機硬件資源能力的百分比）應(yīng)包括測量資源使用時所處的條件（若有）?！渴纠罕鞽 硬件資源使用要求硬件名稱硬件用途硬件配置要求3.10.3 計算機軟件需求【本條應(yīng)描述本CSCI必須使用或必須被并入本CSCI的計算機軟件的需求（若有）。例子包括：操作系統(tǒng)、數(shù)據(jù)庫管理系統(tǒng)、通信/網(wǎng)絡(luò)軟件、實用軟件、輸入和設(shè)備仿真軟件、測試軟件和制造軟件。要列出每一個這樣的軟件項的正確名稱、版本和參考文檔?！渴纠罕鞽 軟件要求軟件名稱軟件用途軟件說明版本號參考文檔3.10.4 計算機通信需求【本條應(yīng)描述本CSCI必須使用的計算機通信方面的需求（若有）。例子包括：要連接的地理位置；配置和網(wǎng)絡(luò)拓撲；傳輸技術(shù)；數(shù)據(jù)傳送速率；網(wǎng)關(guān)；要求的系統(tǒng)使用時間；被傳送/接收的數(shù)據(jù)的類型和容量；傳送/接收/響應(yīng)的時間限制；數(shù)據(jù)量的峰值；以及診斷特性?！渴纠罕鞽 （外部接口名稱）通信協(xié)議通信協(xié)議名稱通信協(xié)議標識通信協(xié)議實現(xiàn)描述3.11 軟件質(zhì)量因素【本條應(yīng)描述合同（或軟件任務(wù)書）規(guī)定的或由較高一級規(guī)格說明派生出的軟件質(zhì)量因素方面的CSCI需求（若有）。例子包括有關(guān)CSCI功能性、可靠性、易用性、效率、維護性、可移植性和其它屬性的定量要求?！?.12 設(shè)計和實現(xiàn)約束【本條應(yīng)描述約束CSCI的設(shè)計和實現(xiàn)的那些需求（若有）。這些需求可引用相應(yīng)的商用或軍用標準和規(guī)范來指定。例子包括關(guān)于以下各方面的需求：a）使用一個特定的CSCI體系結(jié)構(gòu)，或針對體系結(jié)構(gòu)的要求，例如所要求的數(shù)據(jù)庫或其它軟件單元；使用標準的或現(xiàn)有的部件；或使用由政府/需方提供的資源（設(shè)備、信息或軟件）。b）使用特定的設(shè)計或?qū)崿F(xiàn)標準；使用特定的數(shù)據(jù)標準；使用特定的編程語言。c) 為支持在技術(shù)、威脅或使命方面預(yù)期的增長或變化，必須提供的靈活性和可擴展性?！渴纠罕鞽 設(shè)計約束CSCI設(shè)計約束綜述CSCI的功能模塊名稱設(shè)計約束注：a) 用文字或上表指明約束CSCI 設(shè)計的其他要求，如使用特殊的處理器配置等；b) 如有必要，對有要求的功能模塊要逐個給出其設(shè)計約束。3.13 人員需求【本條應(yīng)描述與使用或支持本CSCI的人員有關(guān)的CSCI需求（若有），包括人員的數(shù)量、技術(shù)水平、責(zé)任期限、培訓(xùn)要求或其它信息。例子包括要求允許多少用戶同時工作，以及嵌入的幫助和培訓(xùn)方面的需求；還應(yīng)包括施加于CSCI的人素工程需求（若有）。（適用時）這些需求應(yīng)包括對人的能力和局限性的考慮，在正常和極端條件下可預(yù)見的人為錯誤，以及人為錯誤影響特別嚴重的那些特定場合。例子包括對出錯消息的顏色和持續(xù)時間的要求、對關(guān)鍵指示器或按鈕的物理位置的要求，以及對聽覺信號的使用要求?！?.14 培訓(xùn)需求【本條應(yīng)描述與培訓(xùn)有關(guān)的CSCI需求（若有）?！?.15 后勤保障需求【本條應(yīng)描述與軟件保障考慮有關(guān)的CSCI需求(若有)。這些考慮可以包括：對系統(tǒng)維護、軟件保障、系統(tǒng)運輸方式、補給系統(tǒng)的要求、對現(xiàn)有設(shè)施的影響和對現(xiàn)有設(shè)備的影響?！?.16 其它需求【本條應(yīng)描述上述各條未能覆蓋的其它CSCI需求（若有）?！?.17 驗收、交付和包裝需求（修改有關(guān)內(nèi)容）【本條應(yīng)描述為了交付而對CSCI進行包裝、加標記和處理（例如用8道磁帶提交，該磁帶以確定的方式加以包裝并貼上標簽）的需求（若有）。（若適用）可引用適當(dāng)?shù)臉藴省！?.18 需求的優(yōu)先順序和關(guān)鍵程度【本條（若適用）應(yīng)描述本文檔中諸需求的優(yōu)先順序、關(guān)鍵程度、或所賦予的指明其相對重要性的權(quán)值。例子包括，指明那些被認為對安全性或保密性至關(guān)重要的需求，以便將這些需求作特殊處理。如果全部需求同等重要，本條應(yīng)如實陳述?！? 合格性規(guī)定【本條應(yīng)描述所定義的合格性方法，并為第3章中的每個需求指定為確保需求得到滿足所要使用的方法。可用表格形式表述該信息，或為第3章中的每個需求注明所使用的方法。合格性方法可以包括：a）演示：不需要使用儀器、專用測試設(shè)備或進行事后分析，而是依靠可見的功能操作，直接運行本CSCI或本CSCI的一部分。b）測試：使用儀器或其