需求分析報告編寫規(guī)范
需求分析報告編寫規(guī)范 |文件編號： |生效日期： |受控編號： | |NW503101 |2000.3.20 | | |密級：秘密 |版次：Ver2.1 |修改狀態(tài)： | |總頁數 |16 |正文 |4 |附錄 |12 | |編制：楊利 |審核：袁淮 |批準：孟莉 | 沈陽東大阿爾派軟件股份有限公司 （版權所有，翻版必究） 文件修改控制 |修改記錄編號 |修改 |修改頁碼及條款 |修改人|審核人|批準人|修改日期 | | |狀態(tài) | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 目錄 1. 目的 2. 適用范圍 3. 術語及縮略語 4. 編寫規(guī)范 4.1 排版規(guī)范 4.2 模板使用 5. 引用文件 5.1 NW503102《軟件功能規(guī)格說明書編寫規(guī)范》 6. 附錄 目的 為使需求分析的結果能夠完整、無遺漏地反映待開發(fā)系統的要求，本文件規(guī)定《需求 分析報告》的編寫格式和內容要求。 適用范圍 適用于本公司軟件產品或軟件項目的需求分析報告的編制。 術語及縮略語 本程序采用NQ402100《質量手冊》中的術語和縮略語及其定義。 編寫規(guī)范 4.1 排版規(guī)范 1. 整個規(guī)范由2節(jié)構成，模板單獨一節(jié)。 2. 正文樣式采用“規(guī)范正文”。 3. 標題編號采用每節(jié)獨立編號。 4.2 模板使用 需求分析報告的編寫可依據具體情況選用摸板的格式或編寫指南的格式。 1. 拷貝規(guī)范。 2. 刪除第一節(jié)（需求分析報告封面前的所有頁）。 3. 在修改完內容后，更新目錄域和相關的頁數域。 引用文件 5.1 NW503102《軟件功能規(guī)格說明書編寫規(guī)范》 附錄 以下部分為需求分析報告的模板與編寫指南。 密級：機密 文檔編號： 第 版 分冊名稱： 第 冊/共 冊 項目名稱（項目編號） 需求分析報告 （部門名稱） 沈陽東大阿爾派軟件股份有限公司 |總頁數| |正文 | |附錄 | |生效日期： 年 月 日| |編制： |審核： |批準： | 目錄 1. 引言 1 1.1 編寫目的 1 1.2 背景 1 1.3 參考資料 1 1.4 術語 1 2. 任務概述 1 2.1 目標 1 2.2 系統（或用戶）的特點 1 3. 假定和約束 2 4. 需求規(guī)定 2 4.1 軟件功能說明 2 4.2 對功能的一般性規(guī)定 2 4.3 對性能的一般性規(guī)定 2 4.4 其他專門要求 2 4.5 對安全性的要求 2 5. 運行環(huán)境規(guī)定 2 5.1 設備及分布 2 5.2 支撐軟件 2 5.3 接口 1 5.4 程序運行方式 1 6. 開發(fā)成本估算 1 7. 尚需解決的問題 1 8. 附錄 1 引言 9.1 目的 說明編寫這份報告的目的，指出預期的讀者。 9.2 背景 指出待開發(fā)的軟件系統的名稱；行業(yè)情況；本項目的任務提出者、開發(fā)者、用戶；該 軟件系統同其他系統或其他機構的基本的相互來往關系。 9.3 參考資料 列出編寫本報告時參考的文件(如經核準的計劃任務書或合同、上級機關的批文等)、 資料、技術標準，以及他們的作者、標題、編號、發(fā)布日期和出版單位。 |編號 |資料名稱 |簡介 |作者 |日期 |出版單位 | | | | | | | | 列出編寫本報告時查閱的Intenet上雜志、專業(yè)著作、技術標準以及他們的網址。 |網點 |簡介 | | | | 9.4 術語 列出本報告中用到的專門術語的定義。 任務概述 10.1 目標 敘述該項軟件開發(fā)的意圖、應用目標、作用范圍以及其他應向讀者說明的有關該軟件 開發(fā)的背景材料。解釋被開發(fā)軟件與其他有關軟件之間的關系。如果本軟件產品是一 項獨立的軟件，而且全部內容自含，則說明這一點。如果所定義的產品是一個更大的 系統的一個組成部分，則應說明本產品與該系統中的其他各組成部分之間的關系，為 此可使用一張方框圖來說明該系統的組成和本產品同其他各部分的聯系和接口。 10.2 系統（或用戶）的特點 如果是產品開發(fā)，應列出本軟件的特點，與老版本軟件（如果有的話）的不同之處， 與市場上同類軟件（如果有的話）的比較。說明本軟件預期使用頻度； 如果是針對合同開發(fā)，則應列出本軟件的最終用戶的特點，充分說明操作人員、維護 人員的教育水平和技術專長，以及本軟件預期使用頻度。這些是軟件設計工作的重要 約束。 假定和約束 列出進行本軟件開發(fā)工作的假定和約束，例如經費限制、開發(fā)期限等。 需求規(guī)定 12.1 軟件功能說明 列出本系統中所有軟件功能子系統和功能。如果子系統比較大，每個子系統按照NW4 043102《軟件功能規(guī)格說明書編寫規(guī)范》分別編寫軟件功能規(guī)格說明書，在本處列出編 號和分冊名稱。 12.2 對功能的一般性規(guī)定 本處僅列出對軟件系統的所有功能（或一部分）的共同要求，如要求界面格式統一， 統一的錯誤聲音提示，要求有在線幫助等。 12.3 對性能的一般性規(guī)定 對數據精度、響應時間的要求。本處僅列出對軟件系統的所有功能（或一部分）的共 同要求，針對某一功能的專門性能要求應列在該功能規(guī)格說明中。 12.4 其他專門要求 視具體情況，列出不在本規(guī)范規(guī)定中的需求，如對數據庫的要求，多平臺特性要求， 操作特性要求，場合適應性要求等對一具體軟件系統的所有功能（或一部分）的共同 要求，針對某一功能的專門要求應列在該功能說明中。 12.5 對安全性的要求 指出系統對使用權限的管理要求（使用權限分為幾級、是否與部門權力體系對應等） 、信息加密、信息認證（確定穿過系統或網絡的信息沒有被修改）方面的要求。 運行環(huán)境規(guī)定 13.1 設備及分布 1. 主機類型 2. 網絡類型 3. 存貯器容量 4. 其他特殊設備 5. 設備分布圖 13.2 支撐軟件 1. 操作系統 2. 數據庫管理系統 3. 其他支撐軟件 13.3 接口 簡要說明該軟件同其他軟件之間的公共接口、數據通信協議等，如果外部接口僅與某 子功能有關，該接口說明應列在子功能規(guī)格說明書中。 13.4 程序運行方式 說明該軟件的運行方法。如是部件、還是獨立運行程序、API等。 開發(fā)成本估算 以列表的方式給出各功能規(guī)定所需的開發(fā)人時和費用（如差旅費）。 尚需解決的問題 以列表的形式列出在需求分析階段必須解決但尚未解決的問題 附錄 需求分析過程中會產生各種記錄如調查表格、業(yè)務系統單據等。記錄或報告的存檔編 號和名稱填寫在下表中。其中類別是記錄的分類，一般有業(yè)務系統說明書、業(yè)務系統 數據說明書、業(yè)務系統調查表、原始數據單據、業(yè)務系統參考資料。 |編號 |名稱 |類別 | | | | | | | | | 需求說明書編寫指南 1. Objectives 目標 闡明需求說明書的標準格式，做為合同和需求分析的結果。 2. Scope 范圍 適用于指導需求說明書的編寫。 本模板力圖覆蓋所有可能在需求說明書中出現的主題。這樣做的目的是并不是要求每一 個需求說明書都要包括這里定義的全部章節(jié)，而是提供一個所有需求說明書都應當遵循 的框架。一些特殊的章節(jié)應當提供但不要求有詳細的說明，只需在說明書中包含下面有 適當文字說明的標題即可，例如，不適用。 3. References 參考 4. Outstanding Issues 尚存主要問題 5. Approvals 批準 銷售主管 6. Responsibilities 職責 客戶經理有責任確認本模板被切實執(zhí)行。 7. Template 模板 Lead-in sections 引導部分 7.1.1 以下是需求說明書的起始部分。在文檔格式規(guī)范中有關于它們的更詳細的描述。 1）Objectives目標 2）Scope范圍 3）References參考 4）Assumptions前題條件 5）Outstanding Issues尚存主要問題 6）Document Control文檔控制 7）Approvals批準 8）Distribution分發(fā) 9）Amendment Record更改記錄 10）Traceability可追溯 7.2 Component or System Description 部件或系統描述 本說明書所覆蓋的部件或系統的簡要介紹。本部分可以很簡要，因為它僅包含幫助讀者 快速了解所說明內容的信息。 應當提供一個上下文相關圖來幫助確定被描述的部件或系統的定位。使用USER- CASE圖來描述。 參考應當做成關聯文檔（例如建議，合同，項目編號）。 7.3 Purchaser Requirements 客戶需求 7.3.1 Summary 概要 7.3.1.1 本部分應當包括那些直接影響到客戶使用本部件或系統的需求。它分為兩個部 分，功能和特性。 o 部件或系統的功能描述了什么可以做，例如，打印一個報表。 o 部件或系統的特性提供了那些可以描述和評價系統質量的屬性。 7.3.1.2 每個段落（或段落組）應當包含一個參考來跟蹤需求的出處。每個句子或段落 應當編號；無論何種情況每個編號的項目僅應當定義一個需求。 7.3.1.3 每個段落（或段落組）應當指出它的重要程度，按以下方式分類： 1）強制的：最基本的特征；沒有它產品將不可用。 2）必需的：單獨的非基本的特征，但是它們加在一起會影響產品的能力。 3）期待的：最好能有的特征；一個或多個這些特征被忽略也不會影響產品的 能力。 7.3.2 Purchaser-Related Functionality 客戶要求的功能 7.3.2.1 Application Functionality 應用程序的功能 7.3.2.1.1 在系統或子系統一級，這一部分應當包含可用的應用程序所提供的功能的描述。 7.3.2.1.2 在應用程序一級，這一部分細化應用程序必須做到的功能。 7.3.2.1.3 功能應當用結構化的英語或適當的形式化的方法學來描述。 7.3.2.2 Human Interface 人機界面 7.3.2.2.1 這一部分應當定義所需的菜單結構，屏幕/窗口設計，報表設計和其它操作/或 管理界面。在這一過程中，需求可能廣泛地涉及已有的標準或產品。 7.3.2.2.2 參考應當指向其它的說明書和標準。 7.3.2.3 Data Types 數據類型 這一部分應當包括對系統或應用程序中對用戶有用的所有數據類型的描述，包括應 用程序開發(fā)工具用到的或表單，顯示，報表和輸出用到的。 7.3.2.4 Control Structures 控制結構 這一部分應當描述系統或應用程序的控制結構。 7.3.2.5 Application Development Environment 應用開發(fā)環(huán)境 這部分應當指定可供用戶用來開發(fā)應用程序的系統部件。它應當至少包含數據 類型和語言或者可用的應用程序生成器。 7.3.2.6 Hardware 硬件 這部分應當詳細說明根據用戶需要提出的硬件需求。 7.3.2.7 Software 軟件 本節(jié)將詳細說明因為用戶需要所產生的軟件需求。如果用戶已經提供了面向系 統或部件或與系統或部件合為一體的產品，那么這些應當在需求和所有設想以 及需求文檔中清晰的定義出來。這些需求可能包括下列各項： 1） Operating System 操作系統 2） Database 數據庫 3） Communications 通信 4） Interfaces 接口 7.3.3 Purchaser-Related Characteristics 客戶相關的特征 在多數情況下，用戶會指定一些如下的特性。如果它們能夠增強系統的能力則應當 被包含進來，另一種選擇是在最開始的時候就對某些特性進行限定以避免驗收 測試時無休止的爭論。如果一些特性沒有在本部分被指定，它們應當在公司需 求部分被指定，舉例來說很多特性關系到系統投入使用后公司的技術支持成本 。 7.3.3.1 Pre-operational 運行之前 7.3.3.1.1 Packaging 包裝 7.3.3.1.2 Installation 安裝 7.3.3.1.3 Configuration 配置 7.3.3.2 Functionality 功能 7.3.3.2.1 Suitability 適用性 7.3.3.2.2 Accuracy 精確性 7.3.3.2.3 Interoperability 協同工作能力 7.3.3.2.4 Compliance – standards 遵循標準 7.3.3.2.5 Security 安全性 7.3.3.3 Reliability 可靠性 7.3.3.3.1 Maturity 完備性 7.3....
需求分析報告編寫規(guī)范