軟件開發(fā)需求

1、軟件開發(fā)需求軟件開發(fā)需求76/76軟件開發(fā)需求目錄1.范圍12.總體要求12.1總體功能要求12.2軟件開發(fā)平臺要求12.3軟件項目的開發(fā)實施過程管理要求2軟件項目實施過程總體要求2軟件項目實施更改要求2軟件項目實施里程碑控制23.軟件開發(fā)33.1軟件的需求解析3需求解析3需求解析報告的編制者3需求報告評審4需求報告格式43.2軟件的大綱設(shè)計4大綱設(shè)計4編寫大綱設(shè)計的要求4大綱設(shè)計報告的編寫者4大綱設(shè)計和需求解析、詳盡設(shè)計之間的關(guān)系和區(qū)別4大綱設(shè)計的評審4大綱設(shè)計格式43.3軟件的詳盡設(shè)計4詳盡設(shè)計4特例5詳盡設(shè)計的要求5數(shù)據(jù)庫設(shè)計5詳盡設(shè)計的評審5詳盡設(shè)計格式53.4軟件的編碼5軟件編碼5軟

2、件編碼的要求5編碼的評審5編程規(guī)范及要求63.5軟件的測試6軟件測試6測試計劃63.6軟件的交付準(zhǔn)備6交付清單63.7軟件的判斷查收63.7.1軟件的判斷查收63.7.2查收人員73.7.3查收詳盡內(nèi)容73.7.4軟件查收測試大綱73.8培訓(xùn)73.8.1系統(tǒng)應(yīng)用培訓(xùn)73.8.2系統(tǒng)管理的培訓(xùn)（可選）7附錄A軟件需求解析報告文檔模板9附錄B軟件大綱設(shè)計報告文檔模板21附錄C軟件詳盡設(shè)計報告文檔模板33附錄D軟件數(shù)據(jù)庫設(shè)計報告文檔模板43附錄E軟件測試(查收)大綱錯誤!未定義書簽。5范圍本指南用于指導(dǎo)軟件開發(fā)者為的過程，經(jīng)過規(guī)范軟件項目擔(dān)當(dāng)單位的開發(fā)過程達(dá)到提高軟件質(zhì)量，降低維護成本的目的。開發(fā)者

3、應(yīng)根據(jù)本指南進行軟件開發(fā)和編制軟件開發(fā)文檔。本指南是對軟件項目擔(dān)當(dāng)單位的基本要求。在本指南的附錄A至E中提供了文檔的編寫模板供開發(fā)者參照，在進行詳盡軟件開發(fā)時，開發(fā)者可根據(jù)實際情況采編寫，但必須提供雙方約定的文檔，文檔中約定的內(nèi)容必須描繪清楚?？傮w要求2.1總體功能要求網(wǎng)絡(luò)應(yīng)用環(huán)境以Internet/Intranet技術(shù)為核心。開發(fā)者應(yīng)在充分解析需求的基礎(chǔ)上，選擇采用B/S結(jié)構(gòu)也許C/S結(jié)構(gòu)。軟件系統(tǒng)的數(shù)據(jù)庫應(yīng)依據(jù)規(guī)范進行設(shè)計和建設(shè)。本指南中沒有規(guī)定開發(fā)者采用何種詳盡的軟件工程開發(fā)方法，開發(fā)者可根據(jù)項目詳盡特點、自己擅長來選擇采用面向過程的方法、面向?qū)ο蟮姆椒ɑ蛎嫦驍?shù)據(jù)的方法，但建議開發(fā)商使用

4、面向?qū)ο筌浖こ痰姆椒?，如：采用?dāng)前被廣泛使用的RUP(RationalUnifiedProcess)方法來進行解析、設(shè)計和開發(fā)。2.2軟件開發(fā)平臺要求開發(fā)者開發(fā)的軟件必須可以在規(guī)定的軟件平臺上正常運行。當(dāng)前軟件平臺為：數(shù)據(jù)庫管理系統(tǒng)：Oracle9i以上版本中間件(應(yīng)用服務(wù)器)系統(tǒng)：IBMWebSphereOA系統(tǒng)：LotusDomino/Notes網(wǎng)絡(luò)架構(gòu)：完全支持TCP/IP協(xié)議開發(fā)工具或技術(shù)體系：為保證軟件的上下兼容性，開發(fā)者應(yīng)選擇比較通用的開發(fā)工具的較新版本進行開發(fā)，如MicrosoftVisualStudio.Net，BorlandDelphi，C+Builder,或J2EE(Ja

5、va2P1atformEnterpriseEdition)2.3軟件項目的開發(fā)實施過程管理要求2.3.1軟件項目實施過程總體要求（一）開發(fā)者提交軟件開發(fā)工作大綱，交通局組織專家組對工作大綱進行評審，并提出整改建議。（二）經(jīng)過評審后，開發(fā)者根據(jù)整改建議完善工作大綱，經(jīng)過交通局認(rèn)可后組織項目組進行軟件開發(fā)。軟件開發(fā)工作按照需求解析、大綱設(shè)計、詳盡設(shè)計、編碼、測試等幾個階段進行，在開發(fā)過程中，開發(fā)者需分階段提交相關(guān)文檔。（三）在軟件開發(fā)工作完成后，開發(fā)者應(yīng)向交通局提交完整的軟件文檔，交通局組織查收組對軟件進行查收審查。2.3.2軟件項目實施更改要求在開發(fā)過程中，需求或設(shè)計不可防備地需要發(fā)生更改，相關(guān)

6、更改必須經(jīng)過交通局書面同意方可進行。在需求或設(shè)計發(fā)生更改時，需要對原有文檔進行更正，并提供完整的更改記錄，以使更改處于可控制的狀態(tài)。更改單如下表所示：申請更改的需求文檔更改的內(nèi)客及其原因評估需求更改將對項目造成的影響申請人簽字表2-1更改單需求更改申請輸入名稱，版本，日期等信息項目經(jīng)理簽字更改申請的審批建議審批建議：簽字日期客戶簽字審批建議：(合同項目)簽字日期更改需求文檔更改后的輸入名稱，版本，完成日期等信息需求文檔更改人簽字重新評審需求文檔需求評審小組簽字評審建議：簽字日期更改結(jié)束項目經(jīng)理簽字簽字日期2.3.3軟件項目實施里程碑控制交通局將分四個階段進行把關(guān)，召開專家審查會。（一）需求解析

7、（結(jié)合原型進行審查）確認(rèn)；（二）大綱設(shè)計+數(shù)據(jù)庫設(shè)計；（三）預(yù)查收（試運行后）；（四）正式查收（推廣使用后）。軟件開發(fā)合同簽署今后，項目擔(dān)當(dāng)單位即可組織項目組進行軟件開發(fā)工作。軟件開發(fā)必須嚴(yán)格按照軟件工程的要求進行。開發(fā)過程包括開發(fā)者的活動和任務(wù)。此過程由軟件需求解析、大綱設(shè)計、詳盡設(shè)計、編碼、測試、查收、判斷等活動組成。3.1軟件的需求解析3.1.1需求解析首先，開發(fā)者和交通局應(yīng)共同對交通局的應(yīng)用需求作充分的調(diào)研，提交完整的需求解析報告。在需求解析報告中必須描繪的基本問題是：功能、性能、強加于實現(xiàn)的設(shè)計限制、屬性、外部接口。應(yīng)該防備把設(shè)計或項目需求寫入需求解析報告中。它必須說明由軟件獲得的結(jié)

8、果，而不是獲得這些結(jié)果的手段。軟件需求可以用若干種方法來表達(dá)，如經(jīng)過輸入、輸出說明；使用代表性的例子；用規(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)做出規(guī)定；填寫全

9、部插圖、表、圖示標(biāo)記等；定義全部術(shù)語和胸襟單位。c可考據(jù)性需求解析報告描繪的每一個需求應(yīng)是可以考據(jù)的?？梢越?jīng)過一個有限辦理過程來檢查軟件產(chǎn)品是否知足需求。d一致性在需求解析報告中的各個需求的描繪不能互相矛盾。e可更正性需求解析報告應(yīng)擁有一個有條不紊、易于使用的內(nèi)容組織；沒有冗余，即同一需求不能在需求解析報告中出現(xiàn)多次。f可追蹤性每一個需求的源流必須清晰，在進一步產(chǎn)生和改變文件編制時，可以方便地引證每一個需求。g運行和維護階段的可使用性需求解析報告必須知足運行和維護階段的需要。在需求解析報告要寫明功能的本源和目的。3.1.2需求解析報告的編制者需求解析報告應(yīng)由交通局和開發(fā)者雙方共同完成。其中：交

