軟件詳細設(shè)計模板(最全面)

1、研發(fā)生產(chǎn)中心文檔編號版本A1密級商密A項目名稱Xx系統(tǒng)項目來源Xxx系統(tǒng)詳細設(shè)計說明書（內(nèi)部資料請勿外傳）編 檢 審 批寫：日查：日期：日期：準：日期：XX公司版權(quán)所有不得復(fù)制文檔變更記錄序號艾更（+/-）說明作者版本號日期批準121 .引言51.1 編寫目的和范圍51.2 術(shù)語表51.3 參考資料51.4 使用的文字處理和繪圖工具52 .全局數(shù)據(jù)Z勾說明72.1 常量72.2 變量82.3 數(shù)據(jù)Z構(gòu)83 .模塊設(shè)計93.1 用例圖93.2 功能設(shè)計說明103.2.1 模塊1103.2.2 模塊2114 .接口設(shè)計124.1 內(nèi)部接口124.2 外部接口124.2.1 接口說明124.2.2

2、調(diào)用方式125 .數(shù)據(jù)庫設(shè)計126 .系統(tǒng)安全保密設(shè)計126.1 說明126.2 設(shè)計126.2.1 數(shù)據(jù)傳部分126.2.2 IP過濾分部136.2.3 身份驗證部分137 .系統(tǒng)性能設(shè)計138 .系統(tǒng)出錯處理131 .引言1.1 背景此文檔的背景1.2 編寫目的和范圍說明寫這份詳細設(shè)計說明書的目的。本詳細設(shè)計說明書編寫的目的是說明程序模塊的設(shè)計考慮，包括程序描述、輸入/輸出、算法和流程邏輯等，為軟件編程和系統(tǒng)維護提供基礎(chǔ)。本說明書的預(yù)期讀者為系統(tǒng)設(shè)計人員、軟件開發(fā)人員、軟件測試人員和項目評審人員。1.3 術(shù)語表定義系統(tǒng)或產(chǎn)品中涉及的重要術(shù)語，為讀者在閱讀文檔時提供必要的參考信息序號術(shù)語或縮

3、略語說明性定義|1PMProjectManager,項目經(jīng)理21.4 參考資料列出有關(guān)資料的名稱、作者、文件編號或版本等。參考資料包括:a.需求說明書、架構(gòu)設(shè)計說明書等；b.本項目的其他已發(fā)表的文件；c.引用文件、資料、軟件開發(fā)標準等。資料名稱作者文件編號、版本資料存放地點1.5 使用的文字處理和繪圖工具文字處理軟件：編寫設(shè)計文檔使用的文字處理軟件，如RedOffice繪圖工具：使用的UML：具，如RoseJude、Visio2 .設(shè)計概述2.1 任務(wù)和目標2.1.1 需求概述2.1.2 運行環(huán)境概述2.1.3 條件與限制2.1.4 詳細設(shè)計方法和工具3 .系統(tǒng)詳細需求分析主要對系統(tǒng)級的需求進

4、行分析。首先應(yīng)對需求分析提出的企業(yè)需求進一步確認，并對由于情況變化而帶來的需求變化進行較為詳細的分析。3.1 詳細需求分析3.1.1 詳細功能需求分析3.1.2 詳細性能需求分析3.1.3 詳細資源需求分析3.1.4 詳細接口需求分析3.1.5 詳細系統(tǒng)運行環(huán)境及限制條件分析4 .總體方案確認著重解決系統(tǒng)總體結(jié)構(gòu)確認及界面劃分問題。4.1 系統(tǒng)總體結(jié)構(gòu)確認對系統(tǒng)組成、邏輯結(jié)構(gòu)及層次進行確認，對應(yīng)用系統(tǒng)、支撐系統(tǒng)及各自實現(xiàn)的功能進行確認，細化集成設(shè)計及系統(tǒng)工作流程，特別要注意因軟件的引進造成的系統(tǒng)本身結(jié)構(gòu)和公司其他系統(tǒng)的結(jié)構(gòu)變化。包括：4.1.1 系統(tǒng)組成、邏輯結(jié)構(gòu)及層次確認4.1.2 應(yīng)用系統(tǒng)

