軟件項目研制報告范文

1、軟件研發(fā)報告目錄1. 范圍32. 總體要求32.1 總體功能要求32.2 軟件開發(fā)平臺要求32.3 軟件項目的開發(fā)實施過程管理要求3 軟件項目實施過程總體要求3 軟件項目實施里程碑控制43. 軟件開發(fā)43.1 軟件的需求分析4 需求分析4 需求分析報告的編制者5 需求報告評審5 需求報告格式53.2 軟件的概要設(shè)計5 概要設(shè)計5 編寫概要設(shè)計的要求5 概要設(shè)計報告的編寫者5 概要設(shè)計和需求分析、詳細(xì)設(shè)計之間的關(guān)系和區(qū)別5 概要設(shè)計的評審6 概要設(shè)計格式63.3 軟件的詳細(xì)設(shè)計6 詳細(xì)設(shè)計6 特例6 詳細(xì)設(shè)計的要求6 數(shù)據(jù)庫設(shè)計6 詳細(xì)設(shè)計的評審6 詳細(xì)設(shè)計格式63.4 軟件的編碼7 軟件編碼7

2、 軟件編碼的要求7 編碼的評審7 編程規(guī)范及要求73.5 軟件的測試7 軟件測試7 測試計劃73.6 軟件的交付準(zhǔn)備8 交付清單83.7 軟件的鑒定驗收8 軟件的鑒定驗收8 驗收人員8 驗收具體內(nèi)容8 軟件驗收測試大綱83.8 培訓(xùn)8 系統(tǒng)應(yīng)用培訓(xùn)8 系統(tǒng)管理的培訓(xùn)（可選）91. 范圍本報告用于指導(dǎo)軟件開發(fā)者為山西電力科學(xué)研究所開發(fā)軟件項目的過程，通過規(guī)范軟件項目承擔(dān)單位的開發(fā)過程達(dá)到提高軟件質(zhì)量，降低維護(hù)成本的目的。開發(fā)者應(yīng)根據(jù)本指南進(jìn)行軟件開發(fā)和編制軟件開發(fā)文檔。本指南是對軟件項目承擔(dān)單位的基本要求。2. 總體要求2.1 總體功能要求網(wǎng)絡(luò)應(yīng)用環(huán)境以Internet技術(shù)為核心。開發(fā)者在充分分

3、析需求的基礎(chǔ)上，選擇采用B/S結(jié)構(gòu)。軟件系統(tǒng)的數(shù)據(jù)庫依照山西電力科學(xué)研究所信息化數(shù)據(jù)庫的建設(shè)規(guī)范進(jìn)行設(shè)計和建設(shè)。本指南中沒有規(guī)定開發(fā)者采用何種具體的軟件工程開發(fā)方法，開發(fā)者可根據(jù)項目具體特點、自身擅長來選擇采用面向過程的方法、面向?qū)ο蟮姆椒ɑ蛎嫦驍?shù)據(jù)的方法，但建議開發(fā) 商使用面向?qū)ο筌浖こ痰姆椒ā?2.2 軟件開發(fā)平臺要求開發(fā)者開發(fā)的軟件必須能夠在山西電力科學(xué)研究所規(guī)定的軟件平臺上正常運行。目前軟件平臺為：數(shù)據(jù)庫管理系統(tǒng)：SQLServer2005以上版本服務(wù)器：Tomcat 6.0以上版本運行環(huán)境：JDK 1.5以上版本網(wǎng)絡(luò)架構(gòu)：完全支持TCP/IP協(xié)議開發(fā)工具或技術(shù)體系：為保證軟件的上下

4、兼容性，開發(fā)者應(yīng)選擇比較通用的開發(fā)工具的較新版本進(jìn)行開發(fā)，如Eclipse、MyEclipse等。 2.3 軟件項目的開發(fā)實施過程管理要求2.3.1 軟件項目實施過程總體要求（一） 開發(fā)者提交軟件開發(fā)工作大綱，山西電力研究所組織專家組對工作大綱進(jìn)行評審，并提出整改意見。（二） 通過評審后，開發(fā)者根據(jù)整改意見完善工作大綱，經(jīng)過山西電力科學(xué)研究所認(rèn)可后組織項目組進(jìn)行軟件開發(fā)。軟件開發(fā)在開發(fā)過程中，開發(fā)者需分階段提交相關(guān)文檔。（三） 在軟件開發(fā)工作完成后，開發(fā)者應(yīng)向山西電力科學(xué)研究所提交完整的軟件文檔，山西電力科學(xué)研究所組織驗收組對軟件進(jìn)行驗收審查。2.3.2 軟件項目實施里程碑控制山西電力科學(xué)研究