10、通局負(fù)責(zé)根據(jù)實際需要提出希望軟件實現(xiàn)的功能；軟件開發(fā)者根據(jù)交通局提出的性能需求，結(jié)合軟件開發(fā)編寫需求解析。3.1.3需求報告評審在軟件需求解析工作完成后，軟件開發(fā)者應(yīng)向交通局提交軟件需求解析報告。交通局組織相關(guān)人員對需求進行評審，以決定軟件需求是否完善和適合。評審?fù)瓿珊?，就可以進入軟件的設(shè)計階段。3.1.4需求報告格式軟件需求解析報告需按一定的格式進行編寫，寫模板請見附錄A。詳盡的軟件需求解析報告文檔編3.2軟件的大綱設(shè)計3.2.1大綱設(shè)計在交通局和開發(fā)者雙方認(rèn)可的需求解析報告基礎(chǔ)上，開發(fā)者進行下步的工作。首先，開發(fā)者需要對軟件系統(tǒng)進行大綱設(shè)計，即系統(tǒng)設(shè)計。大綱設(shè)計需要對軟件系統(tǒng)的設(shè)計進行考慮

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

12、設(shè)計之間的關(guān)系和區(qū)別需求解析不涉及詳盡的技術(shù)實現(xiàn)，而大綱設(shè)計著重于從宏觀上和框架上來描繪采用何種技術(shù)手段、方法來實現(xiàn)這些需求。詳盡設(shè)計相對大綱設(shè)計更著重于微觀上和框架內(nèi)的設(shè)計，是編碼的依據(jù)。大綱設(shè)計是指導(dǎo)詳盡設(shè)計的依據(jù)。3.2.5大綱設(shè)計的評審在軟件大綱設(shè)計工作完成后，軟件開發(fā)者應(yīng)向交通提交軟件系統(tǒng)大綱設(shè)計報告交通局對大綱設(shè)計報告評審?fù)ㄟ^后，即可進入詳盡設(shè)計階段。在3.2.6大綱設(shè)計格式軟件系統(tǒng)大綱設(shè)計報告需按一定的格式進行編寫，詳盡的軟件系統(tǒng)大綱設(shè)計報告文檔編寫模板請見附錄B。3.3軟件的詳盡設(shè)計3.3.1詳盡設(shè)計在大綱設(shè)計的基礎(chǔ)上，開發(fā)者需要進行軟件系統(tǒng)的詳盡設(shè)計。在詳盡設(shè)計中，描繪實現(xiàn)詳

13、盡模塊所涉及到的主要算法、數(shù)據(jù)結(jié)構(gòu)、類的層次結(jié)構(gòu)及調(diào)用關(guān)系，需要說明軟件系統(tǒng)各個層次中的每一個程序(每個模塊或子程序)的設(shè)計考慮，以便進行編碼和測試。應(yīng)該保證軟件的需求完全分配給整個軟件。詳盡設(shè)計應(yīng)該足夠詳盡，可以根據(jù)詳盡設(shè)計報告進行編碼。3.3.2特例如果軟件系統(tǒng)比較簡單，層次較少，可以不必進行特意的詳盡設(shè)計，而和大綱設(shè)計結(jié)合起來。3.3.3詳盡設(shè)計的要求a一致性詳盡設(shè)計的要求應(yīng)該與需求解析報告所描繪的需求、與大綱設(shè)計一致。同時，詳盡設(shè)計的各項要求之間也應(yīng)該是一致的。b合理性詳盡設(shè)計所提出的設(shè)計方法和標(biāo)準(zhǔn)應(yīng)該是合理的、適合的。c可追蹤性對詳盡設(shè)計所提出的各項要求應(yīng)該可以獲得它的清晰的源流，即

14、可在需求解析報告、概要設(shè)計報告中有明確的需求描繪。d可行性根據(jù)詳盡設(shè)計進行編碼、測試、操作和維護應(yīng)該是可行的。3.3.4數(shù)據(jù)庫設(shè)計如果軟件產(chǎn)品需要使用到數(shù)據(jù)庫，軟件的詳盡設(shè)計應(yīng)包括對數(shù)據(jù)庫的設(shè)計。數(shù)據(jù)庫設(shè)計應(yīng)在軟件的需求解析、大綱設(shè)計完成之后、詳盡設(shè)計的其余工作從前進行。在進行數(shù)據(jù)庫設(shè)計時，應(yīng)該按照交通局?jǐn)M定的*市交通局信息化數(shù)據(jù)庫建設(shè)規(guī)范要求進行。3.3.5詳盡設(shè)計的評審在軟件詳盡設(shè)計完成后，軟件開發(fā)者應(yīng)向交通局提交軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告和軟件系統(tǒng)詳盡設(shè)計報告。在交通局對軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告、軟件系統(tǒng)詳盡設(shè)計報告評審?fù)ㄟ^后，即可進入軟件編碼階段。3.3.6詳盡設(shè)計格式軟件系統(tǒng)詳盡設(shè)計報告、

15、軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告需按一定的格式進行編寫，詳盡的軟件系統(tǒng)詳盡設(shè)計報告文檔編寫模板和軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告文檔編寫模板請見附錄C、附錄D。3.4軟件的編碼3.4.1軟件編碼在軟件編碼階段，開發(fā)者根據(jù)軟件系統(tǒng)詳盡設(shè)計報告中對數(shù)據(jù)結(jié)構(gòu)、算法解析和模塊實現(xiàn)等方面的設(shè)計要求，開始詳盡的編寫程序工作，分別實現(xiàn)各模塊的功能，進而實現(xiàn)對目標(biāo)系統(tǒng)的功能、性能、接口、界面等方面的要求。3.4.2軟件編碼的要求a模塊化編碼b代碼可讀性c可維護性d模塊接口標(biāo)準(zhǔn)化e界面風(fēng)格統(tǒng)一e說明的應(yīng)用3.4.3編碼的評審為了盡早發(fā)現(xiàn)軟件中的障礙，提高軟件產(chǎn)品的質(zhì)量，開發(fā)者在編碼的過程中應(yīng)該強調(diào)代碼評審工作。將代碼評審報告作為文

16、檔的一部分，提交給交通局。3.4.4編程規(guī)范及要求為了提高編程實現(xiàn)的質(zhì)量，軟件的程序設(shè)計必須遵照國家宣布的相關(guān)編程規(guī)范。主要內(nèi)容包括：規(guī)范化的程序內(nèi)部文檔、數(shù)據(jù)結(jié)構(gòu)的詳盡說明、清晰的語句結(jié)構(gòu)、編碼規(guī)范。編碼規(guī)范的內(nèi)容包括命名規(guī)范、界面規(guī)范、提示及幫助信息規(guī)范、熱鍵定義等。其中數(shù)據(jù)庫部分應(yīng)遵守*市交通局信息化數(shù)據(jù)庫建設(shè)規(guī)范的要求。在軟件編碼的同時應(yīng)進行單元測試。3.5軟件的測試3.5.1軟件測試為了盡早發(fā)現(xiàn)軟件產(chǎn)品中的錯誤，進而達(dá)到提高軟件質(zhì)量、降低軟件維護的費用，開發(fā)者應(yīng)在編碼過程中對各個模塊的程序代碼進行單元測試，系統(tǒng)集成時進行集成測試，系統(tǒng)集成完成后對整個軟件進行系統(tǒng)測試。單元測試是在軟件

17、開發(fā)過程中針對程序模塊進行正確性查驗。集成測試是在單元測試的基礎(chǔ)上，將所有模塊按照設(shè)計要求組裝成系統(tǒng)或子系統(tǒng)，對模塊組裝過程和模塊接口進行正確性查驗。軟件系統(tǒng)測試不單是檢測軟件的整體行為表現(xiàn)，從另一個側(cè)面看，也是對軟件開發(fā)設(shè)計的再確認(rèn)。進行軟件系統(tǒng)測試工作時。測試主要包括界面測試、可用性測試、功能測試、穩(wěn)定性(強度)測試、性能測試、強壯性(恢復(fù))測試、邏輯性測試、破壞性測試、安全性測試等。開發(fā)者針對單元測試，集成測試，系統(tǒng)測試分別擬定測試計劃。集成測試需要根據(jù)需求解析報告和大綱設(shè)計制作測試用例，并須經(jīng)過評審。軟件測試按照測試計劃、需求解析報告的要求進行，最后形成軟件測試報告。3.5.2測試計劃

