軟件詳細設計文檔模板最全面資料

1、-. z.研發(fā)生產(chǎn)中心文檔編號版本A1商密A項目名稱*系統(tǒng)項目來源*系統(tǒng)詳細設計說明書(部資料 請勿外傳)編寫：日期：檢查：日期：審核：日期：批準：日期：*公司所有不得復制文檔變更記錄序號變更（+/-）說明作者版本號日期批準12目錄 TOC o 2-3 f h z t 標題 1,1 HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115737#_Toc2661157371. 引言 PAGEREF _Toc266115737 h 4HYPERLINK file:/C:Documents%20

2、and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115738#_Toc2661157381.1 編寫目的和圍 PAGEREF _Toc266115738 h 4HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115739#_Toc2661157391.2 術語表 PAGEREF _Toc266115739 h 4HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc

3、 l _Toc266115740#_Toc2661157401.3 參考資料 PAGEREF _Toc266115740 h 4HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115741#_Toc2661157411.4 使用的文字處理和繪圖工具 PAGEREF _Toc266115741 h 4HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115742#_Toc266115742

4、2. 全局數(shù)據(jù)結(jié)構(gòu)說明 PAGEREF _Toc266115742 h 5HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115743#_Toc2661157432.1 常量 PAGEREF _Toc266115743 h 5HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115744#_Toc2661157442.2 變量 PAGEREF _Toc266115744 h 5HYPER

5、LINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115745#_Toc2661157452.3 數(shù)據(jù)結(jié)構(gòu) PAGEREF _Toc266115745 h 5HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115746#_Toc2661157463. 模塊設計 PAGEREF _Toc266115746 h 5HYPERLINK file:/C:Documents%20and%20Settings

6、Administrator桌面詳細設計.doc l _Toc266115747#_Toc2661157473.1 用例圖 PAGEREF _Toc266115747 h 5HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115748#_Toc2661157483.2 功能設計說明 PAGEREF _Toc266115748 h 5HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc2661157

7、49#_Toc2661157493.2.1 模塊1 PAGEREF _Toc266115749 h 5HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115750#_Toc2661157503.2.2 模塊2 PAGEREF _Toc266115750 h 6HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115751#_Toc2661157514. 接口設計 PAGEREF _Toc

8、266115751 h 7HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115752#_Toc2661157524.1 部接口 PAGEREF _Toc266115752 h 7HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115753#_Toc2661157534.2 外部接口 PAGEREF _Toc266115753 h 7HYPERLINK file:/C:Document

9、s%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115754#_Toc2661157544.2.1 接口說明 PAGEREF _Toc266115754 h 7HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115755#_Toc2661157554.2.2 調(diào)用方式 PAGEREF _Toc266115755 h 8HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳

10、細設計.doc l _Toc266115756#_Toc2661157565. 數(shù)據(jù)庫設計 PAGEREF _Toc266115756 h 8HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115757#_Toc2661157576. 系統(tǒng)安全設計 PAGEREF _Toc266115757 h 8HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115758#_Toc266115758

11、6.1 說明 PAGEREF _Toc266115758 h 8HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115759#_Toc2661157596.2 設計 PAGEREF _Toc266115759 h 8HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115760#_Toc2661157606.2.1 數(shù)據(jù)傳輸部分 PAGEREF _Toc266115760 h 8HYPE

12、RLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115761#_Toc2661157616.2.2 IP過濾分部 PAGEREF _Toc266115761 h 8HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115762#_Toc2661157626.2.3 身份驗證部分 PAGEREF _Toc266115762 h 8HYPERLINK file:/C:Documents%20and%