5、結(jié)構(gòu)確認4.1.3 支撐系統(tǒng)結(jié)構(gòu)確認4.1.4 系統(tǒng)集成確認4.1.5 系統(tǒng)工作流程確認4.2 系統(tǒng)詳細界面劃分4.2.1 應(yīng)用系統(tǒng)與支撐系統(tǒng)的詳細界面劃分應(yīng)用系統(tǒng)與支撐系統(tǒng)之間的界面包括系統(tǒng)主服務(wù)器與其他服務(wù)器的服務(wù)范圍及訪問方式，網(wǎng)絡(luò)及數(shù)據(jù)庫對應(yīng)用系統(tǒng)的支撐方式，全局數(shù)據(jù)的管理與存取方式等。4.2.2 系統(tǒng)內(nèi)部詳細界面劃分系統(tǒng)各功能之間的界面包括覆蓋范圍，模塊間功能調(diào)用涉及到的系統(tǒng)模塊及方法，全局數(shù)據(jù)格式，系統(tǒng)性能要求等。5 .全局數(shù)據(jù)結(jié)構(gòu)說明本章說明本程序系統(tǒng)中使用的全局數(shù)據(jù)常量、變量和數(shù)據(jù)結(jié)構(gòu)。5.1 常量包括數(shù)據(jù)文件名稱及其所在目錄，功能說明，具體常量說明等。5.2 變量本章說明本程

6、序系統(tǒng)中使用的全局數(shù)據(jù)常量、變量和數(shù)據(jù)結(jié)構(gòu)。5.3 數(shù)據(jù)結(jié)構(gòu)包括數(shù)據(jù)結(jié)構(gòu)名稱，功能說明，具體數(shù)據(jù)結(jié)構(gòu)說明（定義、注釋、取值）等。6 .系統(tǒng)詳細設(shè)計6.1 功能結(jié)構(gòu)圖6.2 系統(tǒng)結(jié)構(gòu)設(shè)計及子系統(tǒng)劃分對系統(tǒng)的組成及邏輯結(jié)構(gòu)進行設(shè)計前確認。劃分系統(tǒng)功能模塊或子系統(tǒng)（如果有或者有必要，特別是大型的軟件系統(tǒng)）。6.3 系統(tǒng)功能模塊詳細設(shè)計按結(jié)構(gòu)化設(shè)計方法，在系統(tǒng)功能逐層分解的基礎(chǔ)上，對系統(tǒng)各功能模塊或子系統(tǒng)進行設(shè)計。此為詳細設(shè)計的主要部分之一。用層次圖描述系統(tǒng)的總體結(jié)構(gòu)、功能分解及各個模塊之間的相互調(diào)用關(guān)系和信息交互，用IPO圖或其他方法描述各模塊完成的功能。以上建議采用HIPO圖進行功能分解與模塊描述

7、，更高的要求建議采用IDEF0方法進行功能模型設(shè)計。詳細設(shè)計應(yīng)用系統(tǒng)的各個構(gòu)成模塊完成的功能及其相互之間的關(guān)系，用IPO或結(jié)構(gòu)圖描述各模塊的組成結(jié)構(gòu)、算法、模塊間的接口關(guān)系，以及需求、功能和模塊三者之間的交叉參照關(guān)系。每個模塊的描述說明可參照以下格式：模塊編號：模塊名稱：輸入：處理：算法描述：輸出：其中處理和算法描述部分主要采用偽碼或具體的程序語言完成。對詳細設(shè)計更高的要求建議用IDEF0圖進行各功能模塊的設(shè)計。如果對軟件需進行二次開發(fā)（包括功能擴展、功能改造、用戶界面改造等），則相應(yīng)的設(shè)計工作應(yīng)該設(shè)立子課題完成。6.4 系統(tǒng)界面詳細設(shè)計系統(tǒng)界面說明應(yīng)用系統(tǒng)軟件的各種接口。整個系統(tǒng)的其他接口（

8、如系統(tǒng)硬件接口、通訊接口等）在相應(yīng)的部分說明。6.4.1 外部界面設(shè)計根據(jù)系統(tǒng)界面劃分進行系統(tǒng)外部界面設(shè)計，對系統(tǒng)的所有外部接口（包括功能和數(shù)據(jù)接口）進行設(shè)計。6.4.2 內(nèi)部界面設(shè)計設(shè)計系統(tǒng)內(nèi)部各功能模塊間的調(diào)用關(guān)系和數(shù)據(jù)接口。6.4.3 用戶界面設(shè)計規(guī)定人機界面的內(nèi)容、界面風(fēng)格、調(diào)用方式等，包括所謂的表單設(shè)計、報表設(shè)計和用戶需要的打印輸出等設(shè)計。此部分內(nèi)容可能比較多。7 .開發(fā)和測試生產(chǎn)環(huán)境說明7.1 開發(fā)環(huán)境7.2 測試及產(chǎn)品環(huán)境-Developmentevnironment:programminglanuague,databaseVs2010-svn-iss6.1+-mysql/sql