18、在軟件編碼開始從前，開發(fā)者應(yīng)向交通局提交測試計劃，在軟件交付時，開發(fā)者應(yīng)向交通局提交軟件測試報告，以保證開發(fā)者的軟件獲得了充分的測試。開發(fā)的軟件必須經(jīng)過充分的測試證明其吻合設(shè)計要求、運行穩(wěn)定、安全可用方可交付交通局。3.6軟件的交付準(zhǔn)備3.6.1交付清單在軟件測試證明軟件達(dá)到要求后，軟件開發(fā)者應(yīng)向交通局提交開發(fā)的目標(biāo)安裝程序、據(jù)庫的數(shù)據(jù)字典、用戶安裝手冊、用戶使用指南、需求報告、設(shè)計報告、測試報告等雙方合同約定的產(chǎn)物。用戶安裝手冊應(yīng)詳盡介紹安裝軟件對運行環(huán)境的要求、安裝軟件的定義和內(nèi)容、客戶端、服務(wù)器端及中間件的詳盡安裝步驟、安裝后的系統(tǒng)配置。數(shù)在用戶使用指南應(yīng)包括軟件各項功能的使用流程、操作

19、步驟、相應(yīng)業(yè)務(wù)介紹、特殊提示和注意事項等方面的內(nèi)容，在需要時還應(yīng)舉例說明。3.7軟件的判斷查收3.7.1軟件的判斷查收在軟件開發(fā)完成后，為了保證軟件是按照需求解析的要求進行開發(fā)的，保證軟件產(chǎn)品的質(zhì)量，需要對軟件產(chǎn)品進行判斷查收。在開發(fā)者如期交付軟件后，由交通局負(fù)責(zé)確定詳盡的判斷查收日期。3.7.2查收人員由交通局邀請擁有一定的解析、設(shè)計、編程和軟件測試經(jīng)驗的查收組長和其他專業(yè)人員組成。查收組設(shè)組長一名(可設(shè)有副組長)，負(fù)責(zé)整個查收的計劃、組織工作。3.7.3查收詳盡內(nèi)容查收內(nèi)容應(yīng)該包括：合法性檢查、文檔檢查、軟件一致性檢查、軟件系統(tǒng)測試與測試結(jié)果評審等幾項工作。合法性檢查檢查軟件開發(fā)工具是否合

20、法、使用的函數(shù)庫、控件、組件是否有合法的發(fā)布許可。文檔檢查檢查開發(fā)者提交的文檔必須齊全，質(zhì)量是否過關(guān)。需要開發(fā)者提供的文檔包括：項目實施計劃；詳盡技術(shù)方案；軟件需求規(guī)格說明書(STP)(含數(shù)據(jù)字典)；大綱設(shè)計說明書(PDD)；詳盡設(shè)計說明書(DDD)(含數(shù)據(jù)庫設(shè)計說明書)；軟件測試計劃(STP)(含測試用例)；軟件測試報告(STR)；用戶手冊(SUM)(含操作、使用、維護、應(yīng)急辦理手冊)；源程序(SCL)(不可更正的電子文檔)；項目實施計劃(PIP)；項目開發(fā)總結(jié)(PDS)；軟件質(zhì)量保證計劃(SQAP)；其他，查收組可以根據(jù)需要對其余文檔(如軟件配置計劃、項目進展報表、階段評審報表等)進行檢查

21、。文檔的質(zhì)量根據(jù)完備性、正確性、簡短性、可追蹤性、自說明性、規(guī)范件等方面進行蹤合評定。查收需要對軟件代碼進行檢查，以保證其吻合規(guī)范，并檢查其一致性。3.7.4軟件查收測試大綱在軟件進行判斷查收前，開發(fā)者需按照一定的格式編寫軟件查收測試大綱，詳盡的格式請見附錄E。3.8培訓(xùn)3.8.1系統(tǒng)應(yīng)用培訓(xùn)主要培訓(xùn)內(nèi)容包括：系統(tǒng)操作使用、業(yè)務(wù)管理流程。培訓(xùn)對象：應(yīng)用操作人員。3.8.2系統(tǒng)管理的培訓(xùn)（可選）主要培訓(xùn)內(nèi)容包括：系統(tǒng)安裝、調(diào)試、維護；系統(tǒng)管理。培訓(xùn)對象：系統(tǒng)管理人員。開發(fā)者應(yīng)詳盡列出培訓(xùn)計劃，包括培訓(xùn)內(nèi)容、教材、時間和人員等。附錄A軟件需求解析報告文檔模板1.引言91.1編寫目的91.2項目風(fēng)險

22、91.3文檔約定91.4預(yù)期讀者和閱讀建議91.5產(chǎn)品范圍101.6參照文件102.綜合描繪102.1產(chǎn)品的狀況102.2產(chǎn)品的功能112.3用戶類和特性112.4運行環(huán)境112.5設(shè)計和實現(xiàn)上的限制112.6假設(shè)和拘束(依賴)123.外部接口需求123.1用戶界面133.2硬件接口133.3軟件接口133.4通訊接口144.系統(tǒng)功能需求144.1說明和優(yōu)先級154.2激勵響應(yīng)序列154.3輸入輸出數(shù)據(jù)155.其余非功能需求155.1性能需求155.2安全舉措需求165.3安全性需求165.4軟件質(zhì)量屬性165.5業(yè)務(wù)規(guī)則165.6用戶文檔166.詞匯表177.數(shù)據(jù)定義178.解析模型189.

23、待定問題列表18引言引言是對這份軟件產(chǎn)品需求解析報告的概覽，是為了幫助閱讀者認(rèn)識這份文檔是怎樣編寫的，并且應(yīng)該怎樣閱讀、理解和解釋這份文檔。1.1編寫目的說明這份軟件產(chǎn)品需求解析報告是為哪個軟件產(chǎn)品編寫的，開發(fā)這個軟件產(chǎn)品意義、用、以及最終要達(dá)到的意圖。經(jīng)過這份軟件產(chǎn)品需求解析報告詳盡說了然該軟件產(chǎn)品的需求規(guī)格，包括修正和(或)刊行版本號，進而對該軟件產(chǎn)品進行正確的定義。如果這份軟件產(chǎn)品需求解析報告只與整個系統(tǒng)的某一部分相關(guān)系，那么只定義軟件產(chǎn)品需求解析報告中說明的那個部分或子系統(tǒng)。作1.2項目風(fēng)險詳盡說明本軟件開發(fā)項目的全部風(fēng)險擔(dān)當(dāng)者，以及各自在本階段所需要擔(dān)當(dāng)?shù)闹饕L(fēng)險，首要風(fēng)險擔(dān)當(dāng)者包括

24、：任務(wù)提出者；軟件開發(fā)者；產(chǎn)品使用者。1.3文檔約定描繪編寫文檔時所采用的標(biāo)準(zhǔn)(如果有標(biāo)準(zhǔn)的話)，也許各種排版約定。排版約定應(yīng)該包括：正文風(fēng)格；提示方式；重要符號；也應(yīng)該說明高層次需求是否可以被其所有細(xì)化的需求所繼承，也許每個需求陳述是否都有其自己的優(yōu)先級。1.4預(yù)期讀者和閱讀建議列舉本軟件產(chǎn)品需求解析報告所針對的各種不同的預(yù)期讀者，比方，可能包括：用戶；開發(fā)人員；項目經(jīng)理；營銷人員；測試人員；文檔編寫入員。并且描繪了文檔中，其余部分的內(nèi)容及其組織結(jié)構(gòu)，并且針對每一類讀者提出最適合的文檔閱讀建議。1.5產(chǎn)品范圍說明該軟件產(chǎn)品及其開發(fā)目的的簡短描繪，包括利益和目標(biāo)。把軟件產(chǎn)品開發(fā)與企業(yè)目標(biāo)，也許