5、所將分四個階段進(jìn)行把關(guān)，召開專家審查會。（一） 需求分析（結(jié)合原型進(jìn)行審查）確認(rèn)；（二） 概要設(shè)計、數(shù)據(jù)庫設(shè)計；（三） 預(yù)驗收（試運行后）；（四） 正式驗收（推廣使用后）。3. 軟件開發(fā)項目承擔(dān)單位即可組織項目組進(jìn)行軟件開發(fā)工作，軟件開發(fā)必須嚴(yán)格按照軟件工程的要求進(jìn)行。開發(fā)過程包括開發(fā)者的活動和任務(wù)。3.1 軟件的需求分析3.1.1 需求分析首先，開發(fā)者和山西電力科學(xué)研究所應(yīng)共同對山西電力科學(xué)研究所的應(yīng)用需求作充分的調(diào)研，提交完整的需求分析 報告。在需求分析報告中必須描述的基本問題是：功能、性能、強加于實現(xiàn)的設(shè)計限制、屬 性、外部接口。應(yīng)當(dāng)避免把設(shè)計或項目需求寫入需求分析報告中。它必須說明由軟

6、件獲得的 結(jié)果，而不是獲得這些結(jié)果的手段。軟件需求可以用若干種方法來表達(dá)，如通過輸入、輸出說明；使用代表性的例子；用規(guī)范化的模型。開發(fā)者應(yīng)盡可能地使用模型的方式，因為這是表達(dá)復(fù)雜需求的精確和有效的方法。比如用統(tǒng)一建模語言（UML）來描述需求。編寫需求分析報告的要求a無歧義性對最終產(chǎn)品的每一個特性用某一術(shù)語描述；若某一術(shù)語在某一特殊的行文中使用時具有多種含義，那么應(yīng)對該術(shù)語的每種含義做出解釋并指出其適用場合。b完整性需求分析報告應(yīng)該包括全部有意義的需求，無論是關(guān)系到功能的、性能的、設(shè)計約束的、還是關(guān)系到外部接口方面的需求；對所有可能出現(xiàn)的輸入數(shù)據(jù)的響應(yīng)予以定義，要對合法和非合法的輸入值的響應(yīng)做出

7、規(guī)定；填寫全部插圖、表、圖示標(biāo)記等；定義全部術(shù)語和度量單位。c可驗證性需求分析報告描述的每一個需求應(yīng)是可以驗證的。可以通過一個有限處理過程來檢查軟件產(chǎn)品是否滿足需求。d一致性在需求分析報告中的各個需求的描述不能互相矛盾。e可修改性需求分析報告應(yīng)具有一個有條不紊、易于使用的內(nèi)容組織；沒有冗余，即同一需求不能在需求分析報告中出現(xiàn)多次。f可追蹤性每一個需求的源流必須清晰，在進(jìn)一步產(chǎn)生和改變文件編制時，可以方便地引證每一個需求。g運行和維護(hù)階段的可使用性需求分析報告必須滿足運行和維護(hù)階段的需要。在需求分析報告要寫明功能的來源和目的。3.1.2 需求分析報告的編制者需求分析報告應(yīng)由山西電力科學(xué)研究所和開

8、發(fā)者雙方共同完成。其中：山西電力科學(xué)研究所負(fù)責(zé)根據(jù)實際需要提出希望軟件實現(xiàn)的功能；軟件開發(fā)者根據(jù)山西電力科學(xué)研究所提出的性能需求，結(jié)合軟件開發(fā)編寫需求分析。3.1.3 需求報告評審在軟件需求分析工作完成后，軟件開發(fā)者應(yīng)向山西電力科學(xué)研究所提交軟件需求分析報告。山西電力科學(xué)研究所組織有關(guān)人員對需求進(jìn)行評審，以決定軟件需求是否完善和恰當(dāng)。評審?fù)瓿珊?，就可以進(jìn)入軟件的設(shè)計階段。3.1.4 需求報告格式軟件需求分析報告需按一定的格式進(jìn)行編寫，具體的軟件需求分析報告文檔編寫模板請見附錄A。3.2 軟件的概要設(shè)計3.2.1 概要設(shè)計在山西電力科學(xué)研究所和開發(fā)者雙方認(rèn)可的需求分析基礎(chǔ)上，開發(fā)者進(jìn)行下步的工作

