PAGE8PAGE9軟件研發報告目錄1.范圍 32.總體要求 32.1總體功能要求 32.2軟件開發平臺要求 32.3軟件工程的開發實施過程管理要求 32.3.1軟件工程實施過程總體要求 32.3.2軟件工程實施里程碑控制 43.軟件開發 43.1軟件的需求分析 43.1.1需求分析 43.1.2需求分析報告的編制者 53.1.3需求報告評審 53.1.4需求報告格式 53.2軟件的概要設計 53.2.1概要設計 53.2.2編寫概要設計的要求 53.2.3概要設計報告的編寫者 53.2.4概要設計和需求分析、詳細設計之間的關系和區別 53.2.5概要設計的評審 63.2.6概要設計格式 63.3軟件的詳細設計 63.3.1詳細設計 63.3.2特例 63.3.3詳細設計的要求 63.3.4數據庫設計 63.3.5詳細設計的評審 63.3.6詳細設計格式 63.4軟件的編碼 73.4.1軟件編碼 73.4.2軟件編碼的要求 73.4.3編碼的評審 73.4.4編程標準及要求 73.5軟件的測試 73.5.1軟件測試 73.5.2測試方案 73.6軟件的交付準備 83.6.1交付清單 83.7軟件的鑒定驗收 83.7.1軟件的鑒定驗收 83.7.2驗收人員 83.7.3驗收具體內容 83.7.4軟件驗收測試大綱 83.8培訓 83.8.1系統應用培訓 83.8.2系統管理的培訓〔可選〕 9范圍本報告用于指導軟件開發者為山西電力科學研究所開發軟件工程的過程，通過標準軟件工程承擔單位的開發過程到達提高軟件質量，降低維護本錢的目的。開發者應根據本指南進行軟件開發和編制軟件開發文檔。本指南是對軟件工程承擔單位的根本要求。總體要求總體功能要求網絡應用環境以Internet技術為核心。開發者在充分分析需求的根底上，選擇采用B/S結構。軟件系統的數據庫依照山西電力科學研究所信息化數據庫的建設標準進行設計和建設。本指南中沒有規定開發者采用何種具體的軟件工程開發方法，開發者可根據工程具體特點、自身擅長來選擇采用面向過程的方法、面向對象的方法或面向數據的方法，但建議開發商使用面向對象軟件工程的方法。軟件開發平臺要求開發者開發的軟件必須能夠在山西電力科學研究所規定的軟件平臺上正常運行。目前軟件平臺為：數據庫管理系統：SQLServer2023以上版本效勞器：Tomcat6.0以上版本運行環境：JDK1.5以上版本網絡架構：完全支持TCP/IP協議開發工具或技術體系：為保證軟件的上下兼容性，開發者應選擇比較通用的開發工具的較新版本進行開發，如Eclipse、MyEclipse等。軟件工程的開發實施過程管理要求軟件工程實施過程總體要求開發者提交軟件開發工作大綱，山西電力研究所組織專家組對工作大綱進行評審，并提出整改意見。通過評審后，開發者根據整改意見完善工作大綱，經過山西電力科學研究所認可后組織工程組進行軟件開發。軟件開發在開發過程中，開發者需分階段提交相關文檔。在軟件開發工作完成后，開發者應向山西電力科學研究所提交完整的軟件文檔，山西電力科學研究所組織驗收組對軟件進行驗收審查。軟件工程實施里程碑控制山西電力科學研究所將分四個階段進行把關，召開專家審查會。需求分析〔結合原型進行審查〕確認；概要設計、數據庫設計；預驗收〔試運行后〕；正式驗收〔推廣使用后〕。軟件開發工程承擔單位即可組織工程組進行軟件開發工作，軟件開發必須嚴格按照軟件工程的要求進行。開發過程包括開發者的活動和任務。軟件的需求分析需求分析首先，開發者和山西電力科學研究所應共同對山西電力科學研究所的應用需求作充分的調研，提交完整的需求分析報告。在需求分析報告中必須描述的根本問題是：功能、性能、強加于實現的設計限制、屬性、外部接口。應當防止把設計或工程需求寫入需求分析報告中。它必須說明由軟件獲得的結果，而不是獲得這些結果的手段。軟件需求可以用假設干種方法來表達，如通過輸入、輸出說明；使用代表性的例子；用標準化的模型。開發者應盡可能地使用模型的方式，因為這是表達復雜需求的精確和有效的方法。比方用統一建模語言〔UML〕來描述需求。編寫需求分析報告的要求a．無歧義性對最終產品的每一個特性用某一術語描述；假設某一術語在某一特殊的行文中使用時具有多種含義，那么應對該術語的每種含義做出解釋并指出其適用場合。b．完整性需求分析報告應該包括全部有意義的需求，無論是關系到功能的、性能的、設計約束的、還是關系到外部接口方面的需求；對所有可能出現的輸入數據的響應予以定義，要對合法和非合法的輸入值的響應做出規定；填寫全部插圖、表、圖示標記等；定義全部術語和度量單位。c．可驗證性需求分析報告描述的每一個需求應是可以驗證的。可以通過一個有限處理過程來檢查軟件產品是否滿足需求。d．一致性在需求分析報告中的各個需求的描述不能互相矛盾。e．可修改性需求分析報告應具有一個有條不紊、易于使用的內容組織；沒有冗余，即同一需求不能在需求分析報告中出現屢次。f．可追蹤性每一個需求的源流必須清晰，在進一步產生和改變文件編制時，可以方便地引證每一個需求。g．運行和維護階段的可使用性需求分析報告必須滿足運行和維護階段的需要。在需求分析報告要寫明功能的來源和目的。需求分析報告的編制者需求分析報告應由山西電力科學研究所和開發者雙方共同完成。其中：山西電力科學研究所負責根據實際需要提出希望軟件實現的功能；軟件開發者根據山西電力科學研究所提出的性能需求，結合軟件開發編寫需求分析。需求報告評審在軟件需求分析工作完成后，軟件開發者應向山西電力科學研究所提交?軟件需求分析報告?。山西電力科學研究所組織有關人員對需求進行評審，以決定軟件需求是否完善和恰當。評審完成后，就可以進入軟件的設計階段。需求報告格式?軟件需求分析報告?需按一定的格式進行編寫，具體的?軟件需求分析報告?文檔編寫模板請見附錄A。軟件的概要設計概要設計在山西電力科學研究所和開發者雙方認可的需求分析根底上，開發者進行下——步的工作。首先，開發者需要對軟件系統進行概要設計，即系統設計。概要設計需要對軟件系統的設計進行考慮，包括系統的根本處理流程、系統的組織結構、模塊劃分、功能分配、接口設計、運行設計、數據結構設計和出錯處理設計等，為軟件的詳細設計提供根底。編寫概要設計的要求a．一致性概要設計的要求應該與需求分析報告所描述的需求一致。同時，概要設計的各項要求之間也應該一致。b．合理性概要設計所提出的設計方法和標準應該是合理的、恰當的。c．可追蹤性對概要設計所提出的各項要求應該可以得到它的清晰的源流，即在需求分析報告客戶有明確的需求描述。d．可行性根據概要設計進行詳細設計、操作和維護應該是可行的。概要設計報告的編寫者概要設計報告由開發者根據需求分析報告的要求進行編寫。概要設計和需求分析、詳細設計之間的關系和區別需求分析不涉及具體的技術實現，而概要設計注重于從宏觀上和框架上來描述采用何種技術手段、方法來實現這些需求。詳細設計相對概要設計更注重于微觀上和框架內的設計，是編碼的依據。概要設計是指導詳細設計的依據。概要設計的評審在軟件概要設計工作完成后，軟件開發者應向交通提交軟件系統概要設計報告。在山西電力科學研究所對概要設計報告評審通過后，即可進入詳細設計階段。概要設計格式軟件系統概要設計報告需按一定的格式進行編寫。軟件的詳細設計詳細設計在概要設計的根底上，開發者需要進行軟件系統的詳細設計。在詳細設計中，描述實現具體模塊所涉及到的主要算法、數據結構、類的層次結構及調用關系，需要說明軟件系統各個層次中的每一個程序(每個模塊或子程序)的設計考慮，以便進行編碼和測試。應當保證軟件的需求完全分配給整個軟件。詳細設計應當足夠詳細，能夠根據詳細設計報告進行編碼。特例如果軟件系統比較簡單，層次較少，可以不必進行專門的詳細設計，而和概要設計結合起來。詳細設計的要求a．一致性詳細設計的要求應該與需求分析報告所描述的需求、與概要設計一致。同時，詳細設計的各項要求之間也應該是一致的。b．合理性詳細設計所提出的設計方法和標準應該是合理的、恰當的。c．可追蹤性對詳細設計所提出的各項要求應該可以得到它的清晰的源流，即可在需求分析報告、概要設計報告中有明確的需求描述。d．可行性根據詳細設計進行編碼、測試、操作和維護應該是可行的。數據庫設計如果軟件產品需要使用到數據庫，軟件的詳細設計應包括對數據庫的設計。數據庫設計應在軟件的需求分析、概要設計完成之后、詳細設計的其它工作之前進行。在進行數據庫設計時，應當按照山西電力科學研究所制定的?山西電力科學研究所信息化數據庫建設標準?要求進行。詳細設計的評審在軟件詳細設計完成后，軟件開發者應向山西電力科學研究所提交?軟件系統數據庫設計報告?和?軟件系統詳細設計報告?。在山西電力科學研究所對?軟件系統數據庫設計報告?、?軟件系統詳細設計報告?評審通過后，即可進入軟件編碼階段。詳細設計格式?軟件系統詳細設計報告?、?軟件系統數據庫設計報告?需按一定的格式進行編寫，具體的?軟件系統詳細設計報告?文檔編寫模板和?軟件系統數據庫設計報告?文檔編寫模板請見附錄C、附錄D。軟件的編碼軟件編碼在軟件編碼階段，開發者根據軟件系統詳細設計報告中對數據結構、算法分析和模塊實現等方面的設計要求，開始具體的編寫程序工作，分別實現各模塊的功能，從而實現對目標系統的功能、性能、接口、界面等方面的要求。軟件編碼的要求a．模塊化編碼b．代碼可讀性c．可維護性d．模塊接口標準化e．界面風格統一e．注釋的應用編碼的評審為了盡早發現軟件中的障礙，提高軟件產品的質量，開發者在編碼的過程中應該強調代碼評審工作。將代碼評審報告作為文檔的一局部，提交給山西電力科學研究所。編程標準及要求為了提高編程實現的質量，軟件的程序設計必須遵照國家公布的相關編程標準。主要內容包括：標準化的程序內部文檔、數據結構的詳細說明、清晰的語句結構、編碼標準。編碼標準的內容包括命名標準、界面標準、提示及幫助信息標準、熱鍵定義等。其中數據庫局部應遵守山西電力科學研究所信息化數據庫建設標準的要求。在軟件編碼的同時應進行單元測試。軟件的測試軟件測試為了盡早發現軟件產品中的錯誤，從而到達提高軟件質量、降低軟件維護的費用，開發者應在編碼過程中對各個模塊的程序代碼進行單元測試，系統集成時進行集成測試，系統集成完成后對整個軟件進行系統測試。單元測試是在軟件開發過程中針對程序模塊進行正確性檢驗。集成測試是在單元測試的根底上，將所有模塊按照設計要求組裝成系統或子系統，對模塊組裝過程和模塊接口進行正確性檢驗。軟件系統測試不僅是檢測軟件的整體行為表現，從另一個側面看，也是對軟件開發設計的再確認。進行軟件系統測試工作時。測試主要包括界面測試、可用性測試、功能測試、穩定性(強度)測試、性能測試、強壯性(恢復)測試、邏輯性測試、破壞性測試、平安性測試等。開發者針對單元測試，集成測試，系統測試分別制定測試方案。集成測試需要根據需求分析報告和概要設計制作測試用例，并須經過評審。軟件測試按照測試方案、需求分析報告的要求進行，最后形成軟件測試報告。測試方案在軟件編碼開始之前，開發者應向山西電力科學研究所提交測試方案，在軟件交付時，開發者應向山西電力科學研究所提交軟件測試報告，以確保開發者的軟件得到了充分的測試。開發的軟件必須經過充分的測試證明其符合設計要求、運行穩定、平