25、業(yè)務(wù)策略相聯(lián)系。描繪產(chǎn)品范圍時需注意，可以參照項目視圖和范圍文檔，但是不能將其內(nèi)容復(fù)制到這里。1.6參照文件列舉編寫軟件產(chǎn)品需求解析報告時所用到的參照文件及資料，可能包括：本項目的合同書；上級機關(guān)相關(guān)本項目的批文；本項目已經(jīng)批準(zhǔn)的計劃任務(wù)書；用戶界面風(fēng)格指導(dǎo)；開發(fā)本項目時所要用到的標(biāo)淮；系統(tǒng)規(guī)格需求說明；使用實例文檔；屬于本項目的其余己發(fā)表文件；本軟件產(chǎn)品需求解析報告中所引用的文件、資料；相關(guān)軟件產(chǎn)品需求解析報告；為了方便讀者查閱，所有參照資料應(yīng)該按一定序次排列。如果可能，每份資料都應(yīng)該給出：標(biāo)題名稱；作者也許合同簽約者；文件編號也許版本號；發(fā)表日期也許簽約日期；出版單位也許資料本源。綜合描繪

26、這一部分歸納了正在定義的軟件產(chǎn)品的作用范圍以及該軟件產(chǎn)品所運行的環(huán)境、使用該軟件產(chǎn)品的用戶、對該軟件產(chǎn)品己知的限制、相關(guān)該軟件產(chǎn)品的假設(shè)和依賴。2.1產(chǎn)品的狀況描繪了在軟件產(chǎn)品需求解析報告中所定義的軟件產(chǎn)品的背景和起源。說了然該軟件產(chǎn)品是否屬于下列情況：是否是產(chǎn)品系列中的下一成員；是否是成熟產(chǎn)品所改進的下一代產(chǎn)品；是否是現(xiàn)有應(yīng)用軟件的替代品(升級產(chǎn)品)；是否是一個新型的、自主型的產(chǎn)品。如果該軟件產(chǎn)品需求解析報告定義的軟件系統(tǒng)是：大系統(tǒng)的一個組成部分；與其余系統(tǒng)和其余機構(gòu)之間存在基本的相互關(guān)系。那么必須說明軟件產(chǎn)品需求解析報告定義的這部分軟件是怎樣與整個大系統(tǒng)相關(guān)系的，也許（同時）說明相互關(guān)系的

27、存在形式，并且要定義出兩者之間的全部接口。2.2產(chǎn)品的功能因為將在需求解析報告的第4部分中詳盡描繪軟件產(chǎn)品的功能，所以在此只需要大體地總結(jié)。僅從業(yè)務(wù)層面陳述本軟件產(chǎn)品所應(yīng)擁有的主要功能，在描繪功能時應(yīng)該針對每一項需求正確地描繪其各項規(guī)格說明。如果存在引起誤解的可能，在陳述本軟件產(chǎn)品主要功能的作用領(lǐng)域時，也需要對應(yīng)陳述本軟件產(chǎn)品的非作用領(lǐng)域，以利讀者理解本軟件產(chǎn)品。為了很好地組織產(chǎn)品功能，使每個讀者都容易理解，可以采用列表的方法給出。也可以采用圖形方式，將主要的需求分組以及它們之間的聯(lián)系使用數(shù)據(jù)流程圖的頂層圖或類圖進行表示，這種表示方法是很有用的。參照用戶當(dāng)前管理組織構(gòu)架，認(rèn)識各個機構(gòu)的主要職能

28、，將有助于陳述軟件產(chǎn)品的主要功能。2.3用戶類和特性確定有可能使用該軟件產(chǎn)品的不同用戶類，并且描繪它們相關(guān)的特點。往往有一些軟件需求，只與特定的用戶類相關(guān)。描繪時，應(yīng)該將該軟件產(chǎn)品的重要用戶類與非重要用戶類區(qū)分開。用戶不一定是軟件產(chǎn)品的直接使用者，經(jīng)過報表、應(yīng)用程序接口、系統(tǒng)硬件接口獲得軟件產(chǎn)品的數(shù)據(jù)和服務(wù)的人、也許機構(gòu)也有他們的需求。所以，應(yīng)該將這些外部需求視為經(jīng)過報表、應(yīng)用程序接口、系統(tǒng)硬件接口附加給軟件產(chǎn)品的附加用戶類。2.4運行環(huán)境描繪了本軟件的運行環(huán)境，一般包括：硬件平臺；操作系統(tǒng)和版本；支撐環(huán)境(比方：數(shù)據(jù)庫等)和版本；其余與該軟件相關(guān)的軟件組件；與該軟件共存的應(yīng)用程序。2.5設(shè)計

29、和實現(xiàn)上的限制確定影響開發(fā)人員自由選擇的問題，并且說明這些問題為什么成為一種限制?？赡艿南拗瓢ㄏ铝袃?nèi)容：必須使用的特定技術(shù)、工具、編程語言和數(shù)據(jù)庫；防備使用的特定技術(shù)、工具、編程語言和數(shù)據(jù)庫；要求按照的開發(fā)規(guī)范和標(biāo)準(zhǔn)比方，如果由客戶的企業(yè)也許第三方企業(yè)負(fù)責(zé)軟件維護，就必須定義轉(zhuǎn)包者所使用的設(shè)計符號表示和編碼標(biāo)準(zhǔn)；企業(yè)策略的限制；政府法規(guī)的限制；工業(yè)標(biāo)準(zhǔn)的限制；硬件的限制比方，準(zhǔn)時需求或存儲器限制；數(shù)據(jù)變換格式標(biāo)淮的限制。2.6假設(shè)和拘束(依賴)列舉出對軟件產(chǎn)品需求解析報告中，影響需求陳述的假設(shè)因素(與己知因素相對立)。如果這些假設(shè)因素不正確、不一致也許被更正，就會使軟件產(chǎn)品開發(fā)項目受到影響。

30、這些假設(shè)的因素可能包括：計劃使用的商業(yè)組件，也許其余軟件中的某個部件；假設(shè)產(chǎn)品中某個用戶界面將吻合一個特殊的設(shè)計約定；相關(guān)本軟件用戶的若干假設(shè)(比方：假設(shè)用戶會熟練使用SQL語言。)；相關(guān)本軟件開發(fā)工作的若干假設(shè)(比方：用戶承諾的優(yōu)惠、方便、上級部門恩賜的特殊政策和支持等。)；相關(guān)本軟件運行環(huán)境的一些問題；其他，確定本軟件開發(fā)項目對外部拘束因素所存在的依賴。相關(guān)的拘束可能包括：工期拘束；經(jīng)費拘束；人員拘束；設(shè)備拘束；地理地址拘束；其余相關(guān)項目拘束；外部接口需求經(jīng)過本節(jié)描繪可以確定，保證軟件產(chǎn)品能和外部組件正確連接的需求。關(guān)系圖僅能表示高層抽象的外部接口，必須對接口數(shù)據(jù)和外部組件進行詳盡描繪，并

31、且寫入數(shù)據(jù)定義中。如果產(chǎn)品的不同部分有不同的外部接口，那么應(yīng)該把這些外部接口的全部詳盡需求并入到這一部分實例中。注意：必須將附加用戶類的特點與外部接口需求加以劃分，附加用戶類的特點描繪的是經(jīng)過接口取得軟件產(chǎn)品的數(shù)據(jù)和服務(wù)的人的需求；而外部接口需求描繪的是接口本身的需求。3.1用戶界面陳述需要使用在用戶界面上的軟件組件，描繪每一個用戶界面的邏輯特點。必須注意，這里需要描繪的是用戶界面的邏輯特點，而不是用戶界面。以下是可能包括的一些特點：將要采用的圖形用戶界面(GUl)標(biāo)準(zhǔn)也許產(chǎn)品系列的風(fēng)格；相關(guān)屏幕布局也許解決方案的限制；將要使用在每一個屏幕(圖形用戶界面)上的軟件組件，可能包括：選單；標(biāo)準(zhǔn)按鈕