9、。首先，開發(fā)者需要對軟件系統(tǒng)進(jìn)行概要設(shè)計，即系統(tǒng)設(shè)計。概要設(shè)計需要對軟件系統(tǒng)的設(shè)計 進(jìn)行考慮，包括系統(tǒng)的基本處理流程、系統(tǒng)的組織結(jié)構(gòu)、模塊劃分、功能分配、接口設(shè)計、運行設(shè)計、數(shù)據(jù)結(jié)構(gòu)設(shè)計和出錯處理設(shè)計等，為軟件的詳細(xì)設(shè)計提供基礎(chǔ)。3.2.2 編寫概要設(shè)計的要求a一致性概要設(shè)計的要求應(yīng)該與需求分析報告所描述的需求一致。同時，概要設(shè)計的各項要求之間也應(yīng)該一致。b合理性概要設(shè)計所提出的設(shè)計方法和標(biāo)準(zhǔn)應(yīng)該是合理的、恰當(dāng)?shù)?。c可追蹤性對概要設(shè)計所提出的各項要求應(yīng)該可以得到它的清晰的源流，即在需求分析報告客戶有明確的需求描述。d可行性根據(jù)概要設(shè)計進(jìn)行詳細(xì)設(shè)計、操作和維護(hù)應(yīng)該是可行的。3.2.3 概要設(shè)計報

10、告的編寫者概要設(shè)計報告由開發(fā)者根據(jù)需求分析報告的要求進(jìn)行編寫。3.2.4 概要設(shè)計和需求分析、詳細(xì)設(shè)計之間的關(guān)系和區(qū)別 需求分析不涉及具體的技術(shù)實現(xiàn)，而概要設(shè)計注重于從宏觀上和框架上來描述采用何種技術(shù)手段、方法來實現(xiàn)這些需求。詳細(xì)設(shè)計相對概要設(shè)計更注重于微觀上和框架內(nèi)的設(shè)計， 是編碼的依據(jù)。概要設(shè)計是指導(dǎo)詳細(xì)設(shè)計的依據(jù)。3.2.5 概要設(shè)計的評審在軟件概要設(shè)計工作完成后，軟件開發(fā)者應(yīng)向交通提交軟件系統(tǒng)概要設(shè)計報告。在山西電力科學(xué)研究所對概要設(shè)計報告評審?fù)ㄟ^后，即可進(jìn)入詳細(xì)設(shè)計階段。3.2.6 概要設(shè)計格式軟件系統(tǒng)概要設(shè)計報告需按一定的格式進(jìn)行編寫。3.3 軟件的詳細(xì)設(shè)計3.3.1 詳細(xì)設(shè)計在概

11、要設(shè)計的基礎(chǔ)上，開發(fā)者需要進(jìn)行軟件系統(tǒng)的詳細(xì)設(shè)計。在詳細(xì)設(shè)計中，描述實 現(xiàn)具體模塊所涉及到的主要算法、數(shù)據(jù)結(jié)構(gòu)、類的層次結(jié)構(gòu)及調(diào)用關(guān)系，需要說明軟件系統(tǒng)各個層次中的每一個程序(每個模塊或子程序)的設(shè)計考慮，以便進(jìn)行編碼和測試。應(yīng)當(dāng)保證 軟件的需求完全分配給整個軟件。詳細(xì)設(shè)計應(yīng)當(dāng)足夠詳細(xì)，能夠根據(jù)詳細(xì)設(shè)計報告進(jìn)行編碼。3.3.2 特例如果軟件系統(tǒng)比較簡單，層次較少，可以不必進(jìn)行專門的詳細(xì)設(shè)計，而和概要設(shè)計結(jié)合起來。3.3.3 詳細(xì)設(shè)計的要求a一致性詳細(xì)設(shè)計的要求應(yīng)該與需求分析報告所描述的需求、與概要設(shè)計一致。同時，詳細(xì)設(shè)計的各項要求之間也應(yīng)該是一致的。b合理性詳細(xì)設(shè)計所提出的設(shè)計方法和標(biāo)準(zhǔn)應(yīng)該是