13、20SettingsAdministrator桌面詳細設計.doc l _Toc266115763#_Toc2661157637. 系統(tǒng)性能設計 PAGEREF _Toc266115763 h 9HYPERLINK file:/C:Documents%20and%20SettingsAdministrator桌面詳細設計.doc l _Toc266115764#_Toc2661157648. 系統(tǒng)出錯處理 PAGEREF _Toc266115764 h 9引言背景此文檔的背景編寫目的和圍說明寫這份詳細設計說明書的目的。本詳細設計說明書編寫的目的是說明程序模塊的設計考慮，包括程序描述、輸入/輸出

14、、算法和流程邏輯等，為軟件編程和系統(tǒng)維護提供基礎。本說明書的預期讀者為系統(tǒng)設計人員、軟件開發(fā)人員、軟件測試人員和項目評審人員。術語表定義系統(tǒng)或產(chǎn)品中涉及的重要術語，為讀者在閱讀文檔時提供必要的參考信息。序號術語或縮略語說明性定義1PMProject Manager,項目經(jīng)理2參考資料列出有關資料的名稱、作者、文件編號或版本等。參考資料包括：a需求說明書、架構(gòu)設計說明書等；b本項目的其他已發(fā)表的文件；c引用文件、資料、軟件開發(fā)標準等。資料名稱作者文件編號、版本資料存放地點使用的文字處理和繪圖工具文字處理軟件：編寫設計文檔使用的文字處理軟件，如RedOffice 繪圖工具：使用的UML工具，如Ro

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

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

17、說明，具體數(shù)據(jù)結(jié)構(gòu)說明（定義、注釋、取值）等。系統(tǒng)詳細設計功能結(jié)構(gòu)圖系統(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)各功能模塊或子系統(tǒng)進行設計。此為詳細設計的主要部分之一。用層次圖描述系統(tǒng)的總體結(jié)構(gòu)、功能分解及各個模塊之間的相互調(diào)用關系和信息交互，用IPO圖或其他方法描述各模塊完成的功能。以上建議采用HIPO圖進行功能分解與模塊描述，更高的要求建議采用IDEF0方法進行功能模型設計。詳細設計應用系統(tǒng)的各個構(gòu)成模塊完成的功能及其相互之間的關系，

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

19、括功能和數(shù)據(jù)接口）進行設計。部界面設計設計系統(tǒng)部各功能模塊間的調(diào)用關系和數(shù)據(jù)接口。用戶界面設計規(guī)定人機界面的容、界面風格、調(diào)用方式等，包括所謂的表單設計、報表設計和用戶需要的打印輸出等設計。此部分容可能比較多。開發(fā)和測試生產(chǎn)環(huán)境說明開發(fā)環(huán)境測試及產(chǎn)品環(huán)境- Development evnironment: programming lanuague, databaseVs 2010 - svn - iss 6.1 + - mysql/sql server 2005/2008 - .net framwork 4.0- Testing & production environment: OS, da

20、tabase - .net framwork 4.0Windwos 2003, iis 6.0, MySQL, 模塊設計用例圖功能設計說明模塊1模塊1主要分為以下幾個子模塊：子模塊1、子模塊2和子模塊N。子模塊1設計圖功能描述簡要描述子模塊1的業(yè)務功能。輸入數(shù)據(jù)詳細描述用戶輸入的數(shù)據(jù)(包括任何輸入設備)以及這些數(shù)據(jù)的有效性檢驗規(guī)則。詳細描述從物理模型中的哪些表獲取數(shù)據(jù)以及獲取這些數(shù)據(jù)的條件。輸出數(shù)據(jù)詳細描述子功能1所產(chǎn)生的數(shù)據(jù)以及這些數(shù)據(jù)的表現(xiàn)形式。業(yè)務算法和流程從業(yè)務角度詳細描述根據(jù)輸入數(shù)據(jù)產(chǎn)生輸出數(shù)據(jù)的業(yè)務算法和流程。數(shù)據(jù)設計給出本程序中的局部數(shù)據(jù)結(jié)構(gòu)說明，包括數(shù)據(jù)結(jié)構(gòu)名稱，功能說明，具體