32、；導(dǎo)航鏈接；各種功能組件；消息欄；快捷鍵；各種顯示格式的規(guī)定，可能包括：不同情況下文字的對齊方式；不同情況下數(shù)字的表現(xiàn)格式與對齊方式日期的表現(xiàn)方法與格式；計時方法與時間格式；等等。錯誤信息顯示標(biāo)準(zhǔn)；對于用戶界面的細(xì)節(jié)，比方：一個特定對話框的布局，應(yīng)該寫入詳盡的用戶界面設(shè)計說明中，而不能寫入軟件需求規(guī)格說明中。如果采用現(xiàn)成的、合適的用戶界面設(shè)計規(guī)范(標(biāo)準(zhǔn))，也許另文描繪，可以在這里直接說明，并且將其加入?yún)⒄瘴募?.2硬件接口描繪待開發(fā)的軟件產(chǎn)品與系統(tǒng)硬件接口的特點，若有多個硬件接口，則必須全都描繪。接口特點的描繪內(nèi)容可能包括：支持的硬件種類；軟、硬件之間交流的數(shù)據(jù)；控制信息的性質(zhì)；使用的通訊協(xié)

33、議；3.3軟件接口描繪該軟件產(chǎn)品與其余外部組件的連接，這些外部組件必須明確它們的名稱和版本號以資鑒別，可能的外部組件包括：操作系統(tǒng)；數(shù)據(jù)庫；工具；函數(shù)庫；集成的商業(yè)組件說明：這里所說的“集成的商業(yè)組件”，是指與系統(tǒng)集成的商業(yè)組件，而不是與軟件產(chǎn)品集成的商業(yè)組件。比方：中間件、消息服務(wù)，等等。描繪并且明確軟件產(chǎn)品與軟件組件之間交換數(shù)據(jù)也許消息的目的。描繪所需要的服務(wù)，以及與內(nèi)部組件通訊的性質(zhì)。確定軟件產(chǎn)品將與組件之間共享的數(shù)據(jù)。如果必須使用一種特殊的方法來實現(xiàn)數(shù)據(jù)共享體系，比方：在多用戶系統(tǒng)中的一個全局?jǐn)?shù)據(jù)區(qū)，那么就必須把它定義為一種實現(xiàn)上的限制。3.4通訊接口描繪與軟件產(chǎn)品所使用的通訊功能相關(guān)

34、的需求，包括：電子郵件；WEB瀏覽器；網(wǎng)絡(luò)通訊標(biāo)準(zhǔn)也許協(xié)議；數(shù)據(jù)交互用電子表格；必須定義相關(guān)的：消息格式；通訊安全或加密問題；數(shù)據(jù)傳輸速率；同步和異步通訊體系；系統(tǒng)功能需求需要進行詳盡的需求記錄，詳盡列出與該系統(tǒng)功能相關(guān)的詳盡功能需求，并且，唯一地表記每一項需求。這是必須提交給用戶的軟件功能，使得用戶可以使用所提供的功能執(zhí)行服務(wù)也許使用所指定的使用實例執(zhí)行任務(wù)。描繪軟件產(chǎn)品怎樣響應(yīng)己知的出錯條件、非法輸入、非法動作。如果每一項功能需求都能用一項，也只需要用一項測試用例就能進行考據(jù)，那么就可以認(rèn)為功能需求已經(jīng)適合地進行描繪了。如果某項功能需求找不到合適的測試用例，也許必須使用多項測試用例才能考據(jù)

35、，那么該項功能需求的描繪必然存在某些問題。功能需求是根據(jù)系統(tǒng)功能，即軟件產(chǎn)品所提供的主要服務(wù)來組織的?？梢越?jīng)過使用實例、運行模式、用戶類、對象類也許功能等級來組織這部分內(nèi)容，也可以便用這些元素的組合?？偠灾?，必須選擇一種是讀者容易理解預(yù)期產(chǎn)品的組織方案。用簡短的語句說明功能的名稱，比方：“4.1系統(tǒng)參數(shù)管理”。按照服務(wù)組織的序次，逐條闡述系統(tǒng)功能。無論說明的是何種功能，都應(yīng)該針對該系統(tǒng)功能重復(fù)表達(dá)4.14.3這三個部分?？梢越?jīng)過各種方式來組織這一部分內(nèi)容，比方采用：使用實例、運行模式、用戶類、對象類、功能等級等，也可以采用它們的組合。其最終目的是，讓讀者容易理解即將開發(fā)的軟件產(chǎn)品。一般來說，

36、每個使用實例都對應(yīng)一個系統(tǒng)功能，因而按照使用實例來組織內(nèi)容比較容易讓用戶理解。對應(yīng)一些被共享的獨立使用實例，可以定義一些公用系統(tǒng)功能。必須特別注意的是，在2.2節(jié)“產(chǎn)品的功能”中描繪的全部需求，以及它們的規(guī)格說明；必須在某個系統(tǒng)功能描繪中有所反響，而且不應(yīng)重復(fù)。4.1說明和優(yōu)先級對該系統(tǒng)功能進行簡短的說明，并且指出該系統(tǒng)功能的優(yōu)先級是：高、中、仍是低。需要的話，還可以包括對特定優(yōu)先級部分的評論，比方：利益、損失、費用和風(fēng)險，其相對優(yōu)先等級可以從1(低)到9(高)。4.2激勵響應(yīng)序列列出輸入激勵(用戶動作、來自外部設(shè)備的信號也許其余觸發(fā))并且定義針對這功能行為的系統(tǒng)響應(yīng)序列，這些序列將與使用實例

37、中相關(guān)的對話元素相對應(yīng)。描繪激勵響應(yīng)序列時，不單需要描繪基本過程，而且應(yīng)該描繪可選(擴大)過程，包括例外(引起任務(wù)不能序次完成的情況稱為例外)。粗心了可選過程，有可能影響軟件產(chǎn)品的功能；如果遺漏例外過程，則有可能會引發(fā)系統(tǒng)崩潰。如果采用流程圖來描繪激勵響應(yīng)序列，比較容易讓用戶理解。4.3輸入輸出數(shù)據(jù)列出輸入數(shù)據(jù)(用戶輸入、來自外部接口的輸入也許其余輸入)并且定義針對這些輸入數(shù)據(jù)的辦理(計算)方法，以及相應(yīng)地輸出數(shù)據(jù)，描繪對應(yīng)區(qū)別：輸入數(shù)據(jù)和輸出數(shù)據(jù)。當(dāng)有大量數(shù)據(jù)需要描繪時，也可以分類描繪數(shù)據(jù)，并且注明各項數(shù)據(jù)的輸入、輸出屬性。對于每一項數(shù)據(jù)，均需要描繪：數(shù)據(jù)名稱；實際含義；數(shù)據(jù)種類；數(shù)據(jù)格式；

38、數(shù)據(jù)拘束；對于復(fù)雜的辦理方法，只是給出算法原理是不夠的，必須描繪詳盡的計算過程，并且列出每一步詳盡使用的實際算式；如果計算過程中涉及查表、判斷、迭代等辦理方法，應(yīng)該給出辦理依據(jù)和相關(guān)數(shù)據(jù)。如果計算方法很簡單，也可以將其從略，不加描繪。其余非功能需求在這里列舉出所有非功能需求，主要包括可靠性、安全性、可維護性、可擴展性、可測試性等。5.1性能需求闡述不同應(yīng)用領(lǐng)域?qū)浖a(chǎn)品性能的需求，并且說明提出需求的原理也許依據(jù)，以幫助開發(fā)人員做出合理的設(shè)計選擇。盡可能詳盡地描繪性能需求，如果需要，可以針對每個功能需求也許特點分別陳述其性能需求。在這里確定：相互合作的用戶數(shù)量；系統(tǒng)支持的并發(fā)操作數(shù)量；響應(yīng)時間；

39、與實時系統(tǒng)的時間關(guān)系：容量需求存儲器；磁盤空間；數(shù)據(jù)庫中表的最大行數(shù)。5.2安全舉措需求詳盡陳述與軟件產(chǎn)品使用過程中可能發(fā)生的損失、破壞、危害相關(guān)的需求。定義必須采取的安全保護或動作，以及必須預(yù)防的潛在危險動作。明確軟件產(chǎn)品必須遵照的安全標(biāo)準(zhǔn)、策略、或規(guī)則。5.3安全性需求詳盡陳述與系統(tǒng)安全性、完整性問題相關(guān)的需求，也許與個人隱私問題相關(guān)的需求。這些問題將會影響到軟件產(chǎn)品的使用，和軟件產(chǎn)品所創(chuàng)辦也許使用的數(shù)據(jù)的保護。定義用戶身份認(rèn)證，或備授權(quán)需求。明確軟件產(chǎn)品必須知足的安全性也許保密性策略。也可以經(jīng)過稱為完整性的質(zhì)量屬性來闡述這些需求。一個典型的軟件系統(tǒng)安全需求模范如下：“每個用戶在第一次登錄

