軟件系統(tǒng)詳細(xì)設(shè)計說明書模板

1、XXXXX 系統(tǒng)詳細(xì)設(shè)計說明書文件狀態(tài)：文件標(biāo)識：V 草稿當(dāng)前版本：1.0 正式發(fā)布作者：正在修改完成日期：版本歷史版本/狀態(tài)者參與者起止日期備注1.0開始編寫修改記錄日期修訂版本修改章節(jié)修改描述者目錄1 引言 51.1 編寫目的 51.2 背景 51.3 參考資料 51.4 術(shù)語定義及說明 52 設(shè)計概述 52.1 任務(wù)和目標(biāo) 52.1.1 需求概述 52.1.2 運行環(huán)境概述 52.1.3 條件與限制 62.1.4 詳細(xì)設(shè)計方法和工具 63 系統(tǒng)詳細(xì)需求分析 63.1 詳細(xì)需求分析 63.2 詳細(xì)系統(tǒng)運行環(huán)境及限制條件分析接口需求分析 64 總體方案確認(rèn) 64.1 系統(tǒng)總體結(jié)構(gòu)確認(rèn) 64.

2、2 系統(tǒng)詳細(xì)界面劃分 74.2.1 應(yīng)用系統(tǒng)與支撐系統(tǒng)的詳細(xì)界面劃分 74.2.2 系統(tǒng)內(nèi)部詳細(xì)界面劃分 75 系統(tǒng)詳細(xì)設(shè)計 75.1 系統(tǒng)程序代碼架構(gòu)設(shè)計 75.1.1 UI(User Interface) 用戶界面表示層 75.1.2 BLL(Business Logic Layer)業(yè)務(wù)邏輯層 85.1.3 DAL(Data Access Layer) 數(shù)據(jù)訪問層 85.1.4 Commo類庫85.1.5 Entity Class 實體類 85.2 系統(tǒng)結(jié)構(gòu)設(shè)計及子系統(tǒng)劃分 85.3 系統(tǒng)功能模塊詳細(xì)設(shè)計 95.3.1 XX子系統(tǒng)9.1 XX模塊9列表和分頁 9創(chuàng)建 XX9.2XX模塊9

3、XX列表9XX修改95.3.2 XX子系統(tǒng)95.3.6.1 用戶管理模塊 95.3.6.2 角色管理模塊 145.3.6.3 系統(tǒng)設(shè)置模塊 145.3.6.4 系統(tǒng)登錄注銷模塊 145.4 系統(tǒng)界面詳細(xì)設(shè)計 145.4.1 外部界面設(shè)計 145.4.2 內(nèi)部界面設(shè)計 145.4.3 用戶界面設(shè)計 146 數(shù)據(jù)庫系統(tǒng)設(shè)計 146.1 設(shè)計要求 146.2 信息模型設(shè)計 146.3 數(shù)據(jù)庫設(shè)計 146.3.1 設(shè)計依據(jù) 146.3.2 數(shù)據(jù)庫種類及特點 156.3.3 數(shù)據(jù)庫邏輯結(jié)構(gòu) 156.3.4 物理結(jié)構(gòu)設(shè)計 156.3.5 數(shù)據(jù)庫安全 156.3.6 數(shù)據(jù)字典 157 信息編碼設(shè)計 157.

4、1 代碼結(jié)構(gòu)設(shè)計 157.2 代碼編制 151 引言1.1 編寫目的 說明編寫詳細(xì)設(shè)計方案的主要目的。 說明書編制的目的是說明一個軟件系統(tǒng)各個層次中的每個程序（每個模塊或子程序）和數(shù)據(jù)庫 系統(tǒng)的設(shè)計考慮，為程序員編碼提供依據(jù)。如果一個軟件系統(tǒng)比較簡單，層次很少，本文件可以不單獨編寫，和概要設(shè)計說明書中不重復(fù) 部分合并編寫。方案重點是模塊的執(zhí)行流程和數(shù)據(jù)庫系統(tǒng)詳細(xì)設(shè)計的描述。1.2 背景應(yīng)包含以下幾個方面的內(nèi)容：A. 待開發(fā)軟件系統(tǒng)名稱；B. 該系統(tǒng)基本概念， 如該系統(tǒng)的類型、從屬地位等；C. 開發(fā)項目組名稱。1.3 參考資料 列出詳細(xì)設(shè)計報告引用的文獻(xiàn)或資料，資料的作者、標(biāo)題、出版單位和出版日

