軟件開發(fā)公司的軟件工程文檔資料匯編

- 實訓(xùn)1組公共交通服務(wù)查詢系統(tǒng)-實用軟件工程文檔匯編1立項建議書12軟件項目投標(biāo)書63軟件產(chǎn)品開發(fā)任務(wù)書74軟件開發(fā)計劃書105用戶需求報告146需求規(guī)格說明書187需求報告 / 需求規(guī)格說明書評審記錄表228“圖書館信息系統(tǒng)”249概要設(shè)計說明書2510詳細設(shè)計說明書3011用戶使用手冊3412用戶安裝手冊3513測試報告3614軟件質(zhì)量保證關(guān)鍵過程域SQA3915CMM軟件質(zhì)量保證過程文件4216CMM軟件質(zhì)量保證程序文件4417軟件質(zhì)量保證計劃461立項建議書立項建議書編寫參考指南1引言（Introduction）1.1 目的（Purpose）本文檔是軟件立項書，目的是代替可行性分析。1.2 范圍（Scope）本文檔只適應(yīng)于軟件立項。1.3 術(shù)語定義（Terms Glossary）對軟件組織內(nèi)部和外部有關(guān)的行業(yè)術(shù)語、專用名詞進行定義。1 2 1.4 參考資料（References）對書寫該立項書所用到的有關(guān)資料進行說明。1 2 1.5 相關(guān)文檔（Related Documents）當(dāng)該文檔變更時，可能對其他文檔產(chǎn)生影響，受影響的文檔叫做相關(guān)文檔，需將它們一一列出。1 2 1.6 版本更新記錄（Version Updated Record）任何一次版本創(chuàng)建或維護更新，都要追加一條記錄。一個版本創(chuàng)建只有一次，但對它的維護更新可能有多次。大版本升級一次，定義為創(chuàng)建一次，如V1.0到V2.0。而V1.0到V1.1，只是維護更新一次。版本更新記錄格式，如表3-2所示。表3-2 版本更新記錄版本號創(chuàng)建者創(chuàng)建日期維護者維護日期維護紀(jì)要V1.0王大林2001/01/03V1.0.1王小林2001/02/10網(wǎng)絡(luò)版功能維護2項目概述及架構(gòu)（Project Summary and Framework）2.1 項目概述（Project Summary）宏觀上說明該項目是什么、能干什么、要求干得怎么樣。2.2 項目架構(gòu)（Project Framework）宏觀上描述該項目的架構(gòu)：單機結(jié)構(gòu)、C/S結(jié)構(gòu)、B/S結(jié)構(gòu)。并說明結(jié)構(gòu)具體詳細的運行平臺：硬件的要求、操作系統(tǒng)的要求、數(shù)據(jù)庫管理系統(tǒng)的要求、對外接口的要求。3客戶群分析（Client Analysis）3.1 客戶群定位（Client Orientation）單機結(jié)構(gòu)、C/S結(jié)構(gòu)、B/S結(jié)構(gòu)對應(yīng)哪三種客戶群，每種客戶群的數(shù)量、素質(zhì)、市場前景等。3.2 當(dāng)前客戶群分析（Current Client Analysis）當(dāng)前客戶群是指已簽訂合作協(xié)議或?qū)⒁炗喓献鲄f(xié)議的客戶群，分析他們的數(shù)量、素質(zhì)、市場前景等。3.3 潛在客戶群分析（Latency Client Analysis）潛在客戶群是指將來可能發(fā)展的客戶群，分析他們的數(shù)量、素質(zhì)、市場前景等。4項目功能（Project Function）4.1 單機版功能（Stand-alone Function）單機版功能，如表3-3所示。表3-3 單機版功能編號功能名稱功能描述輸入內(nèi)容輸出內(nèi)容124.2 網(wǎng)絡(luò)版功能（Network Function）網(wǎng)絡(luò)版功能，如表3-4所示。表3-4 網(wǎng)絡(luò)版功能編號功能名稱功能描述輸入內(nèi)容輸出內(nèi)容124.3 互聯(lián)網(wǎng)絡(luò)版功能（Internet Function）互聯(lián)網(wǎng)絡(luò)版功能，如表3-5所示。表3-5 互聯(lián)網(wǎng)絡(luò)版功能編號功能名稱功能描述輸入內(nèi)容輸出內(nèi)容125項目性能（Project Performance）5.1 響應(yīng)時間（Response Time）單機結(jié)構(gòu)（包括主機多用戶結(jié)構(gòu)，即H/T結(jié)構(gòu)）、C/S結(jié)構(gòu)、B/S結(jié)構(gòu)三種架構(gòu)的終端數(shù)量，要求響應(yīng)時間小于0.XX秒。5.2 處理速度（Disposal Speed）C/S結(jié)構(gòu)、B/S結(jié)構(gòu)兩種架構(gòu)的后臺結(jié)算方式，結(jié)算速度分析。5.3 最大終端負載（The Highest Terminal Load）C/S結(jié)構(gòu)、B/S結(jié)構(gòu)兩種架構(gòu)的并發(fā)處理最大終端（用戶）負載數(shù)量分析。以上性能要求，最好也用列表的形式給出。6項目接口（Project Interface）6.1 金融接口（Finance Interface）金融接口列表，如表3-6所示。表3-6 金融接口列表編號接口名稱接口規(guī)范接口標(biāo)準(zhǔn)入口參數(shù)出口參數(shù)傳輸頻率126.2 政府接口（Government Interface）政府接口列表，如表3-7所示。表3-7 政府接口列表編號接口名稱接口規(guī)范接口標(biāo)準(zhǔn)入口參數(shù)出口參數(shù)傳輸頻率126.3 互聯(lián)網(wǎng)接口（Internet Interface）互聯(lián)網(wǎng)接口列表，如表3-8所示。表3-8 互聯(lián)網(wǎng)接口列表編號接口名稱接口規(guī)范接口標(biāo)準(zhǔn)入口參數(shù)出口參數(shù)傳輸頻率127投入產(chǎn)出分析（Analysis of the Devotion and the Output）7.1 人力資源投入（Manpower Devotion）人力資源投入，如表3-9所示。表3-9 人力資源投入階段名稱需求崗位需求人數(shù)工作量（人/月）到崗日期需求分析分析師概要設(shè)計設(shè)計師詳細設(shè)計設(shè)計師 / 高級程序員編碼程序員測試測試員包裝與發(fā)布包裝師 總?cè)藬?shù)：總工作量（人/月）：7.2 設(shè)備資源投入（Facility Devotion）設(shè)備資源投入，如表3-10所示。表3-10 設(shè)備資源投入設(shè)備名稱規(guī)格型號數(shù)量單價（元）金額（元）到位日期7.3 其他經(jīng)費資源投入（Other Outlay Devotion）其他經(jīng)費資源投入，如表3-11所示。表3-11 其他經(jīng)費資源投入開支項目開支金額（元）支付日期支付方式（現(xiàn)金/支票）備注項目總投入（人力費用+設(shè)備費用+其他經(jīng)費資源投入）經(jīng)費（元）：7.4 產(chǎn)出分析（Output Analysis）產(chǎn)出分析，如表3-12所示。表3-12 產(chǎn) 出 分 析單機版單價（元）單機版數(shù)量C/S版單價（元）C/S版數(shù)量B/S版單價（元）B/S版數(shù)量年產(chǎn)出合計金額（元）第1年第2年第3年8開發(fā)計劃（Development Scheme）8.1 進度計劃（Plan Scheme）開發(fā)進度計劃，如表3-13所示。表3-13 進 度 計 劃階段名稱需求分析概要設(shè)計詳細設(shè)計編碼測試包裝與發(fā)布第1周進度第2周進度第3周進度第4周進度第5周進度8.2 評審計劃（Review Scheme）各里程碑的評審計劃，如表3-14所示。表3-14 評 審 計 劃階段名稱評審日期評審地點主持人參加人應(yīng)交文檔需求分析概要設(shè)計詳細設(shè)計測試報告包裝9案例分析（Cases Analysis）案例分析包括成功案例和失敗案例分析。9.1 國外案例分析（Cases Analysis in Foreign Countries）案例1：案例2：9.2 國內(nèi)案例分析（Cases Analysis in China）案例1：案例2：10風(fēng)險分析（Risk Analysis）10.1 需求風(fēng)險（Risk of Requirement）指項目組對用戶需求獲取的途徑和能力有何風(fēng)險，用戶主動配合需求的程度。10.2 政策風(fēng)險（Risk of Policy）指國家政策、行業(yè)政策、企業(yè)內(nèi)部政策的變化對項目將會產(chǎn)生有利或不利的影響。10.3 資源風(fēng)險（Risk of Resource）指開發(fā)和運行所需資源的風(fēng)險程度。10.4 技術(shù)風(fēng)險（Risk of Technology）指項目組采用新技術(shù)的風(fēng)險程度。如最新開發(fā)工具的風(fēng)險程度、最新設(shè)計思想的風(fēng)險程度。10.5 技能風(fēng)險（Risk of Skill）指項目組成員掌握新技術(shù)的風(fēng)險程度。2軟件項目投標(biāo)書表3-15 軟件項目投標(biāo)書編寫參考指南序號章節(jié)名稱章節(jié)內(nèi)容1 項目概況 按照招標(biāo)書的內(nèi)容，陳述項目概況2 總體解決方案 按照招標(biāo)書的要求，提出項目的總體解決方案： 網(wǎng)絡(luò)結(jié)構(gòu)總體方案 系統(tǒng)軟件配置方案 應(yīng)用軟件設(shè)計方案 系統(tǒng)實施方案3 項目功能、性能和接口描述 應(yīng)用軟件的具體功能點列表 應(yīng)用軟件的具體性能點列表 應(yīng)用軟件的具體接口列表續(xù)表序號章節(jié)名稱章節(jié)內(nèi)容4 項目工期、進度和經(jīng)費估算 項目工期（單位：人月）估算 項目進度估算：需求、設(shè)計、編程、測試、驗收的時間表 項目經(jīng)費（單位：人民幣元）估算5 項目質(zhì)量管理控制 質(zhì)量標(biāo)準(zhǔn) 質(zhì)量管理控制方法 項目開發(fā)和管理的組織結(jié)構(gòu)及人員配備6 附錄 附錄1：本軟件公司的特點與強項簡介 附錄2：本軟件公司的成功案例 附錄3：本軟件公司的資質(zhì)證明材料3軟件產(chǎn)品開發(fā)任務(wù)書軟件產(chǎn)品開發(fā)任務(wù)書正文樣本任務(wù)書名稱：大型商業(yè)MIS產(chǎn)品開發(fā)任務(wù)書。下達日期：1999/04/01。發(fā)出部門：XX公司研發(fā)中心。接受部門：研發(fā)中心商業(yè)軟件部。1目標(biāo)（1）做成商業(yè)MIS產(chǎn)品，其產(chǎn)品化程度要求很高。因此，一切信息都要規(guī)范化、標(biāo)準(zhǔn)化、代碼化。保證在產(chǎn)品實施時，其客戶化工作只需錄入代碼和修改代碼，絕對不允許修改數(shù)據(jù)結(jié)構(gòu)和表結(jié)構(gòu)；（2）配合市場銷售部門、全國各地的分支機構(gòu)和產(chǎn)品代理商，第一年開拓市場35個客戶，第二年占領(lǐng)10% 的商業(yè)MIS市場。2功能模塊劃分及要求大型商業(yè)MIS軟件產(chǎn)品擬分為以下6個功能模塊，要求每個功能模塊具有高內(nèi)聚、低耦合、信息隱蔽的性質(zhì)，如表3-16所示。表3-16 大型商業(yè)MIS產(chǎn)品的6個功能模塊序號模塊名稱功能要求1商業(yè)物流配送中心管理商業(yè)物流采購、配送2大型商場（大型連鎖超市）管理商品零售3便利店（小型連鎖超市）管理商品零售4遠程數(shù)據(jù)交換管理點對點通信5電子商務(wù)模塊網(wǎng)上訂貨、銷售6商業(yè)類庫管理基礎(chǔ)類庫、商業(yè)類庫、構(gòu)件庫管理3功能模塊詳述大型商業(yè)MIS軟件，從組織結(jié)構(gòu)上來說包括三個層次：（1）物流配送中心（2）大型商場（大型連鎖超市）（3）便利店（小型連鎖超市）作為一個完整的商業(yè)MIS系統(tǒng)來說，物流配送中心與大型商場（大型連鎖超市）之間會發(fā)生物流、資金流、信息流的關(guān)系；大型商場（大型連鎖超市）與便利店（小型連鎖超市）之間也會發(fā)生物流、資金流、信息流的關(guān)系；而物流配送中心與便利店（小型連鎖超市）之間沒有任何關(guān)聯(lián)。若將這三個模塊分開來看，它們又可以各自獨立成為一個單獨的小型商業(yè)系統(tǒng)來使用。實際上，本大型商業(yè)MIS系統(tǒng)完成后，可以對功能模塊進行組合或拆分，使其成為如下5個不同的小型商業(yè)MIS系統(tǒng)，供用戶選擇：（1）物流配送中心 大型商場（大型連鎖超市） 便利店（小型連鎖超市）的完整的商業(yè)MIS軟件。（2）物流配送中心 大型商場（大型連鎖超市）的商業(yè)MIS軟件。（3）大型商場（大型連鎖超市） 便利店（小型連鎖超市）的商業(yè)MIS系統(tǒng)。（4）物流配送中心MIS系統(tǒng)。（5）大型商場的商業(yè)MIS系統(tǒng)。作為本軟件的第一層，物流配送中心可以具有多個配送倉庫，它根據(jù)大型商場（大型連鎖超市）的需要以及各個倉庫庫存情況，向供應(yīng)商訂貨，進行貨物采購；并根據(jù)訂貨的情況進行配貨，組織運輸工具進行發(fā)貨；期間，還伴隨著向供應(yīng)商付款、索取發(fā)票，以及向客戶催款、開出發(fā)票等等。大型商場（大型連鎖超市）作為本軟件的第二層，除了要進行本商場的各種業(yè)務(wù)管理外，還要向上級物流配送中心訂貨、付款、索取發(fā)票，向下級便利店（小型連鎖超市）送貨，收取錢款等等。便利店（小型連鎖超市）作為本軟件的第三層，一要進行本商場的各種業(yè)務(wù)管理；二要根據(jù)庫存情況，向大型商場（大型連鎖超市）要貨，并定期將銷售金額上交給大型商場（大型連鎖超市）。考慮到目前有些商場，已經(jīng)有了其他的商業(yè)管理軟件，雖然軟件還有不完善的地方，但已經(jīng)購買前臺POS機。為了給客戶節(jié)省開支，有效地將前臺POS機利用好，所以，本系統(tǒng)的前臺銷售軟件就要做兩個版本：Windows 版本與DOS 版本。由于配送中心與大型商場（大型連鎖超市）之間、大型商場（大型連鎖超市）與便利店（小型連鎖超市）之間在物理位置上有一定的距離，所以，它們之間的網(wǎng)絡(luò)連接也是一個需要重視的大問題。本系統(tǒng)考慮采用兩種解決方案：一是采用DDN專線（或光纜），本方案數(shù)據(jù)傳輸速度快，性能高，程序設(shè)計、實現(xiàn)都很簡單，但用戶每月都要支付價格不低的線路費用，這種方案比較適合那些經(jīng)濟實力比較雄厚的用戶；二是采用電話線，用X.25通信協(xié)議，此方案數(shù)據(jù)傳輸速度稍慢，但也能滿足用戶需要，程序設(shè)計和實現(xiàn)要復(fù)雜許多，用戶每月支付的線路費用將大幅度下降。隨著計算機網(wǎng)絡(luò)技術(shù)的飛速發(fā)展，電子商務(wù)在流通領(lǐng)域的應(yīng)用也越來越多。本MIS系統(tǒng)也準(zhǔn)備在電子商務(wù)方面有所擴展，條件允許，可以實現(xiàn)網(wǎng)上訂貨、網(wǎng)上銷售，甚至網(wǎng)上貨幣支付。作為一個軟件企業(yè)，應(yīng)該不斷地提取、積累自己的軟件資源。不同開發(fā)平臺的開發(fā)規(guī)范、商業(yè)類庫、應(yīng)用框架、構(gòu)件、中間件等都是十分重要的軟件資源，是軟件公司的基礎(chǔ)建設(shè)。因此，在設(shè)計、編碼之前，要制訂相應(yīng)的開發(fā)規(guī)范，要組織開發(fā)、設(shè)計、管理一些類庫和構(gòu)件庫。軟件產(chǎn)品是軟件公司的財富來源，而軟件的有效加密是保護公司產(chǎn)品、產(chǎn)權(quán)的有效手段，更是保障公司效益的有效途徑。所以，還要考慮軟件加密算法設(shè)計。4功能模塊任務(wù)分配根據(jù)研發(fā)中心商業(yè)軟件部目前的人員情況，本系統(tǒng)的項目經(jīng)理由商業(yè)軟件部副經(jīng)理親自擔(dān)任，負責(zé)整個系統(tǒng)的規(guī)劃、設(shè)計、協(xié)調(diào)與實施；商業(yè)軟件部主任工程師擔(dān)任產(chǎn)品經(jīng)理，負責(zé)項目的整體需求、數(shù)據(jù)庫設(shè)計與Alpha測試。整個項目分為4個任務(wù)組，各個任務(wù)組組長在項目實施階段，承擔(dān)小項目經(jīng)理職責(zé)。4個任務(wù)組的人數(shù)及開發(fā)任務(wù)，如表3-17所示。表3-17 任務(wù)組的人數(shù)及開發(fā)任務(wù)任務(wù)組人數(shù)具體開發(fā)任務(wù)第1任務(wù)組4 1）POS機模塊改造 2）利用X.25協(xié)議進行遠程數(shù)據(jù)交換 3）電子商務(wù)模塊第2任務(wù)組6 物流配送中心管理模塊。本模塊的主要功能包括：貨物的采購管理，配送中心的庫存管理，貨物的銷售管理三大部分 1）貨物的采購管理包括：供應(yīng)商管理，采購計劃管理，訂貨管理，貨物驗收管理，退貨管理，應(yīng)付賬款管理，應(yīng)收發(fā)票管理，往來賬管理等 2）庫存管理包括：貨位管理，入庫管理，出庫管理，盤庫管理等 3）銷售管理包括：客戶管理，銷售定單管理，配貨管理，運輸工具管理，發(fā)貨管理，退貨管理，應(yīng)收賬款管理，應(yīng)付發(fā)票管理，往來賬管理等第3任務(wù)組6 1）全局數(shù)據(jù)庫設(shè)計 2）商業(yè)管理模塊（包括大型商場與便利店的管理）。本模塊的主要功能包括：貨物的采購管理，退貨管理（退給供應(yīng)商），價格管理，庫存管理，銷售管理，前臺銷售管理，退貨管理（客戶退貨管理），應(yīng)付、應(yīng)收賬款管理，發(fā)票管理，送貨管理（給便利店送貨），收款管理（便利店上交金額）等等第4任務(wù)組2 1）PowerBuilder 開發(fā)規(guī)范 2）PowerBuilder 類庫建設(shè) 3）構(gòu)件的提取和構(gòu)件庫的管理 4）產(chǎn)品的加密處理 5）安裝盤的制作5數(shù)據(jù)庫與開發(fā)工具的選擇考慮到數(shù)據(jù)庫的性能與價格比，數(shù)據(jù)庫首選Sybase，其次是MS SQL Server。由于這兩個數(shù)據(jù)庫的天然聯(lián)系，使得兩個版本的程序設(shè)計的差異將十分微小。數(shù)據(jù)庫設(shè)計工具采用PowerDesigner，程序開發(fā)工具選擇為PowerBuilder 。某些PowerBuilder 不宜實現(xiàn)的功能，可由 VC+ 去完成。文檔制作工具為Office 和PowerDesigner。6開發(fā)進度計劃研發(fā)中心商業(yè)軟件部現(xiàn)有18人進入了本項目組。根據(jù)以往的實際工作經(jīng)驗，下面列出研發(fā)進度，如表3-18所示。表3-18 進度計劃（1999/04/01-1999/10/15）階段名稱需求分析概要設(shè)計詳細設(shè)計編碼測試包裝發(fā)布第1周進度需求培訓(xùn)第2周進度需求獲取第3周進度需求獲取第4周進度需求獲取第5周進度需求確認第6周進度概要設(shè)計第7周進度概要設(shè)計第8周進度概要設(shè)計第9周進度詳細設(shè)計第10周進度詳細設(shè)計第11周進度詳細設(shè)計第12周進度詳細設(shè)計第13周進度編碼第14周進度編碼第15周進度編碼第16周進度編碼第17周進度編碼第18周進度編碼第19周進度編碼第20周進度Alpha測試第21周進度Alpha測試第22周進度Alpha測試第23周進度Alpha測試第24周進度Beta測試第25周進度Beta測試第26周進度包裝第27周進度發(fā)布第28周進度機動7評審計劃各里程碑的評審計劃，如表3-19所示。表3-19 里程碑評審計劃階段名稱評審日期評審地點主持人參加人應(yīng)交文檔需求分析1999/05/05公司第一會議室部門經(jīng)理項目組成員用戶需求報告/需求規(guī)格說明書概要設(shè)計1999/05/26公司第一會議室部門經(jīng)理項目組成員概要設(shè)計說明書詳細設(shè)計1999/06/25公司第一會議室項目經(jīng)理項目組成員詳細設(shè)計說明書Alpha測試1999/09/12公司第一會議室項目經(jīng)理測試人員Alpha測試報告Beta測試1999/09/26客戶單位項目經(jīng)理客戶代表Beta測試報告包裝1999/09/31公司第一會議室部門經(jīng)理銷售人員包裝光盤，用戶指南，廣告材料附件：商業(yè)MIS立項建議書，此處省略。4軟件開發(fā)計劃書軟件開發(fā)計劃書編寫參考指南1引言（Introduction）1.1 目的（Purpose）本章提供整個軟件開發(fā)計劃的綜述。主要是確定以下內(nèi)容：（1）軟件生存周期的選取及裁剪。（2）軟件規(guī)范、方法和標(biāo)準(zhǔn)的選擇。（3）軟件工作產(chǎn)品的規(guī)模估計。（4）軟件工作量和成本的估計。（5）軟件進度表的制定。（6）軟件風(fēng)險的估計。（7）軟件項目培訓(xùn)計劃。1.2 范圍（Scope）說明該軟件開發(fā)計劃的范圍，簡要描述軟件開發(fā)計劃的內(nèi)容。一般而言，對于一個較大的軟件項目（工期6個人月以上），計劃書包括如下內(nèi)容：（1）軟件規(guī)模估計（2）工作模塊計劃（3）人力資源計劃（4）其他資源計劃（5）進度安排計劃（6）配置管理計劃（可單獨做一個計劃）（7）質(zhì)量保證計劃（可單獨做一個計劃）1.3 術(shù)語定義（Terms Glossary）將該軟件開發(fā)計劃中的術(shù)語、縮寫詞進行定義。包括用戶應(yīng)用領(lǐng)域與計算機領(lǐng)域的術(shù)語與縮寫詞等。例如：1 軟件相關(guān)組：指軟件配置管理組、文檔支持組、測試組。2 軟件質(zhì)量保證組：指計劃和實施軟件質(zhì)量保證活動的人員的集合。1.4 參考資料（References）說明該軟件開發(fā)計劃使用的參考資料，如項目的用戶需求報告、商務(wù)合同、用戶領(lǐng)域的資料等，每一個文件、文獻要有標(biāo)題、索引號或文件號，發(fā)布或發(fā)表日期以及出版單位。1 2 1.5 相關(guān)文檔（Related Documents）當(dāng)該文檔變更時，可能對其他文檔產(chǎn)生影響，受影響的文檔叫相關(guān)文檔，需將它們列出。1 2 1.6 版本更新記錄（Version Updated Record）版本更新記錄格式，如表4-8所示。表4-8 版本更新記錄版本號創(chuàng)建者創(chuàng)建日期維護者維護日期維護紀(jì)要V1.0王大林2001/02/06V1.0.1王小林2001/02/25成本估算維護2項目概述（Project Summary）2.1 項目的目的（Project Purpose）說明該軟件項目的目的。2.2 項目的范圍（Project Scope）本章的內(nèi)容，主要參照立項建議書/合同與用戶需求報告中相關(guān)章節(jié)，簡要描述該軟件項目的實現(xiàn)范圍：（1）主要功能點列表（2）主要性能點列表（3）主要接口列表（4）本軟件項目與其他軟件項目之間的關(guān)系（5）項目實施方面的限制等內(nèi)容2.3 項目的使用對象（Project Reader）在本章節(jié)中，要識別出顧客與最終用戶，對顧客與最終用戶的情況要有簡單描述，如最終用戶的教育水平、技術(shù)水平及本系統(tǒng)的使用頻度等。3項目組織（Project Organization）項目組織是為開發(fā)項目而組建的隊伍。建議以框圖的方式表示項目的組織結(jié)構(gòu)，并對每一組織的負責(zé)人和職責(zé)加以說明?？赡艿捻椖拷M織單元，如：（1）項目管理組（2）質(zhì)量保證組（3）配置管理組（4）軟件工程組（5）測試組（6）需求管理組各組織說明如下：（1）項目管理組，執(zhí)行SPP和SPTO過程，對項目實施負全部責(zé)任。（2）質(zhì)量保證組，執(zhí)行SQA過程，負責(zé)項目過程與產(chǎn)品的質(zhì)量控制和報告。（3）配置管理組，執(zhí)行SCM過程，負責(zé)項目產(chǎn)品的版本、配置管理以及配置庫狀態(tài)報告。（4）軟件工程組，執(zhí)行軟件項目工程過程，負責(zé)項目產(chǎn)品的開發(fā)和維護工作。（5）測試組，執(zhí)行軟件項目測試過程，負責(zé)項目產(chǎn)品的測試。（6）需求管理組，負責(zé)對需求基線和需求變更進行管理。4軟件生存周期（Software Life Cycle）本章節(jié)記錄項目策劃生存期定義的工作結(jié)果，需要描述的主要內(nèi)容：（1）項目生存期框圖（2）項目生存期說明5規(guī)范、方法和標(biāo)準(zhǔn)（Criterion，Means，Standard）本章節(jié)中需要描述采用的供開發(fā)和維護軟件用的規(guī)范、方法和標(biāo)準(zhǔn)。6任務(wù)與工作產(chǎn)品（Task and Work Products）項目任務(wù)和工作產(chǎn)品，是指根據(jù)項目生存期階段劃分的任務(wù)，和相應(yīng)階段的工作產(chǎn)品。記錄項目生存期各階段確定的需重點控制的階段任務(wù)和工作產(chǎn)品。建議以表格的形式，列出生存期各階段的任務(wù)和工作產(chǎn)品。項目包含的任務(wù)，如：（1）需求分析（2）系統(tǒng)設(shè)計（3）系統(tǒng)實現(xiàn)（4）測試（5）產(chǎn)品交付（6）產(chǎn)品維護項目可能包含的產(chǎn)品，如：（1）需求分析說明書（2）規(guī)格分析說明書（3）系統(tǒng)設(shè)計說明書（4）源代碼（5）各種測試報告（6）用戶手冊（7）軟件問題維護記錄7工作產(chǎn)品、任務(wù)規(guī)模、工作量估計（Estimates of Work Product，Task Size and Workload）項目規(guī)模估算是為了確定項目所需的人工。需要描述的主要內(nèi)容有：（1）對軟件工作產(chǎn)品規(guī)模估計依據(jù)的簡要描述。（2）每種任務(wù)和工作產(chǎn)品規(guī)模估計的結(jié)果。（3）規(guī)模估算的結(jié)果，建議用任務(wù)規(guī)模和工作量估算表的形式列出。8成本估計（Estimates of Costs）成本估計，是指對項目完成過程中耗費的人力、物力、財力資源的估算。成本估計應(yīng)按類別進行估算，可能的成本估算類別，如：（1）直接人工（2）直接費用（3）間接成本（4）制造費用（5）管理費用（6）不可預(yù)見費用9關(guān)鍵計算機資源計劃（Critical Computer Resource Plan）項目的關(guān)鍵計算機資源計劃，是指系統(tǒng)在開發(fā)環(huán)境、測試環(huán)境、及用戶目標(biāo)環(huán)境中，對關(guān)鍵計算機資源，如計算機存儲能力、計算機處理器速度、通信通道容量、服務(wù)器處理能力等的估計，使之能滿足軟件開發(fā)、測試、運行的要求。10軟件項目進度計劃（Software Project Schedule）件項目進度計劃，是對項目的進度、人員工作分工所做的計劃，此計劃依據(jù)上述各章的估算和分析結(jié)果，計劃方式建議采用表格的形式。若采用工具制定項目計劃，應(yīng)將工具生成的圖表作為項目計劃的附件。本章節(jié)中需要描述的主要內(nèi)容有：（1）軟件項目每個階段的進度時間表（2）設(shè)定的里程碑（3）評審時間（4）緩沖時間11配置管理計劃（可單獨做一個計劃）（Configuration Management Planning）本書單獨作為一章論述。12質(zhì)量保證計劃（可單獨做一個計劃）（Software Quality Assurance Planning）本書單獨作為一章論述。13風(fēng)險分析（Risks Analysis）項目風(fēng)險分析，是指對可能發(fā)生的將會對項目按預(yù)期時間、資源和預(yù)算完成產(chǎn)生重大影響的事件的分析包括：（1）被識別出的重大風(fēng)險事件：政策風(fēng)險、技術(shù)風(fēng)險、技能風(fēng)險等。（2）易發(fā)生重大風(fēng)險事件的高風(fēng)險區(qū)域：用戶需求、設(shè)計、測試、運行平臺等。（3）重大風(fēng)險事件的級別：功能不全、性能不穩(wěn)、迅速受限制等。（4）擬采取的預(yù)防措施：增加投入、糾錯、延時等。（5）風(fēng)險事件發(fā)生后建議采用的處理措施：更改計劃、降低難度系數(shù)等。14設(shè)備工具計劃（Equipment and Tools Planning）項目設(shè)備工具計劃，是根據(jù)項目的工作指派及進度確定項目所需要的設(shè)備和工具，以確保設(shè)備工具在任務(wù)執(zhí)行前到位，保證項目任務(wù)的順利執(zhí)行，在本計劃中應(yīng)包含以下幾方面的內(nèi)容：（1）所需的設(shè)備（2）基本的要求（3）應(yīng)到位的時間15培訓(xùn)計劃（Training Planning）項目的培訓(xùn)計劃，應(yīng)根據(jù)項目的特點和項目組成員技能情況，制定出項目組成員所需的培訓(xùn)內(nèi)容，培訓(xùn)計劃中應(yīng)包含以下幾方面：（1）培訓(xùn)內(nèi)容（2）培訓(xùn)時間（3）教員（4）接受培訓(xùn)的人員（5）培訓(xùn)目的（應(yīng)達到的效果）16項目評審（Project Reviews）項目評審，是對項目策劃過程所做的定期性評審。其內(nèi)容可分為：（1）評審點（2）評審周期（3）評審層次（4）評審條款和措施（5）管理評審活動中提交的工作產(chǎn)品（列出被評審的工作產(chǎn)品）17度量（Measurement）度量是按規(guī)定在項目進行過程中，需要采集的度量數(shù)據(jù)，以便量化地反映項目的進展情況，為管理者提供對項目進展的適當(dāng)?shù)目梢曅裕瑫r度量數(shù)據(jù)是項目過程改善的數(shù)據(jù)基礎(chǔ)。應(yīng)規(guī)定項目度量值的記錄人（一般為項目經(jīng)理或其指定人員）、記錄時間（一般以定期評審為基礎(chǔ)）和記錄的數(shù)據(jù)。常用的度量數(shù)據(jù)如：（1）項目過程的評審次數(shù)（2）項目計劃修改次數(shù)（3）項目各階段的人員投入（各階段投入的人月數(shù)）（4）各類任務(wù)耗用時間統(tǒng)計（如設(shè)計、編碼、測試、文檔編寫等）（5）工作產(chǎn)品統(tǒng)計（如文檔字數(shù)、功能點數(shù)、用況數(shù)、源代碼行數(shù)等）5用戶需求報告用戶需求報告編寫參考指南1概述（Summary）本文檔是進行需求規(guī)格定義、項目策劃、概要設(shè)計的基礎(chǔ)，也是用戶進行驗收的依據(jù)。1.1 用戶簡介（User Synopsis）在本章節(jié)中要將用戶的基本情況描述清楚，以便于分析人員劃定系統(tǒng)范圍，進行關(guān)于功能、進度、成本、性能等方面的平衡決策。對于產(chǎn)品開發(fā)類項目，需要在此將該產(chǎn)品定義的用戶群的特點描述清楚。1.2 項目的目的與目標(biāo)（Purpose and Aim of Project）項目的目的是對開發(fā)本系統(tǒng)意圖的總概括。項目的目標(biāo)是將目的細化后的具體描述。項目目標(biāo)應(yīng)是明確的、可度量的、可以達到的, 項目的范圍應(yīng)能確保項目的目標(biāo)可以達到。對于項目的目標(biāo)可以逐步細化，以便與系統(tǒng)的需求建立對應(yīng)關(guān)系，檢查系統(tǒng)的功能是否覆蓋了系統(tǒng)目標(biāo)。1.3 術(shù)語定義（Terms Glossary）將該用戶需求報告中的術(shù)語、縮寫進行定義, 包括用戶應(yīng)用領(lǐng)域與計算機領(lǐng)域的術(shù)語與縮寫等。1.4 參考資料（References）說明該用戶需求報告使用的參考資料，如：1 商務(wù)合同2 招標(biāo)書3 用戶領(lǐng)域的資料4 用戶需求調(diào)查表5 參照的標(biāo)準(zhǔn)每一個文件、文獻要有標(biāo)題、或文件號，發(fā)布或發(fā)表日期以及出版單位。1.5 相關(guān)文檔（Related Documents）說明用戶需求報告的變更，以及可能受變更影響的其他相關(guān)文檔，如：1 項目開發(fā)計劃2 需求規(guī)格說明書1.6 版本更新信息（Version Updated Record）版本更新記錄格式，如表5-11所示。表5-11 版本更新記錄版本號創(chuàng)建者創(chuàng)建日期維護者維護日期維護紀(jì)要V1.0王大林2001/02/18V1.0.1王小林2001/02/26賬本格式維護2現(xiàn)有系統(tǒng)描述（System in Existence）2.1 組織結(jié)構(gòu)與職責(zé)（Organizing Framework and Function）將用戶的組織結(jié)構(gòu)逐層詳細描述，建議采用樹狀的組織結(jié)構(gòu)圖進行表達，每個部門的職責(zé)也應(yīng)進行簡單的描述。組織結(jié)構(gòu)是用戶企業(yè)業(yè)務(wù)流程與信息的載體，對分析人員理解企業(yè)的業(yè)務(wù)、確定系統(tǒng)范圍很有幫助。取得用戶的組織結(jié)構(gòu)，是需求獲取步驟中的工作任務(wù)之一。2.2 崗位定義（Role Definition）用戶環(huán)境中的企業(yè)崗位和組織結(jié)構(gòu)一樣，也是分析人員理解企業(yè)業(yè)務(wù)的基礎(chǔ)，是需求獲取的工作任務(wù)，同時也是分析人員提取對象的基礎(chǔ)。每個崗位的職責(zé)可以進行詳細的描述，建議采用表格的形式，如表5-12所示。表5-12 崗 位 定 義編 號崗 位所在部門職 責(zé)相關(guān)的業(yè)務(wù)1008采購員業(yè)務(wù)部商品采購、合同簽訂、供應(yīng)商選擇進貨、合同管理1009對用戶崗位的識別，也包括使用了計算機系統(tǒng)后的系統(tǒng)管理人員崗位。2.3 作業(yè)流程（Busywork Flow）企業(yè)的作業(yè)流程，首先要有一個總的業(yè)務(wù)流程圖，將企業(yè)中各種業(yè)務(wù)之間的關(guān)系描述出來，然后對每種業(yè)務(wù)進行詳細的描述，使業(yè)務(wù)流程與部門職責(zé)結(jié)合起來。詳細業(yè)務(wù)流程圖可以采用直式業(yè)務(wù)流程圖、Use case圖、程序流程圖加上文字說明。圖形可以將流程描述得很清楚，但是還要附加一些文字說明，如關(guān)于業(yè)務(wù)發(fā)生的頻率、意外事故的處理、高峰期的業(yè)務(wù)頻率等，不能在流程圖中描述的內(nèi)容，需要用文字進行詳細描述。2.4 單據(jù)、賬本、報表（Bill of Document，Account and Report）現(xiàn)行系統(tǒng)中用戶正在使用的正式的或非正式的單據(jù)、賬本、報表等可以收集起來，并進行窮舉、分類、歸納。單據(jù)、賬本、報表是用戶系統(tǒng)中信息的載體，是進行系統(tǒng)需求分析的基礎(chǔ)，無論采用哪種分析方法，這都是必不可少的信息源。2.4.1 單據(jù)（Bill of Document）單據(jù)的格式可用表格描述，如表5-13所示。表5-13 單據(jù)的描述格式單據(jù)名稱用途使用單位制作單位頻率高峰時數(shù)據(jù)流量各數(shù)據(jù)項的詳細說明如下：序號數(shù)據(jù)項中文名數(shù)據(jù)項英文名類型、長度、精度數(shù)據(jù)項的取值范圍1232.4.2 賬本（Account）因為賬本上的數(shù)據(jù)是統(tǒng)計數(shù)據(jù)，所以一個賬本一般對應(yīng)一張中間表，賬本的格式可用表格描述，如表5-14所示。表5-14 賬本的描述格式賬本名稱用途使用單位制作單位頻率高峰時數(shù)據(jù)流量各數(shù)據(jù)項的詳細說明如下：序號數(shù)據(jù)項中文名數(shù)據(jù)項英文名數(shù)據(jù)項類型、長度、精度數(shù)據(jù)來源1232.4.3 報表（Report）因為報表上的數(shù)據(jù)是統(tǒng)計數(shù)據(jù)，所以一個報表一般對應(yīng)一張中間表，報表的格式可用表格描述，如表5-15所示。2.5 存在的問題（Existent Question）在現(xiàn)行的系統(tǒng)中，決策層、管理層、操作層各存在哪些方面的問題需要計算機來解決，尤其是決策層、管理層這些問題中包含了用戶的需求與期望，有些問題是新系統(tǒng)可以解決的，有些問題則不是。表5-15 報表的描述格式報表名稱用途使用單位制作單位頻率高峰時數(shù)據(jù)流量各數(shù)據(jù)項的詳細說明如下：序號數(shù)據(jù)項中文名數(shù)據(jù)項英文名數(shù)據(jù)項類型、長度、精度數(shù)據(jù)來源1232.6 可能的變化（Possible Change）對于現(xiàn)行的系統(tǒng)，將來可能會有哪些變化，需要在此描述。企業(yè)中的變化是永恒的，系統(tǒng)分析員需要描述哪些變化可能引起系統(tǒng)范圍變更。3目標(biāo)系統(tǒng)功能需求（Function of Target System）3.1 功能需求分析（Function Analysis）決策層、管理層、操作層各有哪些具體功能要求。3.2 功能需求點列表（Function List）在功能需求分析完成后，要詳細列出用戶需求功能點列表，提供給后續(xù)設(shè)計、編程、測試中使用，更是為了用戶測試驗收中使用。功能需求點列表的格式，如表5-16所示。表5-16 功能需求點列表編 號功 能 名 稱使 用 部 門使 用 崗 位功 能 描 述輸 入 內(nèi) 容輸 出 內(nèi) 容1234目標(biāo)系統(tǒng)性能需求（Performance of Target System）4.1 時間要求（Time Request）如：（1）響應(yīng)時間，如查詢的最長等待時間。（2）更新處理時間，如記賬的最長時間。（3）數(shù)據(jù)的轉(zhuǎn)換和傳送時間，如遠程數(shù)據(jù)傳輸?shù)臅r間要求。（4）解題時間。4.2 空間要求（Space Request）如：（1）支持的終端數(shù)。（2）支持的并行操作的使用者數(shù)。（3）處理的文件和記錄數(shù)。（4）表和文件的大小規(guī)模（要按可預(yù)見的增長，對數(shù)據(jù)及其分量的存儲要求做出估算）。（5）處理任務(wù)的數(shù)量。（6）在正常情況下和峰值工作條件下，在一定時間周期中要處理的數(shù)據(jù)總數(shù)。（7）對輸入和輸出數(shù)據(jù)的精度要求。（8）對處理和傳輸過程中的精度要求。4.3 性能需求點列表（Performance List）詳細列出用戶性能點列表，提供給后續(xù)分析、設(shè)計、編程、測試中使用，更是為了用戶測試驗收中使用。需求性能點列表的格式，如表5-17所示。表5-17 性能需求點列表編 號性能名稱使用部門 使用崗位性能描述輸入內(nèi)容輸出內(nèi)容1235目標(biāo)系統(tǒng)界面與接口需求（Interface of Target System）5.1 界面需求（Interphase Requirement）界面的原則要求，如方便、簡潔、美觀、一致等。整個系統(tǒng)的界面風(fēng)格定義，某些功能模塊的特殊的界面要求。（1）輸入設(shè)備：鍵盤、鼠標(biāo)、條碼掃描器、掃描儀等；（2）輸出設(shè)備：顯示器、打印機、光盤刻錄機、磁帶機、音箱等；（3）顯示風(fēng)格：圖形界面、字符界面、IE界面等；（4）顯示方式：1024*768、640*480等；（5）輸出格式：顯示布局、打印格式等。5.2 接口需求（Interface Requirement）與其他系統(tǒng)的接口，如監(jiān)控系統(tǒng)、控制系統(tǒng)、銀行結(jié)算系統(tǒng)、稅控系統(tǒng)、財務(wù)系統(tǒng)、政府網(wǎng)絡(luò)系統(tǒng)及其他系統(tǒng)等。（1）與系統(tǒng)特殊外設(shè)的接口，如CT機、磁共振、柜員機（ATM）、IC卡、盤點機等。（2）與中間件的接口，要列出接口規(guī)范、入口參數(shù)、出口參數(shù)、傳輸頻率等。應(yīng)在此列舉出所有的外部接口名稱、接口標(biāo)準(zhǔn)、規(guī)范。外部接口列表，如表5-18所示。表5-18 外部接口需求點列表編 號接口名稱接口規(guī)范接口標(biāo)準(zhǔn)入口參數(shù)出口參數(shù)傳輸頻率1236目標(biāo)系統(tǒng)其他需求（Other Requirements of Target System）6.1 安全性（Security）6.2 可靠性（Dependability）6.3 靈活性（Agility）6.4 特殊需求（Special requirements）如：（1）進度需求：系統(tǒng)的階段進度要求。（2）資金需求：投資額度。（3）運行環(huán)境需求：平臺、體系結(jié)構(gòu)、設(shè)備要求。（4）培訓(xùn)需求：用戶對培訓(xùn)的需求，是否提供多媒體教學(xué)光盤。（5）推廣需求：推廣的要求，如在上百個遠程部門推廣該系統(tǒng)，是否要有推廣的支持軟件。7目標(biāo)系統(tǒng)假設(shè)與約束條件（Suppose and Restriction of Target System）假設(shè)與約定條件是對預(yù)計的系統(tǒng)風(fēng)險的描述, 如：（1）法律、法規(guī)和政策方面的限制。（2）硬件、軟件、運行環(huán)境和開發(fā)環(huán)境方面的條件和限制。（3）可利用的信息和資源。（4）系統(tǒng)投入使用的最晚日期。（5）需求中的風(fēng)險分析：技術(shù)風(fēng)險、技能風(fēng)險、時間風(fēng)險、資源風(fēng)險。6需求規(guī)格說明書需求規(guī)格說明書編寫參考指南1概述（Summary）本文檔是進行項目策劃、概要設(shè)計和詳細設(shè)計的基礎(chǔ)，也是軟件企業(yè)測試部門進行內(nèi)部驗收測試的依據(jù)。1.1 用戶簡介（User Synopsis）在本章節(jié)中要將用戶的基本情況描述清楚，以便于分析人員劃定系統(tǒng)范圍，進行功能、進度、成本、性能等方面的平衡決策。對于產(chǎn)品開發(fā)類項目，需要在此將該產(chǎn)品定義的用戶群的特點描述清楚。1.2 項目的目的與目標(biāo)（Purpose and Aim of Project）項目的目的是對開發(fā)本系統(tǒng)的意圖的總概括。項目的目標(biāo)是將目的細化后的具體描述。項目目標(biāo)應(yīng)是明確的、可度量的、可以達到的, 項目的范圍應(yīng)能確保項目的目標(biāo)可以達到。對于項目的目標(biāo)可以逐步細化，以便與系統(tǒng)的需求建立對應(yīng)關(guān)系，檢查系統(tǒng)的功能是否覆蓋了系統(tǒng)的目標(biāo)。1.3 術(shù)語定義（Terms Glossary）將該需求規(guī)格說明書中的術(shù)語、縮寫進行定義, 包括用戶應(yīng)用領(lǐng)域與計算機領(lǐng)域的術(shù)語與縮寫等。1.4 參考資料（References）說明該用戶需求報告使用的參考資料，如：1 商務(wù)合同2 招標(biāo)書3 用戶領(lǐng)域的資料4 用戶需求調(diào)查表5 用戶需求報告6 參照的標(biāo)準(zhǔn)每一個文件、文獻要有標(biāo)題、或文件號，發(fā)布或發(fā)表日期以及出版單位。1.5 相關(guān)文檔（Related Documents）1 項目開發(fā)計劃2 概要設(shè)計說明書3 詳細設(shè)計說明書1.6 版本更新信息（Version Updated Record）版本更新記錄格式，如表5-19所示。表5-19 版本更新記錄版本號創(chuàng)建者創(chuàng)建日期維護者維護日期維護紀(jì)要V1.0王大林2001/03/03V1.0