40、后，必須更改他的系統(tǒng)預(yù)置登錄密碼，系統(tǒng)預(yù)置的登錄密碼不能重用?！?.4軟件質(zhì)量屬性詳盡陳述對客戶和開發(fā)人員至關(guān)重要的在軟件產(chǎn)品其余方面表現(xiàn)出來的質(zhì)量功能。這些功能必須是確定的、定量的、在需要時是可以考據(jù)的。最少也應(yīng)該指明不同屬性的相對重視點，比方：易用性優(yōu)于易學(xué)性，也許可移植性優(yōu)于有效性。5.5業(yè)務(wù)規(guī)則列舉出相關(guān)軟件產(chǎn)品的所有操作規(guī)則，比方：那些人在特定環(huán)境下可以進行何種操作。這些本身不是功能需求，但是他們可以暗示某些功能需求執(zhí)行這些規(guī)則。一個業(yè)務(wù)規(guī)則的模范如下：“進行達(dá)到也許超過10，000，00元人民幣的積蓄業(yè)務(wù)時，必須經(jīng)過附加的管理員認(rèn)證。”列舉業(yè)務(wù)規(guī)則時，可以根據(jù)規(guī)則的數(shù)量，采用合適的

41、編目方式。5.6用戶文檔列舉出將與軟件產(chǎn)品一同交付的用戶文檔，并且明確所有己知用戶文檔的交付格式或標(biāo)準(zhǔn)，比方：安裝指南紙質(zhì)文檔，16開本；用戶手冊紙質(zhì)文檔，16開本；在線幫助電子文檔，與軟件產(chǎn)品一同散發(fā)、配置；使用教程電子文檔，與軟件產(chǎn)品一同散發(fā)、配置。詞匯表列出本文件中用到的專業(yè)術(shù)語的定義，以及相關(guān)縮寫的定義(如有可能，列出相關(guān)的外文原詞)。為了便于非軟件專業(yè)也許非計算機專業(yè)人士閱讀軟件產(chǎn)品需求解析報告，要求使用非軟件專業(yè)也許非計算機專業(yè)的術(shù)語描繪軟件需求。所以這里所指的專業(yè)術(shù)語，是指業(yè)務(wù)層面上的專業(yè)術(shù)語，而不是軟件專業(yè)也許計算機專業(yè)的術(shù)語。但是，對于無法回避的軟件專業(yè)也許計算機專業(yè)術(shù)語，也

42、應(yīng)該列入詞匯表并且加以正確定義。數(shù)據(jù)定義數(shù)據(jù)定義是一個定義了應(yīng)用程序中使用的所有數(shù)據(jù)元素和結(jié)構(gòu)的共享文檔，其中對每個數(shù)據(jù)元素和結(jié)構(gòu)都正確描繪：含義、種類、數(shù)據(jù)大小、格式、計量單位、精度以及取值范圍。數(shù)據(jù)定義的維護獨立于軟件需求規(guī)格說明，并且在軟件產(chǎn)品開發(fā)和維護的任何階段，均向風(fēng)險擔(dān)當(dāng)者開放。如果為軟件開發(fā)項目創(chuàng)辦一個獨立的數(shù)據(jù)定義，而不是為每一項特性描繪相關(guān)的數(shù)據(jù)項，有利于防備冗余和不一致性。但是卻不利于多人共同編寫需求解析報告，容易遺漏數(shù)據(jù)，也不方便閱讀。因此仍是建議為每個特性描繪相關(guān)的數(shù)據(jù)項，匯總數(shù)據(jù)項創(chuàng)辦數(shù)據(jù)定義，再根據(jù)數(shù)據(jù)定義復(fù)核全部數(shù)據(jù)，使得它們的名稱和含義完全一致。必須注意的是，為

43、了防備二義性，在匯總數(shù)據(jù)項時應(yīng)該根據(jù)數(shù)據(jù)項所代表的實際意義匯總，而不是根據(jù)數(shù)據(jù)項的名稱匯總。在數(shù)據(jù)定義中，每個數(shù)據(jù)項除了有一其中文名稱外，還應(yīng)該為它取一個簡短的英文名稱，該英文名稱應(yīng)該吻合命名規(guī)范，因為在軟件開發(fā)時將沿用該英文名稱?？梢允褂玫忍柋硎緮?shù)據(jù)項，名稱寫在左邊，定義寫在右邊。常有數(shù)據(jù)項的描繪方式如下：原數(shù)據(jù)元素一個原數(shù)據(jù)元素是不可分解的，可以將一個數(shù)量值賦給它。定義原數(shù)據(jù)元素必須確定其含義、種類、數(shù)據(jù)大小、格式、計量單位、精度以及取值范圍。采用以星號為界的一行說明文本，描繪原數(shù)據(jù)元素的定義。選擇項選擇項是一種只可以取有限離散值的特殊原數(shù)據(jù)元素，描繪時一一列舉這些值，并用方括號括起來寫在

44、原數(shù)據(jù)元素的定義前。在兩項離散值之間，使用管道符分開。組合項組合項是一個數(shù)據(jù)結(jié)構(gòu)也許記錄，其中包含了多個數(shù)據(jù)項。這些數(shù)據(jù)項可以是原數(shù)據(jù)元素，也可以是組合數(shù)據(jù)項，各數(shù)據(jù)項之間用加號連接。其中每個數(shù)據(jù)項都必須是數(shù)據(jù)定義中定義過的，結(jié)構(gòu)中也可以包括其余結(jié)構(gòu)，但是絕對不允許遞歸。如果數(shù)據(jù)結(jié)構(gòu)中有可選項，使用圓括號把該項括起來。重復(fù)項重復(fù)項是組合項的一種特例，其中有一項將有多個實例出現(xiàn)在數(shù)據(jù)結(jié)構(gòu)中，使用花括號把該項括起來。如果知道該項可能允許的范圍，就按“最小值：最大值”的形式寫在花括號前。解析模型這是一個可選部分，包括或涉及到相關(guān)的解析模型，比方：數(shù)據(jù)流程圖；類圖；狀態(tài)變換圖；實體-關(guān)系圖。待定問題列

45、表編寫一張在軟件產(chǎn)品需求解析報告中待確定問題時的列表，把每一個表項都編上號，以便追蹤檢查。附錄B軟件大綱設(shè)計報告文檔模板1.引言191.1編寫目的191.2項目風(fēng)險191.3預(yù)期讀者和閱讀建議191.4參照資料202.設(shè)計歸納202.1限制和拘束202.2設(shè)計原則和設(shè)計要求213.系統(tǒng)邏輯設(shè)計213.1系統(tǒng)組織設(shè)計213.2系統(tǒng)結(jié)構(gòu)設(shè)計22系統(tǒng)特性表22系統(tǒng)特性結(jié)構(gòu)圖233.3系統(tǒng)接口設(shè)計23系統(tǒng)接口表23系統(tǒng)接口傳輸協(xié)議說明243.4系統(tǒng)完整性設(shè)計244.系統(tǒng)出錯辦理設(shè)計254.1系統(tǒng)出錯辦理表254.2維護辦理過程表265.技術(shù)設(shè)計275.1系統(tǒng)開發(fā)技術(shù)說明表275.2開發(fā)技術(shù)應(yīng)用說明28

46、6.數(shù)據(jù)庫設(shè)計287.詞匯表288.進度計劃29引言引言是對這份軟件系統(tǒng)大綱設(shè)計報告的概覽，是為了幫助閱讀者認(rèn)識這份文檔是怎樣編寫的，并且應(yīng)該怎樣閱讀、理解和解釋這份文檔。1.1編寫目的說明這份軟件系統(tǒng)大綱設(shè)計報告是基于哪份軟件產(chǎn)品需求規(guī)格說明書編寫的，開發(fā)這個軟件產(chǎn)品意義、作用、以及最終要達(dá)到的意圖。經(jīng)過這份軟件系統(tǒng)大綱設(shè)計報告詳盡說了然該軟件產(chǎn)品的軟件結(jié)構(gòu)，包括數(shù)據(jù)庫結(jié)構(gòu)和出錯辦理，進而對該軟件產(chǎn)品的結(jié)構(gòu)的描繪。如果這份軟件系統(tǒng)大綱設(shè)計報告只與整個系統(tǒng)的某一部分相關(guān)系，那么只定義軟件系統(tǒng)大綱設(shè)計報告中說明的那個部分或子系統(tǒng)。1.2項目風(fēng)險詳盡說明本軟件開發(fā)項目的全部風(fēng)險擔(dān)當(dāng)者，以及各自在本