5、期等信息，必 要時說明如何得到這些資料。1.4 術(shù)語定義及說明列出本文檔中用到的可能會引起混淆的專門術(shù)語、定義和縮寫詞的原文。2 設(shè)計概述2.1 任務(wù)和目標(biāo)說明詳細(xì)設(shè)計的任務(wù)及詳細(xì)設(shè)計所要達(dá)到的目標(biāo) 。2.1.1 需求概述對所開發(fā)軟件的概要描述 , 包括主要的業(yè)務(wù)需求、輸入、 輸出、主要功能、性能等，尤其 需要描述系統(tǒng)性能需求 。2.1.2 運行環(huán)境概述對本系統(tǒng)所依賴于運行的硬件，包括操作系統(tǒng)、數(shù)據(jù)庫系統(tǒng)、中間件、接口軟件、可能的性 能監(jiān)控與分析等軟件環(huán)境的描述，及配置要求。2.1.3 條件與限制詳細(xì)描述系統(tǒng)所受的內(nèi)部和外部條件的約束和限制說明。 包括業(yè)務(wù)和技術(shù)方面的條件與限制 以及進(jìn)度、管理

6、等方面的限制。2.1.4 詳細(xì)設(shè)計方法和工具簡要說明詳細(xì)設(shè)計所采用的方法和使用的工具。如 HIPO圖方法、IDEF(I2DEF)方法、E R 圖，數(shù)據(jù)流程圖、業(yè)務(wù)流程圖、選用的CAS工具等，盡量采用標(biāo)準(zhǔn)規(guī)范和輔助工具。3 系統(tǒng)詳細(xì)需求分析主要對系統(tǒng)級的需求進(jìn)行分析。首先應(yīng)對需求分析提出的企業(yè)需求進(jìn)一步確認(rèn)，并對由于情況變化而帶來的需求變化進(jìn)行較為詳細(xì)的分析。3.1 詳細(xì)需求分析包括：? 詳細(xì)功能需求分析? 詳細(xì)性能需求分析? 詳細(xì)資源需求分析? 詳細(xì)系統(tǒng)運行環(huán)境及限制條件分析3.2 詳細(xì)系統(tǒng)運行環(huán)境及限制條件分析接口需求分析包括：? 系統(tǒng)接口需求分析? 現(xiàn)有硬、軟件資源接口需求分析? 引進(jìn)硬、

7、軟件資源接口需求分析4 總體方案確認(rèn)著重解決系統(tǒng)總體結(jié)構(gòu)確認(rèn)及界面劃分問題。4.1 系統(tǒng)總體結(jié)構(gòu)確認(rèn)對系統(tǒng)組成、邏輯結(jié)構(gòu)及層次進(jìn)行確認(rèn)， 對應(yīng)用系統(tǒng)、支撐系統(tǒng)及各自實現(xiàn)的功能進(jìn)行確認(rèn)， 細(xì)化集成設(shè)計及系統(tǒng)工作流程，特別要注意因軟件的引進(jìn)造成的系統(tǒng)本身結(jié)構(gòu)和公司其他系統(tǒng)的結(jié) 構(gòu)變化。包括：系統(tǒng)組成、邏輯結(jié)構(gòu)及層次確認(rèn)應(yīng)用系統(tǒng)結(jié)構(gòu)確認(rèn)支撐系統(tǒng)結(jié)構(gòu)確認(rèn)系統(tǒng)集成確認(rèn)系統(tǒng)工作流程確認(rèn)4.2 系統(tǒng)詳細(xì)界面劃分應(yīng)用系統(tǒng)與支撐系統(tǒng)的詳細(xì)界面劃分應(yīng)用系統(tǒng)與支撐系統(tǒng)之間的界面包括系統(tǒng)主服務(wù)器與其他服務(wù)器的服務(wù)范圍及訪問方式，網(wǎng)絡(luò) 及數(shù)據(jù)庫對應(yīng)用系統(tǒng)的支撐方式，全局?jǐn)?shù)據(jù)的管理與存取方式等。系統(tǒng)內(nèi)部詳細(xì)界面劃分系統(tǒng)各