21、數(shù)據(jù)結(jié)構(gòu)說明（定義、注釋設計、取值）等。相關數(shù)據(jù)庫表，數(shù)據(jù)存儲設計（具體說明需要以文件方式保存的數(shù)據(jù)文件名、數(shù)據(jù)存儲格式、數(shù)據(jù)項及屬性等。）源程序文件說明給出本程序的各源程序文件的說明，包括源程序文件名稱及其所在目錄，功能說明，包含的前導文件及函數(shù)名稱等。函數(shù)說明具體說明本程序中的各個函數(shù)，包括函數(shù)名稱及其所在文件，功能，格式，參數(shù)，全局變量，局部變量，返回值，算法說明，使用約束等。限制條件其他說明模塊2模塊1主要分為以下幾個子模塊：子模塊1、子模塊2和子模塊N。子模塊1設計圖功能描述簡要描述子模塊1的業(yè)務功能。輸入數(shù)據(jù)詳細描述用戶輸入的數(shù)據(jù)(包括任何輸入設備)以及這些數(shù)據(jù)的有效性檢驗規(guī)則。詳

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

23、全局變量，局部變量，返回值，算法說明，使用約束等。限制條件其他說明接口設計部接口外部接口接口說明例如：*子系統(tǒng)通過*從*子系統(tǒng)取得*等，相關標準，調(diào)用示例，可根據(jù)需要增加章節(jié)描述接口。調(diào)用方式例如：部接口調(diào)用：例: /*通過用戶服務取得該客戶認證密碼等信息，如果該客戶存在返回為0，其他情況參考錯誤編碼*/public RUserInfo getUserInfo (String userNo);數(shù)據(jù)庫設計詳見*數(shù)據(jù)庫設計說明書如果數(shù)據(jù)庫設計容比較少，則直接在此處描述。系統(tǒng)安全設計說明例如：由于存在與外部系統(tǒng)的接口,所以需要考慮訪問安全的問題.設計例如：分為數(shù)據(jù)傳輸部分,IP過濾部分,身份驗證部分

24、.章節(jié)可補充數(shù)據(jù)傳輸部分例如：在部分數(shù)據(jù)傳遞的時候,考慮以https協(xié)議,需要在部署的時候作相關處理.IP過濾分部例如：可在系統(tǒng)前端通過Filter實現(xiàn),該Filter實現(xiàn)對該地址訪問的IP過濾作用.可信任IP地址通過*ml文件進行配置.身份驗證部分例如：對信任的用戶,頒發(fā)身份驗證碼,通過該標識進行身份識別.系統(tǒng)性能設計系統(tǒng)出錯處理例如：為了在系統(tǒng)出現(xiàn)異常情況下給用戶以明確的提示，可采用兩種方式予以提示：1使用Javascript的alert()函數(shù)直接提示，這主要在輸入或修改的情況下使用；2使用統(tǒng)一的錯誤界面提示，該界面對應于errorpage.jsp頁面。錯誤界面樣式如下圖所示：錯誤提示界面設計和開發(fā)規(guī)【可以列表方式列出設計開發(fā)的參考文檔的索引，容較少/關鍵容可以章節(jié)方式填寫】數(shù)據(jù)庫設計規(guī)【參見*數(shù)據(jù)庫設計規(guī)】.NET編碼規(guī)特別強調(diào)：詳細請參見ASP.Net文檔規(guī)這里只做簡單闡述，如有變動，會及時同事整個項目組相關人員。(1)不要給類名加前綴。使用PascalCasing風格，不使用匈牙利命名法 。 (2)要用名詞詞組來給類型命名。使用PascalCasing風格 。 (3)類名少用縮寫,不要使用下劃線字符 (_)。 (4)基類CBase的文件名為：FileBase.cs;(5) 泛型類命名：考慮用T來命名參數(shù)類型 ，類如：public class List。(6)接口（