47、階段所需要擔(dān)當(dāng)?shù)闹饕L(fēng)險，首要風(fēng)險擔(dān)當(dāng)者包括：任務(wù)提出者；軟件開發(fā)者；產(chǎn)品使用者。1.3預(yù)期讀者和閱讀建議列舉本軟件系統(tǒng)大綱設(shè)計報告所針對的各種不同的預(yù)期讀者，比方，可能的讀者包括：用戶；開發(fā)人員；項目經(jīng)理；營銷人員；測試人員；文檔編寫人員；等等。描繪文檔中，其余部分的內(nèi)容及其組織結(jié)構(gòu)，并且針對每一類讀者提出最適合的文檔閱讀建議。1.4參照資料列舉編寫軟件產(chǎn)品大綱設(shè)計報告時所用到的參照文件及資料，可能包括：本項目的合同書；上級機關(guān)相關(guān)本項目的批文；本項目已經(jīng)批準(zhǔn)的計劃任務(wù)書；用戶界面風(fēng)格指導(dǎo)；開發(fā)本項目時所要用到的標(biāo)準(zhǔn)；系統(tǒng)規(guī)格需求說明；使用實例文檔；屬于本項目的其余已發(fā)表文件；本軟件系統(tǒng)大綱

48、設(shè)計報告中所引用的文件、資料：相關(guān)軟件系統(tǒng)大綱設(shè)計報告：等等。為了方便讀者查閱，所有參照資料應(yīng)該按一定順排列。如果可能，每份資料都應(yīng)該給出：標(biāo)題名稱；作者也許合同簽約者；文件編號也許版本號；發(fā)表日期也許簽約日期；出版單位也許資料本源。設(shè)計歸納本節(jié)描繪現(xiàn)有開發(fā)條件和需要實現(xiàn)的目標(biāo)，說明進行大綱設(shè)計時應(yīng)該按照的設(shè)計原則和必須采用的設(shè)計方法。2.1限制和拘束簡要描繪起到限制和拘束作用的各種可能存在的條件，比方：技術(shù)條件；資本狀況；開發(fā)環(huán)境(包括：工具和平臺)；時間限制；等等。并且說明在上述條件下，應(yīng)該實現(xiàn)的系統(tǒng)目標(biāo)，2.2設(shè)計原則和設(shè)計要求描繪對本軟件系統(tǒng)進行大綱設(shè)計的原則，平時可以考慮以下幾方面的

49、內(nèi)容：命名規(guī)則；模塊獨立性原則：邊界設(shè)計原則；數(shù)據(jù)庫設(shè)計規(guī)則；必須的安全舉措；安全性和保密原則；系統(tǒng)靈活性要求；系統(tǒng)易操作性要求；系統(tǒng)可維護性要求；等等。系統(tǒng)邏輯設(shè)計本節(jié)內(nèi)容主要根據(jù)軟件產(chǎn)品需求規(guī)格說明書和軟件產(chǎn)品數(shù)據(jù)字典建立系統(tǒng)的邏輯模型。此種模型暫時與系統(tǒng)的物理因素(比方：計算機、數(shù)據(jù)庫管理系統(tǒng))無關(guān)。它是系統(tǒng)需求與物理實現(xiàn)的中間結(jié)構(gòu)，它的主要結(jié)果是建立：系統(tǒng)結(jié)構(gòu)圖、系統(tǒng)界面結(jié)構(gòu)圖、系統(tǒng)出錯辦理、以及系統(tǒng)開發(fā)技術(shù)說明。說明：如果進行系統(tǒng)設(shè)計時尚未編寫軟件數(shù)據(jù)字典：應(yīng)首先參照附錄B說明，編寫軟件數(shù)據(jù)字典。在完成軟件數(shù)據(jù)字典后，再進行系統(tǒng)設(shè)計。3.1系統(tǒng)組織設(shè)計系統(tǒng)組織設(shè)計經(jīng)過系統(tǒng)組織表描繪本

50、系統(tǒng)由哪些子系統(tǒng)(模塊)組成，這些子系統(tǒng)與業(yè)務(wù)職能之間的關(guān)系，以及各個子系統(tǒng)的安裝地址。系統(tǒng)組織表的格式如下：子系統(tǒng)編號英文名稱中文名稱業(yè)務(wù)職能安裝地址備注其中：子系統(tǒng)編號給出本系統(tǒng)中指定子系統(tǒng)的序次編號。如果本系統(tǒng)末劃分為多個子系統(tǒng)，僅由一個運行模塊組成；則本項內(nèi)容仍需要描繪，但是本表內(nèi)容只有一行。說明：在一個系統(tǒng)中有可能安裝若干個相同的子系統(tǒng)，在這種情況下，應(yīng)該視為一個子系統(tǒng)，并且對多個安裝地址分別進行描繪。如果相同的子系統(tǒng)經(jīng)過系統(tǒng)設(shè)置，實現(xiàn)的業(yè)務(wù)職能擁有顯然差別時，應(yīng)該采用多前進行分別描繪，并且在備注中說明其差別所在。子系統(tǒng)英文名稱給出簿本系統(tǒng)的英文名稱，該名稱是在應(yīng)用軟件中實際使用的可

51、執(zhí)行文件名稱，必須可以說明該子系統(tǒng)的特點。若本系統(tǒng)中只有一個子系統(tǒng)，則本項內(nèi)容仍需要描繪，但是本表內(nèi)容只有一行。子系統(tǒng)中文名稱給出簿本系統(tǒng)的中文名稱，該名稱必須可以說明該子系統(tǒng)的特點。若本系統(tǒng)中只有一個子系統(tǒng)，則本項內(nèi)容仍需要描繪，但是本表內(nèi)容只有一行。業(yè)務(wù)職能描繪該子系統(tǒng)完成的核心業(yè)務(wù)。安裝地址描繪該子系統(tǒng)實際安裝的部門、也許某個詳盡地址。備注針對該子系統(tǒng)，需要說明的其余相關(guān)問題。3.2系統(tǒng)結(jié)構(gòu)設(shè)計本節(jié)將對系統(tǒng)特性作較為詳盡的描繪，并給出系統(tǒng)特性結(jié)構(gòu)圖。3.2.1系統(tǒng)特性表系統(tǒng)特性是系統(tǒng)中完成某項詳盡操作的基本單元，它由入口參數(shù)，出口參數(shù)以及辦理過程三部分組成。系統(tǒng)特性可以擁有操作界面，也可

52、以沒有操作界面；可以被其余操作界面、也許系統(tǒng)特性調(diào)用，也可以調(diào)用其余操作界面、非操作界面、也許系統(tǒng)特性；但是不允許遞歸調(diào)用(調(diào)用自己)，包括間接遞歸調(diào)用。當(dāng)系統(tǒng)由多個子系統(tǒng)(模塊)組成時，每個子系統(tǒng)分別使用一張系統(tǒng)特性表進行描繪。系統(tǒng)特性表的格式如下：子系統(tǒng)編號：子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：特性編號系統(tǒng)特點系統(tǒng)特點操作功能調(diào)用對象被調(diào)用備注英文名稱中文名稱對象說明：其中子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。特性編號整個系統(tǒng)所有特性的統(tǒng)一編號。系統(tǒng)特性英文名稱系統(tǒng)特性的英文正式名稱，將來用于軟件開發(fā)中，必須吻合命名規(guī)范。系統(tǒng)特性中文名稱系統(tǒng)特性的中文正式名稱，本