8、功能之間的界面包括覆蓋范圍，模塊間功能調(diào)用涉及到的系統(tǒng)模塊及方法，全局?jǐn)?shù)據(jù) 格式，系統(tǒng)性能要求等。5 系統(tǒng)詳細(xì)設(shè)計5.1系統(tǒng)程序代碼架構(gòu)設(shè)計系統(tǒng)采用三層架構(gòu)模型，將應(yīng)用系統(tǒng)劃分為用戶界面表示層、業(yè)務(wù)邏輯層、數(shù)據(jù)訪問層，以及En tity Class 實體類、Commo類庫組成，各層的關(guān)系如下圖所示：UTfUsr IntcrfacE1) 用戶界面表示層心1iIVI吧17 EtiLtK Clas 實體類*;DALfData AccessCwnmoti 類庫 *5.1.1 UI(User In terface)用戶界面表示層負(fù)責(zé)與用戶進(jìn)行交互，顯示、接受數(shù)據(jù)，與此同時，做一些簡單邏輯處理，如：輸入數(shù)

9、據(jù)有效性判斷、顯示各種異常、 處理 Dataset記錄集數(shù)據(jù)。它只與 BLL(Bus in ess Logic Layer) 業(yè)務(wù)邏輯層、En tity Class 實體類兩個項目發(fā)生關(guān)聯(lián)，可能與Commc類庫發(fā)生關(guān)聯(lián)。5.1.2 BLL(Business Logic Layer) 業(yè)務(wù)邏輯層是整個系統(tǒng)的核心，它承擔(dān)了所有的邏輯判斷，實現(xiàn)了程序的功能，它是靈活的。BLL層既是調(diào)用者，又是被調(diào)用者，因此，要適當(dāng)?shù)倪M(jìn)行設(shè)計達(dá)到解耦的效果。BLL層只關(guān)聯(lián)DAL層和實體類，可能關(guān)聯(lián)Commo類庫。雖然BLL層被U層調(diào)用，但是BLL層無需關(guān)心UI層的情況。數(shù)據(jù)庫中每個表都 對應(yīng)一個BLL類，為了達(dá)到解耦

10、效果，BLL類不能直接調(diào)用其他表的 DAL類，可以BLL類之間相互調(diào)用。5.1.3 DAL(Data Access Layer)數(shù)據(jù)訪問層提供數(shù)據(jù)訪問的接口，沒有任何邏輯。在接口中對數(shù)據(jù)庫操作語句進(jìn)行組合裝配。DAL層一般關(guān)聯(lián)Commo類庫中的最底層，最基礎(chǔ)的數(shù)據(jù)庫類(比如：鏈接數(shù)據(jù)庫)，必須關(guān)聯(lián)Entity Class 實體類項目。DAUB只是數(shù)據(jù)庫的管理者，但不是訪問者，不直接與數(shù)據(jù)庫發(fā)生關(guān)聯(lián)。數(shù)據(jù)庫中每個 表都對應(yīng)一個 DAL1的接口(訪問控制)類。5.1.4 Commc類庫用于存放公用的類。最常用的就是數(shù)據(jù)庫訪問類，比如：鏈接字符串，數(shù)據(jù)庫引擎類。它直接 與數(shù)據(jù)庫進(jìn)行機(jī)械式的交換，無任