12、合理的、恰當(dāng)?shù)?。c可追蹤性對詳細(xì)設(shè)計所提出的各項要求應(yīng)該可以得到它的清晰的源流，即可在需求分析報告、概要設(shè)計報告中有明確的需求描述。d可行性根據(jù)詳細(xì)設(shè)計進(jìn)行編碼、測試、操作和維護(hù)應(yīng)該是可行的。3.3.4 數(shù)據(jù)庫設(shè)計如果軟件產(chǎn)品需要使用到數(shù)據(jù)庫，軟件的詳細(xì)設(shè)計應(yīng)包括對數(shù)據(jù)庫的設(shè)計。數(shù)據(jù)庫設(shè)計應(yīng)在軟件的需求分析、概要設(shè)計完成之后、詳細(xì)設(shè)計的其它工作之前進(jìn)行。在進(jìn)行數(shù)據(jù)庫設(shè)計時，應(yīng)當(dāng)按照山西電力科學(xué)研究所制定的山西電力科學(xué)研究所信息化數(shù)據(jù)庫建設(shè)規(guī)范要求進(jìn)行。3.3.5 詳細(xì)設(shè)計的評審在軟件詳細(xì)設(shè)計完成后，軟件開發(fā)者應(yīng)向山西電力科學(xué)研究所提交軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告和軟件系統(tǒng)詳細(xì)設(shè)計報告。在山西電力科學(xué)

13、研究所對軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告、軟件系統(tǒng)詳細(xì)設(shè)計報告評審?fù)ㄟ^后，即可進(jìn)入軟件編碼階段。3.3.6 詳細(xì)設(shè)計格式軟件系統(tǒng)詳細(xì)設(shè)計報告、軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告需按一定的格式進(jìn)行編寫， 具體的軟件系統(tǒng)詳細(xì)設(shè)計報告文檔編寫模板和軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告文檔編寫模 板請見附錄C、附錄D。3.4 軟件的編碼3.4.1 軟件編碼在軟件編碼階段，開發(fā)者根據(jù)軟件系統(tǒng)詳細(xì)設(shè)計報告中對數(shù)據(jù)結(jié)構(gòu)、算法分析和模塊實現(xiàn)等方面的設(shè)計要求，開始具體的編寫程序工作，分別實現(xiàn)各模塊的功能，從而實現(xiàn)對目標(biāo)系統(tǒng)的功能、性能、接口、界面等方面的要求。3.4.2 軟件編碼的要求a模塊化編碼b代碼可讀性c可維護(hù)性d模塊接口標(biāo)準(zhǔn)化e界面風(fēng)格統(tǒng)

14、一e注釋的應(yīng)用3.4.3 編碼的評審為了盡早發(fā)現(xiàn)軟件中的障礙，提高軟件產(chǎn)品的質(zhì)量，開發(fā)者在編碼的過程中應(yīng)該強調(diào)代碼評審工作。將代碼評審報告作為文檔的一部分，提交給山西電力科學(xué)研究所。3.4.4 編程規(guī)范及要求為了提高編程實現(xiàn)的質(zhì)量，軟件的程序設(shè)計必須遵照國家頒布的相關(guān)編程規(guī)范。主要內(nèi)容包括：規(guī)范化的程序內(nèi)部文檔、數(shù)據(jù)結(jié)構(gòu)的詳細(xì)說明、清晰的語句結(jié)構(gòu)、編碼規(guī)范。編碼規(guī)范的內(nèi)容包括命名規(guī)范、界面規(guī)范、提示及幫助信息規(guī)范、熱鍵定義等。其中數(shù)據(jù)庫部分應(yīng)遵守山西電力科學(xué)研究所信息化數(shù)據(jù)庫建設(shè)規(guī)范的要求。在軟件編碼的同時應(yīng)進(jìn)行單元測試。3.5 軟件的測試3.5.1 軟件測試為了盡早發(fā)現(xiàn)軟件產(chǎn)品中的錯誤，從而