53、源于需求規(guī)格說明書中，系統(tǒng)特性一節(jié)中的相關(guān)描繪。操作功能是指該特性實際完成的操作說明。調(diào)用對象是指調(diào)用該系統(tǒng)特性的系統(tǒng)對象，這里的系統(tǒng)對象可以是系統(tǒng)特性、也可以是操作界面。被調(diào)用對象是指被該系統(tǒng)特性調(diào)用的系統(tǒng)對象，這里的系統(tǒng)對象可以是系統(tǒng)特性、也可以是操作界面。說明：某些較低層的系統(tǒng)特性，可能不存在被調(diào)用對象。備注描繪與該系統(tǒng)特性相關(guān)的其余注意事項。說明描繪與該系統(tǒng)特性表相關(guān)的其余注意事項。3.2.2系統(tǒng)特性結(jié)構(gòu)圖系統(tǒng)特性結(jié)構(gòu)圖給出系統(tǒng)特性在邏輯層面上相互之間的關(guān)系，其主要依據(jù)本源于需求規(guī)格說明書中，系統(tǒng)特性一節(jié)中的相關(guān)描繪。如果系統(tǒng)劃分為多個子系統(tǒng)，應(yīng)分別給出系統(tǒng)與子系統(tǒng)、以及各個子系統(tǒng)與系

54、統(tǒng)特性的結(jié)構(gòu)圖。繪制系統(tǒng)與子系統(tǒng)結(jié)構(gòu)圖時，一般不需要描繪出系統(tǒng)特性，如果確有必要，盡可能只畫出第一層系統(tǒng)特性。繪制子系統(tǒng)與系統(tǒng)特性結(jié)構(gòu)圖時，平時也不需要描繪出第二層系統(tǒng)特性，如果確有必要可以畫出，但是盡可能不要畫出第三層系統(tǒng)特性。3.3系統(tǒng)接口設(shè)計系統(tǒng)接口是一種非可視的系統(tǒng)界面，在多數(shù)情況下，它對用戶是透明的。本節(jié)將對系統(tǒng)接口作較為詳盡的描繪，并給出接口說明清單。3.3.1系統(tǒng)接口表接口作為系統(tǒng)的一種輸入輸出形式，分為網(wǎng)絡(luò)接口、數(shù)據(jù)庫接口、RS-232串行通訊接口、IEEE485串行總線接口、并行I/O接口等等多各種類。對于一些為可視界面服務(wù)的接口，比方：打印機接口、顯示器接口等，因為這類接口

55、對應(yīng)用軟件是透明的，所以不在本節(jié)描繪范圍內(nèi)。當(dāng)系統(tǒng)由多個子系統(tǒng)(模塊)組成時，每個子系統(tǒng)分別使用一張系統(tǒng)接口表進行描繪。系統(tǒng)接口表的格式如下：子系統(tǒng)編號子系統(tǒng)英文名稱子系統(tǒng)中文名稱接口編號接口名稱接口種類接口性質(zhì)接口速率接口協(xié)議備注說明：其中：子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。接口編號整個系統(tǒng)所有接口的統(tǒng)一編號。接口名稱系統(tǒng)接口的正式名稱，必須吻合平時習(xí)慣。接口種類指出該接口所傳輸?shù)臄?shù)據(jù)在該模塊中起到的作用。接口性質(zhì)指出該接口在通訊中起到的作用，這里的作用可以是：輸入；輸出；雙向。接口速率指出該接口的傳輸速率。如果該接口依賴于其余通訊方式，那么傳輸速率將不高于

56、它所依賴的其余通訊方式的速率。接口協(xié)議給出該接口實際使用的通訊協(xié)議。相關(guān)對象給出直接使用本接口的系統(tǒng)對象，這里的系統(tǒng)對象，可以是操作界面，也可以是系統(tǒng)特性。備注描繪與該系統(tǒng)接口相關(guān)的其余注意事項。說明描繪與該系統(tǒng)接口表相關(guān)的其余注意事項。3.3.2系統(tǒng)接口傳輸協(xié)議說明逐項詳盡描繪系統(tǒng)接口表中所列出各個系統(tǒng)接口使用的傳輸協(xié)議，以及其余相關(guān)內(nèi)容，比方：驅(qū)動程序、動向連接庫、等等。3.4系統(tǒng)完整性設(shè)計描繪系統(tǒng)對象(數(shù)據(jù)元、數(shù)據(jù)類)，所受到的邏輯拘束關(guān)系。當(dāng)系統(tǒng)由多個子系統(tǒng)(模塊)組成時，每個子系統(tǒng)應(yīng)分別使用一張系統(tǒng)完整性拘束表進行描繪。系統(tǒng)完整性拘束表的格式如下：子系統(tǒng)編號子系統(tǒng)英文名稱子系統(tǒng)中文名

57、稱拘束編號完整性名稱相對對象名拘束表達(dá)式備注說明：其中：子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。拘束編號整個系統(tǒng)所有拘束的統(tǒng)一編號。完整性名稱系統(tǒng)完整性拘束的正式名稱，必須吻合平時習(xí)慣。相對對象名完整性拘束中的相關(guān)對象(數(shù)據(jù)元和數(shù)據(jù)類)。拘束表達(dá)式用一階邏輯表達(dá)式表達(dá)的拘束方程式。備注描繪與該系統(tǒng)完整性拘束相關(guān)的其余注意事項。說明描繪與該系統(tǒng)完整性拘束表相關(guān)的其余注意事項。系統(tǒng)出錯辦理設(shè)計本節(jié)描繪系統(tǒng)發(fā)生外界及內(nèi)在錯誤時，所提供的錯誤信息及辦理方法，它包括系統(tǒng)出錯辦理表及維護辦理過程表。4.1系統(tǒng)出錯辦理表本表給出相關(guān)出錯辦理的產(chǎn)生原因、提示信息、以及建議辦理方法。

58、當(dāng)系統(tǒng)由多個子系統(tǒng)(模塊)組成時，每個子系統(tǒng)分別使用一張系統(tǒng)出錯辦理表進行描述。系統(tǒng)出錯辦理表的格式如下：子系統(tǒng)編號：子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：錯誤編號錯誤名稱錯誤原因錯誤信息辦理方式備注說明：其中：子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。錯誤編號整個系統(tǒng)所有錯誤的統(tǒng)一編號。錯誤名稱錯誤的正式名稱，該名稱應(yīng)該是常用的，并且為人們所普遍接受的。錯誤原因?qū)υ撳e誤產(chǎn)生原因的解釋與說明。錯誤信息產(chǎn)生該錯誤時，向用戶發(fā)出的提示信息。辦理方式對該錯誤辦理的一種建議，此項允許缺省。備注描繪與該系統(tǒng)錯誤相關(guān)的其余注意事項。說明描繪與該系統(tǒng)錯誤表相關(guān)的其余注意事項。4.2維護辦

59、理過程表系統(tǒng)出錯時，將調(diào)用維護辦理過程對錯誤進行辦理，相關(guān)維護辦理過程的各項內(nèi)容由維護辦理過程表進行描繪。當(dāng)系統(tǒng)有多個子系統(tǒng)(模塊)組成時，每個子系統(tǒng)分別使用一張維護辦理過程表進行描繪。維護辦理過程表的格式如下：子系統(tǒng)編號：子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：錯誤編號辦理過程辦理過程辦理功能入口參數(shù)出口參數(shù)備注英文名稱中文名稱說明：其中：子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。錯誤編號含義同上。辦理過程英文名稱系統(tǒng)維護辦理過程的英文正式名稱，將來用于軟件開發(fā)中，必須吻合命名規(guī)范。辦理過程中文名稱系統(tǒng)維護辦理過程的中文正式名稱，是系統(tǒng)維護辦理過程英文名稱的中文說明。辦理功

60、能描繪本維護辦理過程對錯誤的辦理方式。由于一個維護辦理過程有可能擁有對多個錯誤進行辦理的能力，因此該辦理功能必須是針對本項錯誤編號的。入口參數(shù)進行本項錯誤辦理時，賦給維護辦理過程的入口參數(shù)。出口參數(shù)進行本項錯誤辦理時，維護辦理過程返回的出口參數(shù)。備注描繪與該系統(tǒng)錯誤相關(guān)的其余注意事項。說明描繪與該系統(tǒng)錯誤表相關(guān)的其余注意事項。技術(shù)設(shè)計系統(tǒng)技術(shù)設(shè)計描繪系統(tǒng)各個特性實際使用的開發(fā)技術(shù)，以及詳盡開發(fā)技術(shù)使用時應(yīng)該注意的事項。5.1系統(tǒng)開發(fā)技術(shù)說明表本表描繪系統(tǒng)各個特性開發(fā)時實際使用的詳盡技術(shù)，只有一些不太常用的技術(shù)需要在這里描繪。一些常用技術(shù)，比方：經(jīng)過數(shù)據(jù)庫接口調(diào)用存儲過程，則不必冗述。當(dāng)系統(tǒng)由多