11、何邏輯。5.1.5 Entity Class 實體類相當(dāng)于加強(qiáng)的數(shù)據(jù)結(jié)構(gòu)，實現(xiàn)了對數(shù)據(jù)的封裝。數(shù)據(jù)庫中每個表都對應(yīng)一個實體類，表的字段 就是實體類的屬性，類型一一對應(yīng)。UI、BLL、DAL這三層的交互主要就是通過實體類作為參數(shù)，并Return回信息。5.2系統(tǒng)結(jié)構(gòu)設(shè)計及子系統(tǒng)劃分根據(jù)業(yè)務(wù)和功能，將系統(tǒng)的邏輯結(jié)構(gòu)劃分為XX子系統(tǒng)、XX子系等6個子系統(tǒng)，如下圖所示：各個子系統(tǒng)按照功能角度分解，戈U分出若干不同的功能模塊，如下面各圖所示:5.3 系統(tǒng)功能模塊詳細(xì)設(shè)計按結(jié)構(gòu)化設(shè)計方法，在系統(tǒng)功能逐層分解的基礎(chǔ)上，對系統(tǒng)各功能模塊或子系統(tǒng)進(jìn)行設(shè)計。此 為詳細(xì)設(shè)計的主要部分之一。用層次圖描述系統(tǒng)的總體結(jié)構(gòu)

12、、功能分解及各個模塊之間的相互調(diào)用關(guān)系和信息交互，用IPO 圖或其他方法描述各模塊完成的功能。以上建議采用HIPC圖進(jìn)行功能分解與模塊描述，更高的要求建議采用IDEFC方法進(jìn)行功能模型設(shè)計。詳細(xì)設(shè)計應(yīng)用系統(tǒng)的各個構(gòu)成模塊完成的功能及其相互之間的關(guān)系，用IPC或結(jié)構(gòu)圖描述各模塊的組成結(jié)構(gòu)、算法、模塊間的接口關(guān)系，以及需求、功能和模塊三者之間的交叉參照關(guān)系。每個模塊的描述說明可參照以下格式：模塊編號：模塊名稱：輸入：處理：算法描述：輸出：其中處理和算法描述部分主要采用偽碼或具體的程序語言完成。對詳細(xì)設(shè)計更高的要求建議用IDEFO圖進(jìn)行各功能模塊的設(shè)計。如果對軟件需進(jìn)行二次開發(fā)（包括功能擴(kuò)展、功能改

13、造、用戶界面改造等），則相應(yīng)的設(shè)計工 作應(yīng)該設(shè)立子課題完成。注意：算法描述主要是說明BLL層的代碼邏輯，UI層只做簡單的輸入驗證和界面顯示功能。5.3.1 XX子系統(tǒng).1XX莫塊列表和分頁創(chuàng)建 XX.2XX莫塊X煩表XX修改5.3.2 XX子系統(tǒng)5.3.6.1 用戶管理模塊模塊描述： 管理系統(tǒng)用戶，包括添加用戶并賦予角色、修改用戶資料和角色、刪除用戶。 主要功能： 添加用戶、修改用戶、刪除用戶、列表和分頁。5.3.6.1.1 列表和分頁1、流程圖省略2、輸入項分頁索引 頁面?zhèn)鲄?shù) 頁面加載時為 13、輸出項1) 列表詳細(xì)記錄；2) 當(dāng)前頁碼；3) 分頁總數(shù)；4) 記錄總數(shù)。4、算法描述 系統(tǒng)管

14、理用戶數(shù)據(jù)量不大，而且該功能使用頻率不高，可以不用優(yōu)化分頁，直接獲取用戶表全 部記錄，建議 UI 層使用 gridview 控件，調(diào)用 ExamSys.BLL. System_admin_info GetAllList() 綁定控件，利 用gridview自帶分頁功能，顯示分頁按鈕、當(dāng)前頁、分頁總數(shù)、記錄總數(shù)、5.3.6.1.2 添加用戶1、流程圖2、輸入項用戶IDstri ng必填姓名stri ng必填用戶密碼stri ng必填確認(rèn)密碼stri ng必填聯(lián)系電話stri ngE-mailstri ng狀態(tài)char用戶角色I(xiàn)Dstri ng3、輸出項1）成功，UI提示添加用戶完成；2）失敗,U