9、server2005/2008-.netframwork4.0-Testing&productionenvironment:OS,framwork4.0Windwos2003,iis6.0,MySQL,8 .模塊設(shè)計8.1 用例圖8.2 功能設(shè)計說明8.2.1 模塊1模塊1主要分為以下幾個子模塊：子模塊1、子模塊2和子模塊M 子模塊.1 設(shè)計圖.2 功能描述簡要描述子模塊1的業(yè)務(wù)功能。.3 輸入數(shù)據(jù)詳細描述用戶輸入的數(shù)據(jù)（包括任何軍入設(shè)備）以及這些數(shù)據(jù)的有效性檢驗規(guī)則。詳細描述從物理模型中的哪些表獲取數(shù)

10、據(jù)以及獲取這些數(shù)據(jù)的條件。.4 輸出數(shù)據(jù)詳細描述子功能1所產(chǎn)生的數(shù)據(jù)以及這些數(shù)據(jù)的表現(xiàn)形式。.5 業(yè)務(wù)算法和流程從業(yè)務(wù)角度詳細描述根據(jù)輸入數(shù)據(jù)產(chǎn)生輸出數(shù)據(jù)的業(yè)務(wù)算法和流程。.6 數(shù)據(jù)設(shè)計給出本程序中的局部數(shù)據(jù)結(jié)構(gòu)說明，包括數(shù)據(jù)結(jié)構(gòu)名稱，功能說明，具體數(shù)據(jù)結(jié)構(gòu)說明（定義、注釋設(shè)計、取值）等。相關(guān)數(shù)據(jù)庫表，數(shù)據(jù)存儲設(shè)計（具體說明需要以文件方式保存的數(shù)據(jù)文件名、數(shù)據(jù)存儲格式、數(shù)據(jù)項及屬性等。）.7 源程序文件說明給出本程序的各源程序文件的說明，包括源程序文件名稱及其所在目錄，功能說明，包含的前導(dǎo)文件及函數(shù)名稱等。.8 函數(shù)說明具體

11、說明本程序中的各個函數(shù)，包括函數(shù)名稱及其所在文件，功能，格式，參數(shù)，全局變量，局部變量，返回值，算法說明，使用約束等。.9 限制條件.10 其他說明8.2.2 模塊2模塊1主要分為以下幾個子模塊：子模塊1、子模塊2和子模塊M 子模塊.1 設(shè)計圖.2 功能描述簡要描述子模塊1的業(yè)務(wù)功能。.3 輸入數(shù)據(jù)詳細描述用戶輸入的數(shù)據(jù)（包括任何軍入設(shè)備）以及這些數(shù)據(jù)的有效性檢驗規(guī)則。詳細描述從物理模型中的哪些表獲取數(shù)據(jù)以及獲取這些數(shù)據(jù)的條件。.4 輸出數(shù)據(jù)詳細描述子功能1所產(chǎn)生的數(shù)據(jù)以及這些數(shù)據(jù)的表現(xiàn)形式。8

12、. 業(yè)務(wù)算法和流程從業(yè)務(wù)角度詳細描述根據(jù)輸入數(shù)據(jù)產(chǎn)生輸出數(shù)據(jù)的業(yè)務(wù)算法和流程。.6 數(shù)據(jù)設(shè)計給出本程序中的局部數(shù)據(jù)結(jié)構(gòu)說明，包括數(shù)據(jù)結(jié)構(gòu)名稱，功能說明，具體數(shù)據(jù)結(jié)構(gòu)說明（定義、注釋設(shè)計、取值）等。相關(guān)數(shù)據(jù)庫表，數(shù)據(jù)存儲設(shè)計（具體說明需要以文件方式保存的數(shù)據(jù)文件名、數(shù)據(jù)存儲格式、數(shù)據(jù)項及屬性等。）.7 源程序文件說明給出本程序的各源程序文件的說明，包括源程序文件名稱及其所在目錄，功能說明，包含的前導(dǎo)文件及函數(shù)名稱等。.8 函數(shù)說明具體說明本程序中的各個函數(shù)，包括函數(shù)名稱及其所在文件，功能，格式，參數(shù)，全局變量，局部變量，返回值，算法說明，使

13、用約束等。.9 限制條件.10 其他說明9 .接口設(shè)計9.1 內(nèi)部接口9.2 外部接口9.2.1 接口說明例如：xx子系統(tǒng)通過xx從xx子系統(tǒng)取得xx等，相關(guān)標準，調(diào)用示例，可根據(jù)需要增加章節(jié)描述接口。9.2.2 調(diào)用方式例如：內(nèi)部接口調(diào)用：例：/*通過用戶服務(wù)號碼取得該客戶認證密碼等信息，如果該客戶存在返回為0,其他情況參考錯誤編碼*/publicRUserInfogetUserInfo(StringuserNo);10 .數(shù)據(jù)庫設(shè)計詳見xxx數(shù)據(jù)庫設(shè)tf說明書如果數(shù)據(jù)庫設(shè)計內(nèi)容比較少，則直接在此處描述。11 .系統(tǒng)安全保密設(shè)計11.1 說明例如：由于存在與外部系

