軟件需求分析報告模板(完整版) 12.2軟件開發(fā)平臺要求 12.3軟件項目的開發(fā)實施過程管理要求 22.3.1軟件項目實施過程總體要求 22.3.2軟件項目實施變更要求 22.3.3軟件項目實施里程碑控制 2 3 33.1.2需求分析報告的編制者 43.1.3需求報告評審 43.1.4需求報告格式 43.2軟件的概要設計 43.2.1概要設計 43.2.2編寫概要設計的要求 43.2.3概要設計報告的編寫者 43.2.4概要設計和需求分析、詳細設計之間的關(guān)系和區(qū)別 43.2.5概要設計的評審 43.2.6概要設計格式 4 53.3.1詳細設計 53.3.2特例 53.3.3詳細設計的要求 53.3.4數(shù)據(jù)庫設計 53.3.5詳細設計的評審 53.3.6詳細設計格式 5 53.4.1軟件編碼 53.4.2軟件編碼的要求 53.4.3編碼的評審 63.4.4編程規(guī)范及要求 6 63.5.1軟件測試 63.5.2測試計劃 6 63.6.1交付清單 6 73.7.1軟件的鑒定驗收 7 73.7.3驗收具體內(nèi)容 73.7.4軟件驗收測試大綱 7 73.8.1系統(tǒng)應用培訓 73.8.2系統(tǒng)管理的培訓(可選) 8軟件需求分析報告文檔模板9附錄B軟件概要設計報告文檔模板附錄C軟件詳細設計報告文檔模板附錄D軟件數(shù)據(jù)庫設計報告文檔模板43附錄E軟件測試(驗收)大綱錯誤!未本指南用于指導軟件開發(fā)者為南京市交通局開發(fā)軟件項目的過程，通過規(guī)范軟件項目承擔單位的開發(fā)過程達到提高軟件質(zhì)量，降低維護成本的目的。開發(fā)者應根據(jù)本指南進行軟件開發(fā)和編制軟件開發(fā)文檔。本指南是對軟件項目承擔單位的基本要求。在本指南的附錄A至E中提供了文檔的編寫模板供開發(fā)者參考，在進行具體軟件開發(fā)時，開發(fā)者可根據(jù)實際情況采編寫，但必須提供雙方約定的文檔，文檔中約定的內(nèi)容必須描述清楚。2.總體要求2.1總體功能要求網(wǎng)絡應用環(huán)境以Internet/Intranet技術(shù)為核心。開發(fā)者應在充分分析需求的基礎上，選擇采用B/S結(jié)構(gòu)或者C/S結(jié)構(gòu)。軟件系統(tǒng)的數(shù)據(jù)庫應依照《南京市交通局信息化數(shù)據(jù)庫建設規(guī)范》進行設計和建設。本指南中沒有規(guī)定開發(fā)者采用何種具體的軟件工程開發(fā)方法，開發(fā)者可根據(jù)項目具體特點、自身擅長來選擇采用面向過程的方法、面向?qū)ο蟮姆椒ɑ蛎嫦驍?shù)據(jù)的方法，但建議開發(fā)商使用面向?qū)ο筌浖こ痰姆椒ǎ纾翰捎媚壳氨粡V泛使用的RUP(RationalUnifiedProcess)方法來進行分析、設計和開發(fā)。2.2軟件開發(fā)平臺要求開發(fā)者開發(fā)的軟件必須能夠在南京市交通局規(guī)定的軟件平臺上正常運行。目前軟件平臺數(shù)據(jù)庫管理系統(tǒng)：中間件(應用服務器)系統(tǒng)：IBMWebSphereLotusDomino/Not完全支持TCP/IP協(xié)議開發(fā)工具或技術(shù)體系：為保證軟件的上下兼容性，開發(fā)者應選擇比較通用的開發(fā)工具的較新版本進行開發(fā)，如MicrosoftVisualStudio.Net,BorlandDelphi,C++Builder,或J2EE(Java2P1atform2.3軟件項目的開發(fā)實施過程管理要求2.3.1軟件項目實施過程總體要求(一)開發(fā)者提交軟件開發(fā)工作大綱，交通局組織專家組對工作大綱進行評審，并提(二)通過評審后，開發(fā)者根據(jù)整改意見完善工作大綱，經(jīng)過交通局認可后組織項目組進行軟件開發(fā)。軟件開發(fā)工作按照需求分析、概要設計、詳細設計、編碼、測試等幾個階段進行，在開發(fā)過程中，開發(fā)者需分階段提交相關(guān)文檔。(三)在軟件開發(fā)工作完成后，開發(fā)者應向交通局提交完整的軟件文檔，交通局組織2.3.2軟件項目實施變更要求在開發(fā)過程中，需求或設計不可避免地需要發(fā)生變更，相關(guān)變更必須經(jīng)過交通局書面同以使變更處于可控制的狀態(tài)。變更單如下表所示：表2-1變更單需求變更申請申請變更的需求文檔輸入名稱，版本，日期等信息變更的內(nèi)客及其理由評估需求變更將對項目造成的影響申請人簽字變更申請的審批意見項目經(jīng)理簽字審批意見：客戶簽字(合同項目)審批意見：更改需求文檔變更后的需求文檔輸入名稱，版本，完成日期等信息更改人簽字重新評審需求文檔需求評審小組簽字評審意見：變更結(jié)束項目經(jīng)理簽字2.3.3軟件項目實施里程碑控制交通局將分四個階段進行把關(guān)，召開專家審查會。(一)需求分析(結(jié)合原型進行審查)確認；(三)預驗收(試運行后);(四)正式驗收(推廣使用后)。3.軟件開發(fā)合同簽訂以后，項目承擔單位即可組織項目組進行軟件開發(fā)工作。照軟件工程的要求進行。開發(fā)過程包括開發(fā)者的活動和任務。此過程由軟件需求分析、概要設計、詳細設計、編碼、測試、驗收、鑒定等活動組成。首先，開發(fā)者和交通局應共同對交通局的應用需求作充報告。在需求分析報告中必須描述的基本問題是：功能、性能、強加于實現(xiàn)的設計限制、屬性、外部接口。應當避免把設計或項目需求寫入需求分析報告中。它必須說明由軟件獲得的軟件需求可以用若干種方法來表達，如通過輸入、輸出說明；范化的模型。開發(fā)者應盡可能地使用模型的方式，因為這是表達復雜需求的精確和有法。比如用統(tǒng)一建模語言(UML)來描述需求。編寫需求分析報告的要求對最終產(chǎn)品的每一個特性用某一術(shù)語描述；若某一術(shù)語在某一特殊的行文中使用時具有多種含義，那么應對該術(shù)語的每種含義做出解釋并指出其適用場合。還是關(guān)系到外部接口方面的需求；對所有可能出現(xiàn)的輸入數(shù)據(jù)的響應予以定非合法的輸入值的響應做出規(guī)定；填寫全部插圖、表、圖示標記等；定義全部術(shù)語和度需求分析報告描述的每一個需求應是可以驗證的?？梢酝ㄟ^在需求分析報告中的各個需求的描述不能互相矛盾。需求分析報告應具有一個有條不紊、易于使用的內(nèi)容組織；沒有冗余，即同一f.可追蹤性每一個需求的源流必須清晰，在進一步產(chǎn)生和改變文件編制g.運行和維護階段的可使用性需求分析報告必須滿足運行和維護階段的需要。在需求分析報告要寫明功能的來源和目需求分析報告應由交通局和開發(fā)者雙方共同完成。其中：交通局負責根據(jù)實際需要提出3.1.3需求報告評審《軟件需求分析報告》需按一定的格式進行編寫，具體的《軟件需求分析報告》文檔編寫模板請見附錄A。3.2軟件的概要設計在交通局和開發(fā)者雙方認可的《需求分析報告》基礎上，開發(fā)者進行下——步的工作。進行考慮，包括系統(tǒng)的基本處理流程、系統(tǒng)的組織結(jié)構(gòu)、模塊劃分、功能分配、接口設計、運行設計、數(shù)據(jù)結(jié)構(gòu)設計和出錯處理設計等，為軟件的詳細設計提供基礎。3.2.2編寫概要設計的要求概要設計所提出的設計方法和標準應該是合理的、恰當?shù)?。對概要設計所提出的各項要求應該可以得到它的根據(jù)概要設計進行詳細設計、操作和維護應該是可行的。3.2.3概要設計報告的編寫者概要設計報告由開發(fā)者根據(jù)需求分析報告的要求進行編寫。3.2.4概要設計和需求分析、詳細設計之間的關(guān)系和區(qū)別需求分析不涉及具體的技術(shù)實現(xiàn)，而概要設計注重于從宏觀上和框架上來描述采用何交通局對《概要設計報告》評審通過后，即可進入詳細設計階段?！盾浖到y(tǒng)概要設計報告》需按一定的格式進行編寫，具體的《軟件系統(tǒng)概要設計報告》文檔編寫模板請見附錄B。如果軟件系統(tǒng)比較簡單，層次較少，可以不必進行專門的詳細設計，而和概要設計結(jié)合詳細設計的要求應該與需求分析報告所描述的需求、與概要設計一致。同時，詳細設計詳細設計所提出的設計方法和標準應該是合理的、恰當?shù)?。對詳細設計所提出的各項要求應該可以得到它的清晰的源流，即可在需求分析報告、概根據(jù)詳細設計進行編碼、測試、操作和維護應該是可行的。3.3.4數(shù)據(jù)庫設計如果軟件產(chǎn)品需要使用到數(shù)據(jù)庫，軟件的詳細設計應包括對數(shù)據(jù)庫的設計。數(shù)據(jù)庫設計計時，應當按照交通局制定的《南京市交通局信息化數(shù)據(jù)庫建設規(guī)范》要求進行?！盾浖到y(tǒng)詳細設計報告》、《軟件系統(tǒng)數(shù)據(jù)庫設計報具體的《軟件系統(tǒng)詳細設計報告》文檔編寫模板和《軟件系統(tǒng)數(shù)據(jù)庫設計報告》文檔編寫模在軟件編碼階段，開發(fā)者根據(jù)《軟件系統(tǒng)詳細設計報告》中對數(shù)據(jù)結(jié)構(gòu)、算法分析和模塊實現(xiàn)等方面的設計要求，開始具體的編寫程序工作，分別實現(xiàn)各模塊的功能，從而實現(xiàn)對目標系統(tǒng)的功能、性能、接口、界面等方面的b.代碼可讀性e.界面風格統(tǒng)一為了盡早發(fā)現(xiàn)軟件中的障礙，提高軟件產(chǎn)品的質(zhì)量，開發(fā)者在編碼的過程中應該強調(diào)代碼評審工作。將代碼評審報告作為文檔的一部分，提交給交通局。為了提高編程實現(xiàn)的質(zhì)量，軟件的程序設計必須遵照國家頒布的相關(guān)編程規(guī)范。規(guī)范。編碼規(guī)范的內(nèi)容包括命名規(guī)范、界面規(guī)范、提示及幫助信息規(guī)范、熱鍵定義等。其中數(shù)據(jù)庫部分應遵守《南京市交通局信息化數(shù)據(jù)庫建設規(guī)范》的要求。3.5軟件的測試模塊組裝過程和模塊接口進行正確性檢驗。軟件系統(tǒng)測試不僅是檢測軟件的整體行為表邏輯性測試、破壞性測試、安全性測試等。在軟件編碼開始之前，開發(fā)者應向交通局提交《測試計劃》,在軟件交付時，開發(fā)者應向交通局提交《軟件測試報告》,以確保開發(fā)者的軟件得到了充分的測試。開發(fā)的軟件必須經(jīng)過充分的測試證明其符合設計要求、運行穩(wěn)定、安全可用方可交付交通局。3.6軟件的交付準備在軟件測試證明軟件達到要求后，軟件開發(fā)者應向交通局提交開發(fā)的目標安裝程序、數(shù)《用戶安裝手冊》應詳細介紹安裝軟件對運行環(huán)境的要求、安裝軟件的定義和內(nèi)容、在客戶端、服務器端及中間件的具體安裝步驟、安裝后的系統(tǒng)配置?！队脩羰褂弥改稀窇ㄜ浖黜椆δ艿氖褂昧鞒淌竞妥⒁馐马椀确矫娴膬?nèi)容，在需要時還應舉例說明。在軟件開發(fā)完成后，為了確保軟件是按照需質(zhì)量，需要對軟件產(chǎn)品進行鑒定驗收。在開發(fā)者如期交付軟件后，由交通局負責確定具體的組成。驗收組設組長一名(可設有副組長),負責整個驗收的計劃、組織工作。概要設計說明書(PDD);此外，驗收組可以根據(jù)需要對其它文檔(如軟件配置計劃、項目進展報表、階段評審報文檔的質(zhì)量根據(jù)完備性、正確性、簡明性、可追蹤性、自說明性、規(guī)范件等方面進行蹤在軟件進行鑒定驗收前，開發(fā)者需按照一定的格式編寫《軟件驗收測試大綱》,具體的格式請見附錄E。主要培訓內(nèi)容包括：系統(tǒng)操作使用、業(yè)務管理流程。培訓對象：應用操作人員。3.8.2系統(tǒng)管理的培訓(可選)主要培訓內(nèi)容包括：系統(tǒng)安裝、調(diào)試、維護；系統(tǒng)管理。開發(fā)者應詳細列出培訓計劃，包括培訓內(nèi)容、教材、時間和人員等。附錄A軟件需求分析報告文檔模板1.1編寫目的 1.2項目風險 1.3文檔約定 1.4預期讀者和閱讀建議 1.5產(chǎn)品范圍 1.6參考文獻 2.1產(chǎn)品的狀況 2.2產(chǎn)品的功能 2.3用戶類和特性 2.4運行環(huán)境 2.5設計和實現(xiàn)上的限制 2.6假設和約束(依賴) 3.外部接口需求15 3.2硬件接口 3.3軟件接口 3.4通訊接口 4.系統(tǒng)功能需求174.1說明和優(yōu)先級 4.2激勵/響應序列 4.3輸入/輸出數(shù)據(jù) 5.其它非功能需求185.1性能需求 5.2安全措施需求 5.3安全性需求 5.4軟件質(zhì)量屬性 5.5業(yè)務規(guī)則 5.6用戶文檔 6.詞匯表207.數(shù)據(jù)定義208.分析模型219.待定問題列表21引言是對這份軟件產(chǎn)品需求分析報告的概覽，是為了幫助閱讀者了解這份文檔是如何編寫的，并且應該如何閱讀、理解和解釋這份文檔。1.1編寫目的說明這份軟件產(chǎn)品需求分析報告是為哪個軟件產(chǎn)品編寫的，開發(fā)這個軟件產(chǎn)品意義、作用、以及最終要達到的意圖。通過這份軟件產(chǎn)品需求分析報告詳盡說明了該軟件產(chǎn)品的需求規(guī)格，包括修正和(或)發(fā)行版本號，從而對該軟件產(chǎn)品進行準確的定義。如果這份軟件產(chǎn)品需求分析報告只與整個系統(tǒng)的某一部分有關(guān)系，那么只定義軟件產(chǎn)品需求分析報告中說明的那個部分或子系統(tǒng)。1.2項目風險具體說明本軟件開發(fā)項目的全部風險承擔者，以及各自在本階段所需要承擔的主要風險，首要風險承擔者包括：1.3文檔約定描述編寫文檔時所采用的標準(如果有標準的話),或者各種排版約定。排版約定應該包提示方式；也應該說明高層次需求是否可以被其所有細化的需求所繼承，或者每個需求陳述是否都有其自己的優(yōu)先級。1.4預期讀者和閱讀建議列舉本軟件產(chǎn)品需求分析報告所針對的各種不同的預期讀者，例如，可能包括：1.5產(chǎn)品范圍列舉編寫軟件產(chǎn)品需求分析報告時所用到的參考文獻及資料，可能包括：●用戶界面風格指導；●使用實例文檔；為了方便讀者查閱，所有參考資料應該按一定順序排這一部分概述了正在定義的軟件產(chǎn)品的作用范圍以及該軟件產(chǎn)軟件產(chǎn)品的用戶、對該軟件產(chǎn)品已知的限制、有關(guān)該軟件產(chǎn)品的假設和依賴。2.1產(chǎn)品的狀況描述了在軟件產(chǎn)品需求分析報告中所定義的軟件產(chǎn)品的背景和起源。說明了該軟件產(chǎn)品是否是成熟產(chǎn)品所改進的下一代產(chǎn)品；如果該軟件產(chǎn)品需求分析報告定義的軟件系統(tǒng)是：●與其它系統(tǒng)和其它機構(gòu)之間存在基本的相互關(guān)系。那么必須說明軟件產(chǎn)品需求分析報告定義的這部分軟件是怎樣與整個大系統(tǒng)相關(guān)聯(lián)的，或者(同時)說明相互關(guān)系的存在形式，并且要定義出兩者之間的全部接口。2.2產(chǎn)品的功能因為將在需求分析報告的第4部分中詳細描述軟件產(chǎn)品的功能，所以在此只需要概略地總結(jié)。僅從業(yè)務層面陳述本軟件產(chǎn)品所應具有的主要功能，在描述功能時應該針對每一項需用領(lǐng)域時，也需要對應陳述本軟件產(chǎn)品的非作用領(lǐng)域，以利讀者理解本軟件產(chǎn)品。為了很好地組織產(chǎn)品功能，使每個讀者都容易理解，可以采采用圖形方式，將主要的需求分組以及它們之間的聯(lián)系使用數(shù)據(jù)流程圖的頂層圖或類圖2.3用戶類和特性需求，只與特定的用戶類有關(guān)。描述時，應該將該軟件產(chǎn)品的重要用戶類與非重要用戶類區(qū)件產(chǎn)品的數(shù)據(jù)和服務的人、或者機構(gòu)也有他們的需求。所以，應該將這些外部需求視為通過報表、應用程序接口、系統(tǒng)硬件接口附加給軟件產(chǎn)品的附加用戶類。2.4運行環(huán)境2.5設計和實現(xiàn)上的限制●必須使用的特定技術(shù)、工具、編程語言和數(shù)據(jù)庫；●避免使用的特定技術(shù)、工具、編程語言和數(shù)據(jù)庫；●要求遵循的開發(fā)規(guī)范和標準例如，如果由客戶的公司或者第三方公司負責軟件維護，就必須定義轉(zhuǎn)包者所使用的設計符號表示和編碼標準；●企業(yè)策略的限制；政府法規(guī)的限制；工業(yè)標準的限制；●硬件的限制例如，定時需求或存儲器限制；●數(shù)據(jù)轉(zhuǎn)換格式標淮的限制。2.6假設和約束(依賴)列舉出對軟件產(chǎn)品需求分析報告中，影響需求陳述的假設因素(與己知因素相對立)。如果這些假設因素不正確、不一致或者被修改，就會使軟件產(chǎn)品開發(fā)項目受到影響。這些假設的因素可能包括：●計劃使用的商業(yè)組件，或者其它軟件中的某個部件；●假定產(chǎn)品中某個用戶界面將符合一個特殊的設計約定；●有關(guān)本軟件用戶的若干假定(例如：假定用戶會熟練使用SQL語言。);●有關(guān)本軟件開發(fā)工作的若干假定(例如：用戶承諾的優(yōu)惠、方便、上級部門給予的特殊政策和支持等。);●有關(guān)本軟件運行環(huán)境的一些問題；此外，確定本軟件開發(fā)項目對外部約束因素所存在的依賴。有關(guān)的約束可能包括●工期約束；經(jīng)費約束；人員約束；設備約束；地理位置約束；其它有關(guān)項目約束；3.外部接口需求通過本節(jié)描述可以確定，保證軟件產(chǎn)品能和外部組件正確連接的需求。關(guān)聯(lián)圖僅能表示高層抽象的外部接口，必須對接口數(shù)據(jù)和外部組件進行詳細描述，并且寫入數(shù)據(jù)定義中。如果產(chǎn)品的不同部分有不同的外部接口，那么應該把這些外部接口的全部詳細需求并入到這一部分實例中。注意：必須將附加用戶類的特征與外部接口需求加以區(qū)分，附加用戶類的特征描述的是通過接口取得軟件產(chǎn)品的數(shù)據(jù)和服務的人的需求；而外部接口需求描述的是接口本身的需3.1用戶界面陳述需要使用在用戶界面上的軟件組件，描述每一個用戶界面的邏輯特征。必須注意，這里需要描述的是用戶界面的邏輯特征，而不是用戶界面。以下是可能包括的一些特征：●將要采用的圖形用戶界面(GUI)標準或者產(chǎn)品系列的風格；●有關(guān)屏幕布局或者解決方案的限制；●將要使用在每一個屏幕(圖形用戶界面)上的軟件組件，可能包括：■各種功能組件；●各種顯示格式的規(guī)定，可能包括：■不同情況下文字的對齊方式；■不同情況下數(shù)字的表現(xiàn)格式與對齊方式■日期的表現(xiàn)方法與格式；■計時方法與時間格式；●錯誤信息顯示標準；對于用戶界面的細節(jié)，例如：一個特定對話框的布局，應該寫入具體的用戶界面設計說明中，而不能寫入軟件需求規(guī)格說明中。如果采用現(xiàn)成的、合適的用戶界面設計規(guī)范(標準),或者另文描述，可以在這里直接說明，并且將其加入?yún)⒖嘉墨I。3.2硬件接口描述待開發(fā)的軟件產(chǎn)品與系統(tǒng)硬件接口的特征，若有多個硬件接口，則必須全都描述。接口特征的描述內(nèi)容可能包括：●支持的硬件類型；軟、硬件之間交流的數(shù)據(jù)；控制信息的性質(zhì)；使用的通訊協(xié)議；3.3軟件接口描述該軟件產(chǎn)品與其它外部組件的連接，這些外部組件必須明確它們的名稱和版本號以資識別，可能的外部組件包括：●集成的商業(yè)組件說明：這里所說的“集成的商業(yè)組件”,是指與系統(tǒng)集成的商業(yè)組件，而不是與軟件產(chǎn)品集成的商業(yè)組件。例如：中間件、消息服務，等等。描述并且明確軟件產(chǎn)品與軟件組件之間交換數(shù)據(jù)或者消息的目的。描述所需要的服務，以及與內(nèi)部組件通訊的性質(zhì)。確定軟件產(chǎn)品將與組件之間共享的數(shù)據(jù)。如果必須使用一種特殊的方法來實現(xiàn)數(shù)據(jù)共享機制，例如：在多用戶系統(tǒng)中的一個全局數(shù)據(jù)區(qū)，那么就必須把它定義為一種實現(xiàn)上的限制。描述與軟件產(chǎn)品所使用的通訊功能相關(guān)的需求，包括：網(wǎng)絡通訊標準或者協(xié)議；●數(shù)據(jù)交互用電子表格；必須定義相關(guān)的：)通訊安全或加密問題；數(shù)據(jù)傳輸速率；同步和異步通訊機制；4.系統(tǒng)功能需求需要進行詳細的需求記錄，詳細列出與該系統(tǒng)功能相關(guān)的詳細功能需求，并且，唯一地標識每一項需求。這是必須提交給用戶的軟件功能，使得用戶可以使用所提供的功能執(zhí)行服務或者使用所指定的使用實例執(zhí)行任務。描述軟件產(chǎn)品如何響應己知的出錯條件、非法輸入、非法動作。如果每一項功能需求都能用一項，也只需要用一項測試用例就能進行驗證，那么就可以認為功能需求已經(jīng)適當?shù)剡M行描述了。如果某項功能需求找不到合適的測試用例，或者必須使用多項測試用例才能驗證，那么該項功能需求的描述必然存在某些問題。功能需求是根據(jù)系統(tǒng)功能，即軟件產(chǎn)品所提供的主要服務來組織的。可以通過使用實例、運行模式、用戶類、對象類或者功能等級來組織這部分內(nèi)容，也可以便用這些元素的組合。總而言之，必須選擇一種是讀者容易理解預期產(chǎn)品的組織方案。用簡短的語句說明功能的名稱，例如：“4.1系統(tǒng)參數(shù)管理”。按照服務組織的順序，逐條闡述系統(tǒng)功能。無論說明的是何種功能，都應該針對該系統(tǒng)功能重復敘述4.1~4.3這三個可以通過各種方式來組織這一部分內(nèi)容，例如采用：使用實例、運行模式、用戶類、對象類、功能等級等，也可以采用它們的組合。其最終目的是，讓讀者容易理解即將開發(fā)的軟件產(chǎn)品。一般來說，每個使用實例都對應一個系統(tǒng)功能，因而按照使用實例來組織內(nèi)容比較容易讓用戶理解。對應一些被共享的獨立使用實例，可以定義一些公用系統(tǒng)功能。必須特別注意的是，在2.2節(jié)“產(chǎn)品的功能”中描述的全部需求，以及它們的規(guī)格說明；必須在某個系統(tǒng)功能描述中有所反映，而且不應重復。4.1說明和優(yōu)先級對該系統(tǒng)功能進行簡短的說明，并且指出該系統(tǒng)功能的優(yōu)先級是：高、中、還是低。需要的話，還可以包括對特定優(yōu)先級部分的評價，例如：利益、損失、費用和風險，其相對優(yōu)先等級可以從1(低)到9(高)。4.2激勵╱響應序列列出輸入激勵(用戶動作、來自外部設備的信號或者其它觸發(fā))并且定義針對這——功能行為的系統(tǒng)響應序列，這些序列將與使用實例中相關(guān)的對話元素相對應。描述激勵╱響應序列時，不僅需要描述基本過程，而且應該描述可選(擴充)過程，包括例外(引起任務不能順序完成的情況稱為例外)。疏忽了可選過程，有可能影響軟件產(chǎn)品的功能；如果遺漏例外過程，則有可能會引發(fā)系統(tǒng)崩潰。如果采用流程圖來描述激勵╱響應序列，比較容易讓用戶理解。4.3輸入╱輸出數(shù)據(jù)列出輸入數(shù)據(jù)(用戶輸入、來自外部接口的輸入或者其它輸入)并且定義針對這些輸入數(shù)據(jù)的處理(計算)方法，以及相應地輸出數(shù)據(jù)，描述對應區(qū)別：輸入數(shù)據(jù)和輸出數(shù)據(jù)。當有大量數(shù)據(jù)需要描述時，也可以分類描述數(shù)據(jù)，并且注明各項數(shù)據(jù)的輸入、輸出屬性。對于每一項數(shù)據(jù)，均需要描述：數(shù)據(jù)類型；對于復雜的處理方法，僅僅給出算法原理是不夠的，必須描述詳細的計算過程，并且列出每一步具體使用的實際算式；如果計算過程中涉及查表、判斷、迭代等處理方法，應該給出處理依據(jù)和相關(guān)數(shù)據(jù)。如果計算方法很簡單，也可以將其從略，不加描述。5.其它非功能需求在這里列舉出所有非功能需求，主要包括可靠性、安全性、可維護性、可擴展性、可測5.1性能需求闡述不同應用領(lǐng)域?qū)浖a(chǎn)品性能的需求，并且說明提出需求的原理或者依據(jù)，以幫助開發(fā)人員做出合理的設計選擇。盡可能詳細地描述性能需求，如果需要，可以針對每個功能需求或者特征分別陳述其性能需求。在這里確定：●相互合作的用戶數(shù)量；)系統(tǒng)支持的并發(fā)操作數(shù)量；響應時間；與實時系統(tǒng)的時間關(guān)系：容量需求■磁盤空間；■數(shù)據(jù)庫中表的最大行數(shù)。5.2安全措施需求詳盡陳述與軟件產(chǎn)品使用過程中可能發(fā)生的損失、破壞、危害相關(guān)的需求。定義必須采取的安全保護或動作，以及必須預防的潛在危險動作。明確軟件產(chǎn)品必須遵從的安全標準、策略、或規(guī)則。5.3安全性需求詳盡陳述與系統(tǒng)安全性、完整性問題相關(guān)的需求，或者與個人隱私問題相關(guān)的需求。這些問題將會影響到軟件產(chǎn)品的使用，和軟件產(chǎn)品所創(chuàng)建或者使用的數(shù)據(jù)的保護。定義用戶身份認證，或備授權(quán)需求。明確軟件產(chǎn)品必須滿足的安全性或者保密性策略。也可以通過稱為完整性的質(zhì)量屬性來闡述這些需求。一個典型的軟件系統(tǒng)安全需求范例如下：“每個用戶在第一次登錄后，必須更改他的系統(tǒng)預置登錄密碼，系統(tǒng)預置的登錄密碼不能重用。”5.4軟件質(zhì)量屬性詳盡陳述對客戶和開發(fā)人員至關(guān)重要的在軟件產(chǎn)品其它方面表現(xiàn)出來的質(zhì)量功能。這些功能必須是確定的、定量的、在需要時是可以驗證的。至少也應該指明不同屬性的相對側(cè)重點，例如：易用性優(yōu)于易學性，或者可移植性優(yōu)于有效性。5.5業(yè)務規(guī)則列舉出有關(guān)軟件產(chǎn)品的所有操作規(guī)則，例如：那些人在特定環(huán)境下可以進行何種操作。這些本身不是功能需求，但是他們可以暗示某些功能需求執(zhí)行這些規(guī)則。一個業(yè)務規(guī)則的范例如下：“進行達到或者超過10,000,00元人民幣的儲蓄業(yè)務時，必須通過附加的管理員列舉業(yè)務規(guī)則時，可以根據(jù)規(guī)則的數(shù)量，選取合適的編目方式。5.6用戶文檔列舉出將與軟件產(chǎn)品一同交付的用戶文檔，并且明確列出本文件中用到的專業(yè)術(shù)語的定義，以及有關(guān)縮寫的定義(如有可能，列出相關(guān)的外文原詞)。為了便于非軟件專業(yè)或者非計算機專業(yè)人士閱讀軟件產(chǎn)品需求分析報告，要求使用非軟件專業(yè)或者非計算機專業(yè)的術(shù)語描述軟件需求。所以這里所指的專業(yè)術(shù)語層面上的專業(yè)術(shù)語，而不是軟件專業(yè)或者計算機專業(yè)的術(shù)語。但是，對于無法回避的軟件專業(yè)或者計算機專業(yè)術(shù)語，也應該列入詞匯表并且加以準確定義。數(shù)據(jù)定義是一個定義了應用程序中使用的所有數(shù)數(shù)據(jù)定義的維護獨立于軟件需求規(guī)格說明，并且在軟件產(chǎn)品開發(fā)和維護的任何階段，均向風如果為軟件開發(fā)項目創(chuàng)建一個獨立的數(shù)據(jù)定義，而不是為每一項特性描述有關(guān)的數(shù)據(jù)也不方便閱讀。因此還是建議為每個特性描述有關(guān)的數(shù)據(jù)項，匯總數(shù)據(jù)項創(chuàng)建數(shù)據(jù)定根據(jù)數(shù)據(jù)定義復核全部數(shù)據(jù)，使得它們的名稱和含義完全一致。必須注意的是，為了避免二義性，在匯總數(shù)據(jù)項時應該根據(jù)數(shù)據(jù)項所代表的實際意義匯總，而不是根據(jù)數(shù)據(jù)該英文名稱應該符合命名規(guī)范，因為在軟件開發(fā)時將沿用該英文名稱?？梢允褂脫?jù)項，名稱寫在左邊，定義寫在右邊。常見數(shù)據(jù)項的描述方式如下：一個原數(shù)據(jù)元素是不可分解的，可以將一個數(shù)量值賦給它。含義、類型、數(shù)據(jù)大小、格式、計量單位、精度以及取值范注釋文本，描述原數(shù)據(jù)元素的定義。括號括起來寫在原數(shù)據(jù)元素的定義前。在兩項離散值之間，使用管道符分隔。義中定義過的，結(jié)構(gòu)中也可以包括其它結(jié)構(gòu)，9.待定問題列表編輯一張在軟件產(chǎn)品需求分析報告中待確定問題時的列表，附錄B軟件概要設計報告文檔模板1.引言25 1.3預期讀者和閱讀建議 1.4參考資料 2.1限制和約束 2.2設計原則和設計要求 3.1系統(tǒng)組織設計 3.2系統(tǒng)結(jié)構(gòu)設計 3.2.1系統(tǒng)特性表 3.2.2系統(tǒng)特性結(jié)構(gòu)圖 3.3系統(tǒng)接口設計 3.3.1系統(tǒng)接口表 3.3.2系統(tǒng)接口傳輸協(xié)議說明 3.4系統(tǒng)完整性設計 4.系統(tǒng)出錯處理設計314.1系統(tǒng)出錯處理表 4.2維護處理過程表 5.1系統(tǒng)開發(fā)技術(shù)說明表 5.2開發(fā)技術(shù)應用說明 寫的，并且應該如何閱讀、理解和解釋這份文檔。1.1編寫目的軟件產(chǎn)品意義、作用、以及最終要達到的意圖。通過這份軟件系統(tǒng)概要設計報告詳盡說明了該軟件產(chǎn)品的軟件結(jié)構(gòu)，包括數(shù)據(jù)庫結(jié)構(gòu)和出錯處理，從而對該軟件產(chǎn)品的結(jié)構(gòu)的描述。如果這份軟件系統(tǒng)概要設計報告只與整個系統(tǒng)的某一部分有關(guān)系，那么只定義軟件系統(tǒng)概要設計報告中說明的那個部分或子系統(tǒng)。具體說明本軟件開發(fā)項目的全部風險承擔者，以及各自在本階段所需要承擔的主要風1.3預期讀者和閱讀建議列舉本軟件系統(tǒng)概要設計報告所針對的各種不同的預期讀者，例如，可能的讀者包括：描述文檔中，其余部分的內(nèi)容及其組織結(jié)構(gòu)，并且針對每一類讀者提出最適合的文檔閱列舉編寫軟件產(chǎn)品概要設計報告時所用到的參考文獻及資料，可能包括：●發(fā)表日期或者簽約日期；本節(jié)描述現(xiàn)有開發(fā)條件和需要實現(xiàn)的目標，說明進行概要設計時應該遵循的設計原則和2.1限制和約束簡要描述起到限制和約束作用的各種可能存在的條件，例如：并且說明在上述條件下，應該實現(xiàn)的系統(tǒng)目標，2.2設計原則和設計要求描述對本軟件系統(tǒng)進行概要設計的原則，通?？梢钥紤]以下幾方面的內(nèi)容：3.系統(tǒng)邏輯設計本節(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ù)據(jù)字典：應首先參照附錄B說明，編寫軟件數(shù)據(jù)字典。在完成軟件數(shù)據(jù)字典后，再進行系統(tǒng)設計。3.1系統(tǒng)組織設計系統(tǒng)組織設計通過系統(tǒng)組織表描述本系統(tǒng)由哪些子系統(tǒng)(模塊)組成，這些子系統(tǒng)與業(yè)務職能之間的關(guān)系，以及各個子系統(tǒng)的安裝地點。系統(tǒng)組織表的格式如下：子系統(tǒng)編號英文名稱中文名稱業(yè)務職能安裝地點備注其中：子系統(tǒng)編號給出本系統(tǒng)中指定子系統(tǒng)的順序編號。如果本系統(tǒng)末劃分為多個子系統(tǒng)，僅由一個運行模塊組成；則本項內(nèi)容仍需要描述，但是本表內(nèi)容只有一行。說明：在一個系統(tǒng)中有可能安裝若干個相同的子系統(tǒng)，在這種情況下，應該視為一個子系統(tǒng)，并且對多個安裝地點分別進行描述。如果相同的子系統(tǒng)通過系統(tǒng)設置，實現(xiàn)的業(yè)務職能具有明顯差異時，應該采用多行進行分別描述，并且在備注子系統(tǒng)英文名稱給出本子系統(tǒng)的英文名稱，該名稱是在應用軟件中實際使用的可執(zhí)行文件名稱，必須能夠說明該子系統(tǒng)的特點。若本系統(tǒng)中只有一個子系統(tǒng)，則本項內(nèi)容仍需要描述，但是本表內(nèi)容只有一行?！褡酉到y(tǒng)中文名稱給出本子系統(tǒng)的中文名稱，該名稱必須能夠說明該子系統(tǒng)的特點。若本系統(tǒng)中只有一個子系統(tǒng)，則本項內(nèi)容仍需要描述，但是本表內(nèi)容只有一行?！駱I(yè)務職能描述該子系統(tǒng)完成的核心業(yè)務。安裝地點描述該子系統(tǒng)實際安裝的部門、或者某個具體地點。針對該子系統(tǒng)，需要說明的其它有關(guān)問題。3.2系統(tǒng)結(jié)構(gòu)設計本節(jié)將對系統(tǒng)特性作較為詳細的描述，并給出系統(tǒng)特性結(jié)構(gòu)圖。3.2.1系統(tǒng)特性表系統(tǒng)特性是系統(tǒng)中完成某項具體操作的基本單元，它由入口參數(shù)，出口參數(shù)以及處理過程三部分組成。系統(tǒng)特性可以具有操作界面，也可以沒有操作界面；可以被其它操作界面、或者系統(tǒng)特性調(diào)用，也可以調(diào)用其它操作界面、非操作界面、或者系統(tǒng)特性；但是不允許遞歸調(diào)用(調(diào)用自己),包括間接遞歸調(diào)用。當系統(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)一編號?！裣到y(tǒng)特性英文名稱系統(tǒng)特性的英文正式名稱，將來用于軟件開發(fā)中，必須符合命名規(guī)范。)系統(tǒng)特性中文名稱系統(tǒng)特性的中文正式名稱，來源于需求規(guī)格說明書中，系統(tǒng)特性一節(jié)中的有關(guān)描●操作功能是指該特性實際完成的操作說明。●調(diào)用對象是指調(diào)用該系統(tǒng)特性的系統(tǒng)對象，這里的系統(tǒng)對象可以是系統(tǒng)特性、也可以是操是指被該系統(tǒng)特性調(diào)用的系統(tǒng)對象，這里的系統(tǒng)對象可以是系統(tǒng)特性、也可以是操作界面。說明：某些較低層的系統(tǒng)特性，可能不存在被調(diào)用對象。描述與該系統(tǒng)特性有關(guān)的其它注意事項。描述與該系統(tǒng)特性表有關(guān)的其它注意事項。系統(tǒng)特性結(jié)構(gòu)圖給出系統(tǒng)特性在邏輯層面上相互之間的關(guān)系，其格說明書中，系統(tǒng)特性一節(jié)中的有關(guān)描述。如果系統(tǒng)劃分為多個子系統(tǒng)，應分別給出系統(tǒng)與子系統(tǒng)、以及各個子系統(tǒng)與系統(tǒng)特性的繪制系統(tǒng)與子系統(tǒng)結(jié)構(gòu)圖時，一般不需要描繪出系統(tǒng)特性，如果確有必要，盡可能只畫如果確有必要可以畫出，但是盡可能不要畫出第三層系統(tǒng)特性。3.3系統(tǒng)接口設計系統(tǒng)接口是一種非可視的系統(tǒng)界面，在多數(shù)情況下，它對用戶是透明的。本節(jié)將對系統(tǒng)接口作較為詳細的描述，并給出接口說明清單。3.3.1系統(tǒng)接口表接口作為系統(tǒng)的一種輸入╱輸出形式，分為網(wǎng)絡接口、數(shù)據(jù)庫接口、RS-232串行通訊接口、IEEE—485串行總線接口、并行I/O接口等等多種類型對于一些為可視界面服務的接口，例如：打印機接口、顯示應用軟件是透明的，所以不在本節(jié)描述范圍內(nèi)。當系統(tǒng)由多個子系統(tǒng)(模塊)組成時，每個子系統(tǒng)分別使用一張系統(tǒng)接口表進行描述。系統(tǒng)接口表的格式如下：子系統(tǒng)編號子系統(tǒng)英文名稱子系統(tǒng)中文名稱接口編號接口名稱接口類型接口性質(zhì)接口速率接口協(xié)議備注說明：其中：子系統(tǒng)編號子系統(tǒng)英文名稱●接口名稱系統(tǒng)接口的正式名稱，必須符合通常習慣?！窠涌陬愋椭赋鲈摻涌谒鶄鬏?shù)臄?shù)據(jù)在該模塊中起到的作用。●接口性質(zhì)指出該接口在通訊中起到的作用，這里的作用可以是：■輸入；■雙向。)接口速率指出該接口的傳輸速率。如果該接口依賴于其它通訊方式，那么傳輸速率將不高于它所依賴的其它通訊方式的速率。●接口協(xié)議給出該接口實際使用的通訊協(xié)議。●相關(guān)對象給出直接使用本接口的系統(tǒng)對象，這里的系統(tǒng)對象，可以是操作界面，也可以是系統(tǒng)特性。描述與該系統(tǒng)接口有關(guān)的其它注意事項?！裾f明描述與該系統(tǒng)接口表有關(guān)的其它注意事項。3.3.2系統(tǒng)接口傳輸協(xié)議說明逐項詳細描述系統(tǒng)接口表中所列出各個系統(tǒng)接口使用的傳輸協(xié)議，以及其它相關(guān)內(nèi)容，例如：驅(qū)動程序、動態(tài)連接庫、等等。3.4系統(tǒng)完整性設計描述系統(tǒng)對象(數(shù)據(jù)元、數(shù)據(jù)類),所受到的邏輯約束關(guān)系。當系統(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)一編號?！裢暾悦Q系統(tǒng)完整性約束的正式名稱，必須符合通常習慣?！裣鄬ο竺暾约s束中的相關(guān)對象(數(shù)據(jù)元和數(shù)據(jù)類)。用一階邏輯表達式表達的約束方程式。描述與該系統(tǒng)完整性約束有關(guān)的其它注意事項。描述與該系統(tǒng)完整性約束表有關(guān)的其它注意事項。4.系統(tǒng)出錯處理設計本節(jié)描述系統(tǒng)發(fā)生外界及內(nèi)在錯誤時，所提供的錯誤信息及處理方法，它包括系統(tǒng)出錯處理表及維護處理過程表。4.1系統(tǒng)出錯處理表本表給出有關(guān)出錯處理的產(chǎn)生原因、提示信息、以及建議處理方法。當系統(tǒng)由多個子系統(tǒng)(模塊)組成時，每個子系統(tǒng)分別使用一張系統(tǒng)出錯處理表進行描述。系統(tǒng)出錯處理表的格式如下子系統(tǒng)編號：子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：錯誤編號錯誤名稱錯誤原因錯誤信息處理方式備注說明：其中：含義同上。子系統(tǒng)英文名稱含義同上。)子系統(tǒng)中文名稱含義同上。錯誤編號整個系統(tǒng)所有錯誤的統(tǒng)一編號。錯誤名稱錯誤的正式名稱，該名稱應該是常用的，并且為人們所普遍接受的。對該錯誤產(chǎn)生原因的解釋與說明。●處理方式描述與該系統(tǒng)錯誤有關(guān)的其它注意事項。系統(tǒng)出錯時，將調(diào)用維護處理過程對錯誤進行處理，有關(guān)維護處理過程的各述。維護處理過程表的格式如下：子系統(tǒng)編號：子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：錯誤編號處理過程處理過程處理功能入口參數(shù)出口參數(shù)備注英文名稱中文名稱說明：其中：●子系統(tǒng)英文名稱●子系統(tǒng)中文名稱錯誤編號系統(tǒng)維護處理過程的英文正式名稱，將來用于軟件開發(fā)中，必須符合命名規(guī)范。系統(tǒng)維護處理過程的中文正式名稱，是系統(tǒng)維護處理過程英文名稱的中文說明。由于一個維護處理過程有可能具有對多個錯誤進行處理的能力，因此該處理功能必須是針對本項錯誤編號的。進行本項錯誤處理時，賦給維護處理過程的入口參數(shù)。進行本項錯誤處理時，維護處理過程返回的出口參數(shù)。5.1系統(tǒng)開發(fā)技術(shù)說明表本表描述系統(tǒng)各個特性開發(fā)時實際使用的具體技術(shù)，只有一些不太常用的技術(shù)需要在這描述。系統(tǒng)開發(fā)技術(shù)說明表的格式如下：子系統(tǒng)編號子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：技術(shù)編號開發(fā)技術(shù)開發(fā)技術(shù)處理功能系統(tǒng)特性編號備注英文名稱中文名稱說明：其中：子系統(tǒng)英文名稱子系統(tǒng)中文名稱該開發(fā)技術(shù)的英文正式名稱，可以便用縮寫。該名稱應該是常用的，并且為人們所普遍接受的。開發(fā)技術(shù)中文名稱該開發(fā)技術(shù)的中文正式名稱，是該開發(fā)技術(shù)英文名稱的中文說明。該名稱應該是常用的，并且為人們所普遍接受的?！裉幚砉δ苊枋霰鹃_發(fā)技術(shù)的處理目的。系統(tǒng)特性編號由于一項開發(fā)技術(shù)可能在多處使用，因此針對一項開發(fā)技術(shù)，有可能存在多個系統(tǒng)特性編號，在此必須一一列出。描述與該系統(tǒng)開發(fā)技術(shù)相關(guān)的其它注意事項。描述與該系統(tǒng)開發(fā)技術(shù)說明表有關(guān)的其它注意事項。5.2開發(fā)技術(shù)應用說明逐項詳細描述系統(tǒng)開發(fā)技術(shù)說明表中所列出各項系統(tǒng)開發(fā)技術(shù)使用的技術(shù)要點，以及其它相關(guān)內(nèi)容，例如：所需的服務、使用的動態(tài)連接庫、調(diào)用的組件、等等。6.數(shù)據(jù)庫設計如果該軟件產(chǎn)品需要使用數(shù)據(jù)庫，不論是使用數(shù)據(jù)庫平臺支撐的，還是采用由軟件產(chǎn)品開發(fā)者自行定義的；都應該在完成軟件產(chǎn)品需求分析報告后，開始進行軟件產(chǎn)品詳細設計之前，按照軟件產(chǎn)品數(shù)據(jù)庫設計說明文檔模板完成數(shù)據(jù)庫設計工作。7.詞匯表列出本文件中用到的專業(yè)術(shù)語的定義，以及有關(guān)縮寫的定義(如有可能，列出相關(guān)的外文原向)。為了便于非軟件專業(yè)或者非計算機專業(yè)人士閱讀軟件系統(tǒng)概要設計報告，要求使用非軟件專業(yè)或者非計算機專業(yè)的術(shù)語進行描述。所以這里所指的專業(yè)術(shù)語，是指業(yè)務層面上的專業(yè)術(shù)語，而不是軟件專業(yè)或者計算機專業(yè)的術(shù)語。但是，對于無法回避的軟件專業(yè)或者計算機專業(yè)術(shù)語，也應該列入詞匯表，并且加以準確定義。8.進度計劃列出進度計劃，包括各子系統(tǒng)、各子模塊完成進度計劃，人員配備計劃等。附錄C軟件詳細設計報告文檔模板1.引言381.1編寫目的 1.3文檔約定 1.4預期讀者和閱讀建議 1.5參考資料 2.1數(shù)據(jù)庫管理系統(tǒng) 2.2開發(fā)工具、中間件以及數(shù)據(jù)庫接口 2.3硬件環(huán)境 2.4網(wǎng)絡環(huán)境 2.5多種支撐環(huán)境開發(fā)要點 3.部件詳細設計414.詞匯表425.部件表格式436.界面表格式43的，并且應該如何閱讀、理解和解釋這份文檔。1.1編寫目的明了該軟件產(chǎn)品的編碼結(jié)構(gòu)，從而對該軟件產(chǎn)品的物理組成進行準確的描述。如果這份軟件系統(tǒng)詳細設計報告只與整個系統(tǒng)的某一部分有關(guān)系，那么只定義軟件系統(tǒng)詳細設計報告中說明的那個部分或子系統(tǒng)。1.2項目風險具體說明本軟件開發(fā)項目的全部風險承擔者，以及各自在本階段所需要承擔的主要風1.3文檔約定描述編寫文檔時所采用的標準(如果有標準的話),或者各種編寫約定。編寫約定應該包1.4預期讀者和閱讀建議列舉本軟件系統(tǒng)詳細設計報告所針對的各種不同的預期讀者，例如，可能的讀者包括：描述文檔中，其余部分的內(nèi)容及其組織結(jié)構(gòu)，并且針對每一類讀者提出最適合的文檔閱列舉編寫軟件系統(tǒng)詳細設計報告時所用到的參考文獻及資料，可能包括：●屬于本項目的其它已發(fā)表文件；為了方便讀者查閱，所有參考資料應該按一定順序排2.1數(shù)據(jù)庫管理系統(tǒng)描述數(shù)據(jù)庫管理系統(tǒng)、以及安裝配置情況，需要描述的內(nèi)容可能包括：這里的產(chǎn)品名稱指的是數(shù)據(jù)庫發(fā)行廠商發(fā)布產(chǎn)品時公布的正式商品名稱，不應該使用別名、簡稱、研發(fā)代號等非正式名稱，以免混淆；同樣的道理，發(fā)行廠商的名稱也應該使用正式名稱。數(shù)據(jù)庫管理系統(tǒng)的準確版本號，必須按產(chǎn)品的實際情況描述到最細節(jié)的版本號。補丁包版本號描述實際上將要使用的數(shù)據(jù)庫管理系統(tǒng)補丁包的版本號，必須注意，在某些情況語言或代碼集對于只支持一種語言或者一個代碼集的數(shù)據(jù)庫管理系統(tǒng)來說，該項描述不具意義。對于支持多種語言或者多個代碼集的數(shù)據(jù)庫管理系統(tǒng)來說，該項描述指的是描述數(shù)據(jù)庫管理系統(tǒng)的實際安裝位置，應該分別對管理系統(tǒng)安缺位置和數(shù)據(jù)存放描述數(shù)據(jù)庫管理系統(tǒng)在實際安裝時應該配置的各個參數(shù)，對于分布式數(shù)據(jù)庫，必須分別描述每一個數(shù)據(jù)庫管理系統(tǒng)的配置參數(shù)。描述所選用的工具軟件和中間件的名稱、版本號，以接口、等答應該逐項分別描述，并且說明每一項的適用范圍。需要描述的內(nèi)容可能包括：數(shù)據(jù)庫接口名稱描述數(shù)據(jù)庫接口的名稱，如果使用別名時，應同時描述使用的別名。描述與數(shù)據(jù)庫接口的方式，并說明該接口方式的特點；如果需要，還應該說明使描述各種接口設置，包括：協(xié)議、端口號等等。描述所選用的硬件環(huán)境，各種機型，例如：服務器、工作站描述可能影響應用軟件訪問數(shù)據(jù)庫的各種網(wǎng)絡環(huán)境，如果存在加密傳輸、VPN鏈路等情況，也必須描述。對于結(jié)構(gòu)復雜的網(wǎng)絡，還應該提供網(wǎng)絡拓撲圖和數(shù)據(jù)流向示意圖。需要描述的內(nèi)容可能包括：●網(wǎng)絡操作系統(tǒng)；2.5多種支撐環(huán)境開發(fā)要點當軟件產(chǎn)品將來可能遇到的多種運行環(huán)境時，應該分別按照3.1節(jié)至3.4節(jié)的內(nèi)容列表描述。如果軟件產(chǎn)品各個子系統(tǒng)的運行環(huán)境不完全一樣時，應該分子系統(tǒng)按照3.1節(jié)至3.4節(jié)的內(nèi)容列表描述。遇到上述情況時，不僅需要詳細描述各種軟件開發(fā)、調(diào)試、測試的環(huán)境，為了確實保證軟件產(chǎn)品將來能夠在各種可能的運行環(huán)境中正常運行，還需要對軟件產(chǎn)品進行嚴格的配置管3.部件詳細設計這里所提及的軟件部件，系指能夠完成特定功能、相對獨立的一些代碼集合，它們可以是插件、組件、控件、函數(shù)、過程、子程序、動態(tài)連接庫、等等。具體呈何種形態(tài)，取決于實際采用的開發(fā)工具和將要實現(xiàn)的軟件結(jié)構(gòu)。按照合適的順序，逐個描述軟件部件的詳細情況。描述的順序可以是按層次橫向進行描述，也可以是按模塊縱向進行描述，總之描述的方式必須有利于讀者理解軟件結(jié)構(gòu)。每個部件采用一張軟件部件表進行描述，軟件部件表的格式見附表一，其中；●部件編號軟件部件的統(tǒng)一順序編號；對于實行配置管理的軟件開發(fā)項目來說，該編號必須與該部件在配置管理中的編號相同。●部件名稱軟件部件的正式英文名稱，該名稱是程序中使用的實際名稱，必須符合國家相關(guān)所屬子系統(tǒng)對于不分為多個子系統(tǒng)的軟件來說，不必填寫該欄。指被該部件所調(diào)用的部件的編號和名稱。指該部件入口數(shù)據(jù)類名稱或者數(shù)據(jù)名稱，以及對這些數(shù)據(jù)的描述；指該部件出口數(shù)據(jù)類名稱或者數(shù)據(jù)名稱，以及對這些數(shù)據(jù)的描述；指該部件的算法形式表示，如果很簡單、或者不存在，也可以為空。指該部件的處理流程的詳細表示或描述。指該部件完成開發(fā)后的最終表示形式，具體形式取決于開發(fā)工具和軟件結(jié)構(gòu)，表■插件、組件、控件，■存儲過程，■動態(tài)連接庫：■等等。描述該部件所適合的運行環(huán)境，即說明該部件是針對何種運行環(huán)境所開發(fā)的；可以直接描述運行環(huán)境，也可以描述運行環(huán)境的編號；對于實行配置管理的軟件開發(fā)項目來說，該描述必須與該部件在配置管理中的描指開發(fā)該部件時必須滿足的專門要求，這些要求可以是：■精度■響應時間■可重用性■等等。提出的要求一般不宜超過3項，以排列的先后順序表示優(yōu)先級。列出本文件中用到的專業(yè)術(shù)語的定義，以及有關(guān)縮寫的定義(如有可能，列出相關(guān)的外文原詞)。為了便于非軟件專業(yè)或者非計算機專業(yè)人士也能夠在一定的范圍內(nèi)，讀懂軟件系統(tǒng)詳細設計報告，要求盡可能使用非軟件專業(yè)或者非計算機專業(yè)的術(shù)語進行描述。所以這里所指的專業(yè)術(shù)語，是指業(yè)務層面上的專業(yè)術(shù)語，而不是軟件專業(yè)或者計算機專業(yè)的術(shù)語。但部件編號部件名稱所屬子系統(tǒng)部件調(diào)用者部件被調(diào)用者部件入口參數(shù)部件入口參數(shù)算法：流程描述：表示性能運行環(huán)境性能要求說明：如果軟件不見使用一張表表述不完時，可以采用續(xù)表描述，但是必須注明是那張表的界面編號部件名稱界面性質(zhì)界面介質(zhì)表示形式；界面參數(shù)參數(shù)名內(nèi)容說明附錄D軟件數(shù)據(jù)庫設計報告文檔模板1.引言491.1編寫目的 1.2項目來源 1.3文檔約定 1.4預期讀者和閱讀建議 1.5參考資料 2.數(shù)據(jù)庫命名規(guī)則503.數(shù)據(jù)庫設計說明503.1數(shù)據(jù)庫邏輯設計 3.2數(shù)據(jù)庫物理設計 3.3數(shù)據(jù)庫分布 3.4基表設計 3.5視圖設計 3.6索引設計 3.7完整性約束 3.8授權(quán)設計 3.9觸發(fā)器設計 3.10存儲過程設計 3.11數(shù)據(jù)復制設計 5.歷史數(shù)據(jù)處理57引言是對這份數(shù)據(jù)庫設計說明書的概覽，是為了幫助閱讀者了解這份文檔是如何編寫1.1編寫目的說明這份數(shù)據(jù)庫設計說明書是為哪份軟件產(chǎn)品構(gòu)。如果這份數(shù)據(jù)庫設計說明書只與整個系統(tǒng)的某一部分有關(guān)系，那么只定義數(shù)據(jù)庫設計說1.2項目來源具體說明本軟件開發(fā)項目的全部風險承擔者，以及各自在本階段所需要承擔的主要風1.3文檔約定描述編寫文檔時所采用的各種排版約定。排版約定應該包括：1.4預期讀者和閱讀建議列舉編寫需求規(guī)格說明書時所用到的參考文獻及資料，可能包括；為了方便讀者查閱，所有參考資料應該按一定順序排列。如果可2.數(shù)據(jù)庫命名規(guī)則完整并且清楚的說明本數(shù)據(jù)庫的命名規(guī)則，在《南京市交通局信息化數(shù)據(jù)庫建設規(guī)范》3.數(shù)據(jù)庫設計說明數(shù)據(jù)庫設計人員根據(jù)《軟件需求分析報告》,創(chuàng)建與數(shù)據(jù)庫相關(guān)的實體關(guān)系如采用面對對象的分析和設計方法，則此處的實體相當于類。3.2數(shù)據(jù)庫物理設計在此處應給出完整的數(shù)據(jù)庫物理結(jié)構(gòu)E-R圖。開發(fā)者應根據(jù)邏輯設計的結(jié)果，進行數(shù)3.3數(shù)據(jù)庫分布數(shù)據(jù)庫分布采用一張表格進行描述，其格式如下：數(shù)據(jù)庫編號數(shù)據(jù)庫管理系統(tǒng)名稱數(shù)據(jù)庫管理系統(tǒng)版本號數(shù)據(jù)庫英文名稱數(shù)據(jù)庫中文名稱數(shù)據(jù)庫安裝物理位置其中：若本系統(tǒng)中只有一個數(shù)據(jù)庫，則本項內(nèi)容不需要描述，本表內(nèi)容也只有一行。數(shù)據(jù)庫管理系統(tǒng)名稱給出本系統(tǒng)中指定數(shù)據(jù)庫管理系統(tǒng)的商品名稱。若本系統(tǒng)中只有一種數(shù)據(jù)庫管理系統(tǒng)，則本項內(nèi)容不需要描述。給出本系統(tǒng)中指定數(shù)據(jù)庫管理系統(tǒng)的版本號。若本系統(tǒng)中只有一個版本的數(shù)據(jù)庫管理系統(tǒng)，則本項內(nèi)容不需要描述。數(shù)據(jù)庫英文名稱京市交通局信息化數(shù)據(jù)庫建設規(guī)范》中相關(guān)命名規(guī)范?！駭?shù)據(jù)庫中文名稱給出本數(shù)據(jù)庫的中文名稱，該名稱是本數(shù)據(jù)庫英文名稱的說明。給出本數(shù)據(jù)庫安裝的實際位置，必須描述清楚該位置是在那個物理設備的哪一個邏輯存儲設備上，以及存儲文件的名稱。每個基表采用一張表格進行描述，其格式如下：數(shù)據(jù)庫編號：基表編號：基表英文名稱：基表中文名稱：字段編號英文字段名中文字段名字段類型備注說明：其中給出本基表的英文名稱，該名稱是在應用軟件中實際使用的名稱，必須符合命給出本基表的中文名稱，該名稱是本基表英文名稱的說明。該基表中，各個字段的英文名稱，該名稱必須符合《南京市交通局信息化數(shù)據(jù)庫該基表中，各個字段的中文名稱，該名稱是英文字段名的說明?！鲲@示格式與小數(shù)位數(shù)；■有效性規(guī)則與約束；■等等說明一些有關(guān)本表的、必須描述清楚的問題，需要描述的內(nèi)容可能包括■主關(guān)鍵字；■數(shù)據(jù)復制；3.5視圖設計每個視圖采用一張表格進行描述，其格式如下：數(shù)據(jù)庫編號：視圖編號：視圖英文名稱：視圖中文名稱：相關(guān)基表和視圖：字段編號英文字段名中文字段名字段類型字段源備注說明：其中：數(shù)據(jù)庫編號給出本視圖的順序編號。視圖英文名稱給出本視圖的英文名稱，該名稱是在應用軟件中實際使用的名稱，必須符合命名規(guī)范。視圖中文名稱給出本視圖的中文名稱，該名稱是本視圖英文名稱的說明。●相關(guān)基表和視圖列出建立該視圖時，所用到的基表和視圖。該視圖中，各個字段的順序編號。英文字段名該視圖中，各個字段的英文名稱，該名稱必須符合《南京市交通局信息化數(shù)據(jù)庫建設規(guī)范》中相關(guān)命名規(guī)范。中文字段名該視圖中，各個字段的中文名稱，該名稱是英文字段名的說明。該視圖中，各個字段的類型；如果需要，在說明類型時，還需要說明字段長度。該視圖中，各個字段的來源，即該字段原來是那個表或者那個視圖中的那個字段；在某些情況下，字段可能來自一個特定的表達式。該視圖中，各個字段有關(guān)的限制性說明，包括：■值域；■缺省值；■空字段限制；■顯示格式與小數(shù)位數(shù)；■有效性規(guī)則與約束；■標題；■等等。說明說明一些有關(guān)本視圖的、必須描述清楚的問題，需要描述的內(nèi)容可能包括：■權(quán)限；每個數(shù)據(jù)庫的所有采用一張表格進行描述，其格式如下：數(shù)據(jù)庫編號：索引編號基表名稱索引名稱字段集名稱備注其中：數(shù)據(jù)庫編號含義同上。索引編號給出本項索引的順序編號。給出本項索引所在的基表名稱。索引名稱給出本項索引的名稱。給出本項索引所在的字段名稱或者字段集名稱。備注描述有關(guān)本項索引中，其它需要說明的事項，例如：排序方式、等等。3.7完整性約束每個數(shù)據(jù)庫的完整性約束采用一張表格進行描述，其格式如下：數(shù)據(jù)庫編號：索引編號基表名稱索引名稱字段集名稱備注其中：數(shù)據(jù)庫編號含義同上。約束編號給出本項完整性約束的順序編號。完整性約束名給出本項完整性約束的名稱。給出本項完整性約束所在的基表名稱。字段名給出本項完整性約束所在的字段名稱。約束表達式給出本項完整性約束的邏輯表達式。描述有關(guān)本項完整性約束中，其它需要說明的事項。每個數(shù)據(jù)庫的授權(quán)采用一張表格進行描述，其格式如下：數(shù)據(jù)庫編號：授權(quán)編號用戶名稱對象名稱權(quán)限備注其中：●用戶名稱給出本項授權(quán)的用戶名稱，這里的用戶不一定是具體用戶，也可以是用戶組。給出本項授權(quán)的對象名稱，例如：基表、字段、等等。被授權(quán)用戶在該對象上擁有的訪問權(quán)限，例如：查詢權(quán)、修改權(quán)、等等?！裼|發(fā)器英文名稱給出本觸發(fā)器的英文名稱，必須符合《南京市交通局信息化數(shù)據(jù)庫建設規(guī)范》中給出本觸發(fā)器的中文名稱，該名稱是本觸發(fā)器英文名稱的說明。給出該觸發(fā)器產(chǎn)生觸發(fā)的條件。給出該觸發(fā)器被觸發(fā)后所執(zhí)行的動作內(nèi)容。每個數(shù)據(jù)庫的授權(quán)采用一張表格進行描述，其格式如下：數(shù)據(jù)庫編號：存儲過程編號：存儲過程英文名稱：存儲過程中文名稱：存儲過程內(nèi)容說明：其中：給出本存儲過程的英文名稱，該名稱是在應用軟件中實際使用的名稱，必須符●存儲過程中文名稱給出本存儲過程的中文名稱，該名稱是本存儲過程英文名稱的說明。給出該存儲過程算法或者描述詳細內(nèi)容，如果需要，應該輔以流程圖說明。描述本存儲過程需要說明的一些事項。每項數(shù)據(jù)復制采用一張表格進行描述，其格式如下：數(shù)據(jù)復制編號：復制英文名稱：復制中文名稱：源數(shù)據(jù)庫編號：目標數(shù)據(jù)庫編號：復制說明：執(zhí)行方式：源數(shù)據(jù)庫名稱目標數(shù)據(jù)庫名稱基表名稱字段名稱基表名稱字段名稱備注：其中：●數(shù)據(jù)復制英文名稱給出本數(shù)據(jù)復制的英文名稱，該名稱是在應用軟件中實際使用的名稱，必須符給出本數(shù)據(jù)復制的中文名稱，該名稱是本數(shù)據(jù)復制英文名稱的說明。作為復制數(shù)據(jù)源的數(shù)據(jù)庫編號，編號含義同上。作為復制目標的數(shù)據(jù)庫編號，編號含義同上。給出該復制的詳細描述，如果需要，應該輔以示意圖說明。必須說明執(zhí)行周期或者執(zhí)行條件。必須說明被那個模塊調(diào)用，以及是手動調(diào)用，還是條件調(diào)用。給出對應源數(shù)據(jù)庫編號的源數(shù)據(jù)庫名稱。給出對應目標數(shù)據(jù)庫編號的目標數(shù)據(jù)庫名稱。分別給出源數(shù)據(jù)庫和目標數(shù)據(jù)庫中，進行對應復制的源基表名稱和目標基表名分別給出源基表和目標基表中，進行對應復制的源字段名稱和目標字段名稱。描述本復制中需要說明的一些特殊事項。列出本文件中用到的專業(yè)術(shù)語的定義，以及有關(guān)縮寫的定義(如有可能，列出相關(guān)的閱讀數(shù)據(jù)庫設計說明書，要求使用非軟件專5.歷史數(shù)據(jù)處理取決于數(shù)據(jù)庫設計容量大小，以及數(shù)據(jù)流強度(即在單位時間內(nèi)進入數(shù)據(jù)庫的數(shù)據(jù)記錄數(shù)量)設計歸檔數(shù)據(jù)庫時，需要根據(jù)具體情況進行考慮，下面列出一些可能需要考慮的內(nèi)容：多數(shù)情況下，歸檔的歷史數(shù)據(jù)并不需要保存全部細節(jié)，可以去掉部分細節(jié)，采用壓縮歸檔處理的方法減少歸檔數(shù)據(jù)庫的占用空間。注意：如果壓縮數(shù)據(jù)時，去掉了不該去掉的細節(jié)，將是無可挽回的。附錄E軟件測試(驗收)大綱1.引言62 2.測試日期安排633.測試小組及成員63 4.2軟件文檔檢查 4.2.1必須提供檢查的文檔 4.2.2其他可能需要檢查的文檔 4.2.3由業(yè)主確定必須檢查的其他文檔 4.2.4文檔質(zhì)量的度量準則 4.3軟件代碼測試 4.3.1源代碼一般性檢查 4.3.2軟件一致性檢查 4.4.3功能測試 4.4.5性能測試 4.4.7邏輯性測試 4.4.8破壞性測試 4.4.9安全性測試 5.測試結(jié)果交付方式67為了盡可能的找出軟件的不足，提高軟件的質(zhì)量，促進軟件的成功驗收，專門制定了本大綱。其主要目的在于為所要進行的測試工作制定各種必要的準則和規(guī)范，以及在有關(guān)方面協(xié)議的基礎上對測試工作進行合理組織與管理。本大綱所提及的術(shù)語，其定義遵照GB/T11457標準。1.3參照標準軟件工程術(shù)語信息技術(shù)軟件生存期過程計算機軟件產(chǎn)品開發(fā)文件編制指南計算機軟件需求說明編制指南計算機軟件測試文件編制指南計算機軟件質(zhì)量保證計劃規(guī)范計算機軟件配置管理計劃規(guī)范軟件維護指南計算機軟件可靠性和可維護性管理軟件文檔管理指南開發(fā)者企業(yè)規(guī)范軟件開發(fā)者有關(guān)軟件工程的規(guī)范●其它文件例如：合同書等，法律文件中的有關(guān)規(guī)定。說明：(1)應該遵循自頂而下、就嚴不就寬的原則，除非合同書等法律文件中另有規(guī)定。(2)標記(*)號的標準為推薦標準。2.測試日期安排開發(fā)方如期交付軟件的基礎上，由業(yè)主審核確定具體日期安排。3.測試小組及成員成。測試組設組長一