15、I提示具體信息。4、算法描述1）前端js判斷必填項的輸入和二次密碼是否相同，角色可以不選;2) BLL須驗證必填項，用戶名是唯一的不能重復(fù)；3) 加密密碼使用 MD.Encrypt( string String, string Key)，Key = "XXXXXXXX"4) 用戶信息保存至表 System_admin_i nfo ， Add(ExamSys.Model. System_admin_info model)；5) 分拆角色I(xiàn)D字符串并循環(huán)字符串?dāng)?shù)組，信息保存至表Dict_admin_vs_roles ，ExamSys.BLL. Dict_admin_vs_rol

16、es Add(ExamSys.Model. Dict_admin_vs_roles model)。5.361.3 修改用戶1、流程圖2、輸入項用戶IDstri ng頁面?zhèn)鲄?shù)姓名stri ng必填用戶密碼stri ng必填確認(rèn)密碼stri ng必填聯(lián)系電話stri ngE-mailstri ng狀態(tài)char用戶角色I(xiàn)Dstri ng3、輸出項1) 成功，UI提示修改用戶完成；2) 失敗，UI提示具體信息。4、算法描述1) 前端js判斷必填項的輸入和二次密碼是否相同，角色可以不選；2) 加密密碼使用 Chukeh.Security. MD5Encrypt( string String, stri

17、ng Key) ， Key = "LinLiYan"；3) 根 據(jù)用戶 ID 刪除表 Dict_admin_vs_roles 的 記 錄 ExamSys.BLL. Dict_admin_vs_rolesDeleteByAdminlD( string admind)；4) 分拆角色I(xiàn)D字符串并循環(huán)字符串?dāng)?shù)組，信息保存至該表Add(ExamSys.Model. Dict_admin_vs_roles model)。5.3.6.1.4 刪除用戶1、流程圖2、輸入項用戶IDstring頁面?zhèn)鲄?shù)3、輸出項1、成功，UI提示刪除用戶完成，刷新列表；2、失敗， UI 提示具體信息。3、

18、算法描述1) 根據(jù)用戶 ID 刪除表 System_admin_info 的記錄 ExamSys.DAL.System_admin_info Delete( string admin_id) ；2) 根 據(jù) 用 戶 ID 刪 除 表 Dict_admin_vs_roles 的 記 錄 ExamSys.BLL. Dict_admin_vs_roles DeleteByAdminID( string admin_id) 。角色管理模塊系統(tǒng)設(shè)置模塊系統(tǒng)登錄注銷模塊5.4 系統(tǒng)界面詳細(xì)設(shè)計系統(tǒng)界面說明應(yīng)用系統(tǒng)軟件的各種接口。 整個系統(tǒng)的其他接口 （如系統(tǒng)硬件接口、 通訊接口等） 在相應(yīng)的部分說明。5.4.1 外部界面設(shè)計 根據(jù)系統(tǒng)界面劃分進(jìn)行系統(tǒng)外部界面設(shè)計，對系統(tǒng)的所有外部接口（包括功能和數(shù)據(jù)接口） 進(jìn)行設(shè)計。5.4.2 內(nèi)部界面設(shè)計設(shè)計系統(tǒng)內(nèi)部各功能模塊間的調(diào)用關(guān)系和數(shù)據(jù)接口。5.4.3 用戶界面設(shè)計 規(guī)定人機(jī)界面的內(nèi)容、界面風(fēng)格、調(diào)用方式等，包括所謂的表單設(shè)計、報表設(shè)計和用戶需要 的打印輸出等設(shè)計。此部分內(nèi)容可能比較多。6 數(shù)據(jù)庫系統(tǒng)設(shè)計 此數(shù)據(jù)庫設(shè)計可單獨成冊，尤其對大型的數(shù)據(jù)庫應(yīng)用系統(tǒng)，即有一個單獨的數(shù)據(jù)庫設(shè)計說明 書。6.1 設(shè)計要求6.2 信息模型設(shè)計 確定系統(tǒng)信息的