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

1、XXXXX 系統(tǒng)詳細(xì)設(shè)計(jì)說(shuō)明書(shū)文件狀態(tài)：文件標(biāo)識(shí)：V 草稿當(dāng)前版本：1.0 正式發(fā)布作者：正在修改完成日期：版本歷史版本/狀態(tài)者參與者起止日期備注1.0開(kāi)始編寫(xiě)修改記錄日期修訂版本修改章節(jié)修改描述者目錄1 引言 51.1 編寫(xiě)目的 51.2 背景 51.3 參考資料 51.4 術(shù)語(yǔ)定義及說(shuō)明 52 設(shè)計(jì)概述 52.1 任務(wù)和目標(biāo) 52.1.1 需求概述 52.1.2 運(yùn)行環(huán)境概述 52.1.3 條件與限制 62.1.4 詳細(xì)設(shè)計(jì)方法和工具 63 系統(tǒng)詳細(xì)需求分析 63.1 詳細(xì)需求分析 63.2 詳細(xì)系統(tǒng)運(yùn)行環(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è)計(jì) 75.1 系統(tǒng)程序代碼架構(gòu)設(shè)計(jì) 75.1.1 UI(User Interface) 用戶(hù)界面表示層 75.1.2 BLL(Business Logic Layer)業(yè)務(wù)邏輯層 85.1.3 DAL(Data Access Layer) 數(shù)據(jù)訪(fǎng)問(wèn)層 85.1.4 Commo類(lèi)庫(kù)85.1.5 Entity Class 實(shí)體類(lèi) 85.2 系統(tǒng)結(jié)構(gòu)設(shè)計(jì)及子系統(tǒng)劃分 85.3 系統(tǒng)功能模塊詳細(xì)設(shè)計(jì) 95.3.1 XX子系統(tǒng)9.1 XX模塊9列表和分頁(yè) 9創(chuàng)建 XX9.2XX模塊9

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

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

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

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

7、軟件資源接口需求分析4 總體方案確認(rèn)著重解決系統(tǒng)總體結(jié)構(gòu)確認(rèn)及界面劃分問(wèn)題。4.1 系統(tǒng)總體結(jié)構(gòu)確認(rèn)對(duì)系統(tǒng)組成、邏輯結(jié)構(gòu)及層次進(jìn)行確認(rèn)， 對(duì)應(yīng)用系統(tǒng)、支撐系統(tǒng)及各自實(shí)現(xiàn)的功能進(jìn)行確認(rèn)， 細(xì)化集成設(shè)計(jì)及系統(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ù)范圍及訪(fǎng)問(wèn)方式，網(wǎng)絡(luò) 及數(shù)據(jù)庫(kù)對(duì)應(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è)計(jì)5.1系統(tǒng)程序代碼架構(gòu)設(shè)計(jì)系統(tǒng)采用三層架構(gòu)模型，將應(yīng)用系統(tǒng)劃分為用戶(hù)界面表示層、業(yè)務(wù)邏輯層、數(shù)據(jù)訪(fǎng)問(wèn)層，以及En tity Class 實(shí)體類(lèi)、Commo類(lèi)庫(kù)組成，各層的關(guān)系如下圖所示：UTfUsr IntcrfacE1) 用戶(hù)界面表示層心1iIVI吧17 EtiLtK Clas 實(shí)體類(lèi)*;DALfData AccessCwnmoti 類(lèi)庫(kù) *5.1.1 UI(User In terface)用戶(hù)界面表示層負(fù)責(zé)與用戶(hù)進(jìn)行交互，顯示、接受數(shù)據(jù)，與此同時(shí)，做一些簡(jiǎn)單邏輯處理，如：輸入數(shù)

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

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

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

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

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

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

15、I提示具體信息。4、算法描述1）前端js判斷必填項(xiàng)的輸入和二次密碼是否相同，角色可以不選;2) BLL須驗(yàn)證必填項(xiàng)，用戶(hù)名是唯一的不能重復(fù)；3) 加密密碼使用 MD.Encrypt( string String, string Key)，Key = "XXXXXXXX"4) 用戶(hù)信息保存至表 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 修改用戶(hù)1、流程圖2、輸入項(xiàng)用戶(hù)IDstri ng頁(yè)面?zhèn)鲄?shù)姓名stri ng必填用戶(hù)密碼stri ng必填確認(rèn)密碼stri ng必填聯(lián)系電話(huà)stri ngE-mailstri ng狀態(tài)char用戶(hù)角色I(xiàn)Dstri ng3、輸出項(xiàng)1) 成功，UI提示修改用戶(hù)完成；2) 失敗，UI提示具體信息。4、算法描述1) 前端js判斷必填項(xiàng)的輸入和二次密碼是否相同，角色可以不選；2) 加密密碼使用 Chukeh.Security. MD5Encrypt( string String, stri

17、ng Key) ， Key = "LinLiYan"；3) 根 據(jù)用戶(hù) 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 刪除用戶(hù)1、流程圖2、輸入項(xiàng)用戶(hù)IDstring頁(yè)面?zhèn)鲄?shù)3、輸出項(xiàng)1、成功，UI提示刪除用戶(hù)完成，刷新列表；2、失敗， UI 提示具體信息。3、

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