15、達(dá)到提高軟件質(zhì)量、降低軟件維護(hù)的費用，開發(fā)者應(yīng)在編碼過程中對各個模塊的程序代碼進(jìn)行單元測試，系統(tǒng)集成時進(jìn)行集成測試，系統(tǒng)集成完成后對整個軟件進(jìn)行系統(tǒng)測試。單元測試是在軟件開發(fā)過程中針對程序模塊進(jìn)行正確性檢驗。集成測試是在單元測試的基礎(chǔ)上，將所有模塊按照設(shè)計要求組裝成系統(tǒng)或子系統(tǒng)，對模塊組裝過程和模塊接口進(jìn)行正確性檢驗。軟件系統(tǒng)測試不僅是檢測軟件的整體行為表 現(xiàn)，從另一個側(cè)面看，也是對軟件開發(fā)設(shè)計的再確認(rèn)。進(jìn)行軟件系統(tǒng)測試工作時。測試主要包括界面測試、可用性測試、功能測試、穩(wěn)定性(強度)測試、性能測試、強壯性(恢復(fù))測試、邏輯性測試、破壞性測試、安全性測試等。開發(fā)者針對單元測試，集成測試，系統(tǒng)測

16、試分別制定測試計劃。集成測試需要根據(jù)需求分析報告和概要設(shè)計制作測試用例，并須經(jīng)過評審。軟件測試按照測試計劃、需求分析報告的要求進(jìn)行，最后形成軟件測試報告。3.5.2 測試計劃在軟件編碼開始之前，開發(fā)者應(yīng)向山西電力科學(xué)研究所提交測試計劃，在軟件交付時，開發(fā)者應(yīng)向山西電力科學(xué)研究所提交軟件測試報告，以確保開發(fā)者的軟件得到了充分的測試。開發(fā)的軟件必須經(jīng)過充分的測試證明其符合設(shè)計要求、運行穩(wěn)定、安全可用方可交付山西電力科學(xué)研究所。3.6 軟件的交付準(zhǔn)備3.6.1 交付清單在軟件測試證明軟件達(dá)到要求后，軟件開發(fā)者應(yīng)向山西電力科學(xué)研究所提交開發(fā)的目標(biāo)安裝程序、數(shù)據(jù)庫的數(shù)據(jù)字典、需求報告、設(shè)計報告、測試報告

17、等雙方合同約定的產(chǎn)物。詳細(xì)給用戶說明安裝軟件對運行環(huán)境的要求、安裝軟件的定義和內(nèi)容、在客戶端、服務(wù)器端及中間件的具體安裝步驟、安裝后的系統(tǒng)配置。包括軟件各項功能的使用流程、操作步驟、相應(yīng)業(yè)務(wù)介紹、特殊提示和注意事項等方面的內(nèi)容，在需要時還應(yīng)舉例說明。3.7 軟件的鑒定驗收3.7.1 軟件的鑒定驗收在軟件開發(fā)完成后，為了確保軟件是按照需求分析的要求進(jìn)行開發(fā)的，保證軟件產(chǎn)品的質(zhì)量，需要對軟件產(chǎn)品進(jìn)行鑒定驗收。在開發(fā)者如期交付軟件后，由山西電力科學(xué)研究所負(fù)責(zé)確定具體的鑒定驗收日期。3.7.2 驗收人員由山西電力科學(xué)研究所組織具有一定的分析、設(shè)計、編程和軟件測試經(jīng)驗的驗收組長和其他專業(yè)人員組成，負(fù)責(zé)整個驗收的計劃、組織工作。3.7.3 驗收具體內(nèi)容驗收內(nèi)容應(yīng)該包括：合法性檢查、文檔檢查、軟件一致性檢查、軟件系統(tǒng)測試與測試結(jié)果評審等幾項工作。合法性檢查檢查軟件開發(fā)工具是否合法、使用的函數(shù)庫、控件、組件是否有合法的發(fā)布許可。文檔檢查檢查開發(fā)者提交的文檔必須齊全，質(zhì)量是否過關(guān)。需要開發(fā)者提供的文檔包括：項目實施計劃；軟件測試計劃(含測試用例)；軟件測試報告；項目