14、統(tǒng)的接口，所以需要考慮訪問安全的問題.11.2 設(shè)計例如：分為數(shù)據(jù)傳輸部分，ip過濾部分，身份驗證部分,章節(jié)可補充11.2.1 數(shù)據(jù)傳輸部分例如：在部分數(shù)據(jù)傳遞的時候，考慮以https協(xié)議，需要在部署的時候作相關(guān)處理11.2.2 IP過濾分部例如：可在系統(tǒng)前端通過Filter實現(xiàn)，該Filter實現(xiàn)對該地址訪問的IP過濾作用.可信任IP地址通過xml文件進行配置.11.2.3 身份驗證部分例如：對信任的用戶，頒發(fā)身份驗證碼，通過該標識進行身份識別.12 .系統(tǒng)性能設(shè)計13 .系統(tǒng)出錯處理例如：為了在系統(tǒng)出現(xiàn)異常情況下給用戶以明確的提示，可采用兩種方式予以提示：1 .使用Javascript的a

15、lert()函數(shù)直接提示，這主要在輸入或修改的情況下使用；2 .使用統(tǒng)一的錯誤界面提示，該界面對應(yīng)于errorpage.jsp頁面。錯誤界面樣式如下圖所示：錯誤提示：“錯誤提示內(nèi)容”返回錯誤提示界面14 .設(shè)計和開發(fā)規(guī)范【可以列表方式列出設(shè)計開發(fā)的參考文檔的索引，內(nèi)容較少/關(guān)鍵內(nèi)容可以章節(jié)方式填寫】1 4.1數(shù)據(jù)庫設(shè)計規(guī)范【參見XXXX&據(jù)庫設(shè)計規(guī)范】2 4.2.NET編碼規(guī)范特別強調(diào)：詳細請參見ASP.Net文檔規(guī)范這里只做簡單闡述，如有變動，會及時同事整個項目組相關(guān)人員。(1)不要給類名加前綴。使用PascalCasing風(fēng)格，不使用匈牙利命名法。(2)要用名詞詞組來給類型命名。使

16、用PascalCasing風(fēng)格。(3)類名少用縮寫，不要使用下劃線字符(_)。4 4)基類CBase的文件名為：FileBase.cs;5 5)泛型類命名：考慮用T來命名參數(shù)類型，類如：publicclassList<T>。(6)接口(Inteface)命名規(guī)范和類命名規(guī)范相同，唯一區(qū)別是接口在名字前加上“I”前綴。(7)枚舉命名：以復(fù)數(shù)結(jié)尾，表明這是一個枚舉，例如：EnumColorButtons(8)結(jié)構(gòu)命名：表明這是一個結(jié)構(gòu)體，例如：StructureCustomerInfoRecord'以Record結(jié)尾除使用工具直接生成的類外，其它所有類的功能要有注釋，即使只是一

17、個數(shù)據(jù)對象；非常見功能的API必須要有功能描述的注釋。獨立的要被應(yīng)用其他功能所調(diào)用的模塊的接口和公共API的注釋要完備，即包括功能說明、參數(shù)和返回值說明。其它情況的API的注釋盡量完備，但不強制要求。一次性的流打開后必須關(guān)閉和釋放。一般地，在流打開后，都有一個trycatch語句，務(wù)必加上finally塊釋放流資源。即使IF,While是單語句，也要使用“”來劃分程序塊。不要有完全為調(diào)試使用的日志信息，如("1")；如要使用，在調(diào)試完成后請及時刪除。一些常識性代碼，不需要寫沒必要的注釋。不要用工具生成沒用的注釋。14.3代碼目錄結(jié)構(gòu)系統(tǒng)架構(gòu)目錄結(jié)構(gòu)設(shè)計圖，

18、如下:力解決方案'Authority'個項目)義腳本文檔-Authority+Frop«rties1+0引用一AppJJata自.Content1+口Images-Scripts-_/jqMryeasjnii-1.2.6+)_jlocale+二plugins+)一jthemes_Sjeasyloader.je2jjqyerl7.2.min.js._jquery.m&Myui.min.js+_Jjqu#ryuil.6.20+i,_Jjthok-ui+_jthemes+i_JControllers耳一jData1+一jModels1+,JScripts+-Views1+#jGlobal.&sax+今WwbEitfig結(jié)構(gòu)說明：作用范圍包名描述整個程序ContentImages存放圖片ScriptsJquery以及樣式表等Scripts/jquery-easyui-1.2.6jquery-easyui包數(shù)字