創作時間：二零二一年六月三十日創作時間：二零二一年六月三十日研發生產中心之老陽二干創作版本A1密級商密A創作時間文檔編號項目名稱Xx系統項目來源Xxx系統詳細設計說明書（內部資料請勿外傳）編寫：日期:檢杳：日期:審核：日期:批準：日期:XX公司版權所有不得復制文檔變動記錄引言4編寫目的和范圍4術語表4參考資料4使用的文字處置和繪圖工具4全局數據結構說明5常量5變量5數據結構5模塊設計5用例圖5功能設計說明5模塊15模塊26接口設計7內部接口7外部接口7接口說明7調用方式8數據庫設計8系統平安保密設計8說明8設計8數據傳輸部份8IP過濾分部8身份驗證部份8系統性能設計9系統犯錯處置91.引言1.1布景此文檔的布景1.2編寫目的和范圍說明寫這份詳細設計說明書的目的.本詳細設計說明書編寫的目的是說明法式模塊的設計考慮,包括法式描述、輸入/輸出、算法和流程邏輯等,為軟件編程和系統維護提供基礎.本說明書的預期讀者為系統設計人員、軟件開發人員、軟件測試人員和項目評審人員.1.3術語表界說系統或產物中涉及的重要術語,為讀者在閱讀文檔時提供需要的參考信息.序號術語或縮略語說明性界說1PMProjectManager,項目經理21.4參考資料列出有關資料的名稱、作者、文件編號或版本等.參考資料包括：a?需求說明書、架構設計說明書等；b?本項目的其他已發表的文件；c?引用文件、資料、軟件開發標準等資料名稱作者文件編號、版本資料寄存地址1.5使用的文字處置和繪圖工具文字處置軟件：[編寫設計文檔使用的文字處置軟件,如RedOffice]繪圖工具：[使用的UML工具,如Rose、Jude、Visio]2.設計概述2.1任務和目標2.1.1需求概述2.1.2運行環境概述2.1.3條件與限制2.1.4詳細設計方法和工具系統詳細需求分析主要對系統級的需求進行分析.首先應對需求分析提出的企業需求進一步確認,并對由于情況變動而帶來的需求變動進行較為詳細的分析.3.1詳細需求分析3.1.1詳細功能需求分析3.1.2詳細性能需求分析3.1.3詳細資源需求分析3.1.4詳細接口需求分析3.1.5詳細系統運行環境及限制條件分析總體方案確認著重解決系統總體結構確認及界面劃分問題.系統總體結構確認對系統組成、邏輯結構及條理進行確認,對應用系統、支撐系統及各自實現的功能進行確認,細化集成設計及系統工作流程,特別要注意因軟件的引進造成的系統自己結構和公司其他系統的結構變動.包括：創作時間：二零二一年六月三十日創作時間：二零二一年六月三十日創作時間：二零二一年六月三十日系統組成、邏輯結構及條理確認4.1.2應用系統結構確認4.1.3支撐系統結構確認4.1.4系統集成確認4.1.5系統工作流程確認系統詳細界面劃分應用系統與支撐系統的詳細界面劃分應用系統與支撐系統之間的界面包括系統主服務器與其他服務器的服務范圍及訪問方式,網絡及數據庫對應用系統的支撐方式,全局數據的管理與存取方式等.4.2.2系統內部詳細界面劃分系統各功能之間的界面包括覆蓋范圍,模塊間功能調用涉及到的系統模塊及方法,全局數據格式,系統性能要求等.全局數據結構說明本章說明本法式系統中使用的全局數據常量、變量和數據結.構5.1常量包括數據文件名稱及其所在目錄,功能說明,具體常量說明等.創作時間：二零二一年六月三十日創作時間：二零二一年六月三十日創作時間：二零二一年六月三十日創作時間：二零二一年六月三十日5.2變量本章說明本法式系統中使用的全局數據常量、變量和數據結.構5.3數據結構包括數據結構名稱,功能說明,具體數據結構說明（界說、注釋、取值）等.系統詳細設計6.1功能結構圖系統結構設計及子系統劃分對系統的組成及邏輯結構進行設計前確認.劃分系統功能模塊或子系統（如果有或者有需要,特別是年夜型的軟件系統）.6.3系統功能模塊詳細設計按結構化設計方法,在系統功能逐層分解的基礎上,對系統各功能模塊或子系統進行設計.此為詳細設計的主要部份之一.用條理圖描述系統的總體結構、功能分解及各個模塊之間的相互調用關系和信息交互,用IPO圖或其他方法描述各模塊完成的功能以上建議采納HIPO圖進行功能分解與模塊描述更高的要求建議采納IDEFO方法進行功能模型設計詳細設計應用系統的各個構成模塊完成的功能及其相互之間的關系，用IPO或結構圖描述各模塊的組成結構、算法、模塊間的接口關系,以及需求、功能和模塊三者之間的交叉參照關.系每個模塊的描述說明可參照以下格式：模塊編號：模塊名稱：輸入：處置：算法描述：輸出：其中處置和算法描述部份主要采納偽碼或具體的法式語言完.成對詳細設計更高的要求建議用［DEF0圖進行各功能模塊的設計如果對軟件需進行二次開發（包括功能擴展、功能改造、用戶界面改造等）,則相應的設計工作應該設立子課題完成.6.4系統界面詳細設計系統界面說明應用系統軟件的各種接口.整個系統的其他接口（如系統硬件接口、通訊接口等）在相應的部份說.明6.4.1外部界面設計根據系統界面劃分進行系統外部界面設計對系統的所有外部接口（包括功能和數據接口）進行設計.6.4.2內部界面設計設計系統內部各功能模塊間的調用關系和數據接.口6.4.3用戶界面設計規定人機界面的內容、界面風格、調用方式等,包括所謂的表單設計、報表設計和用戶需要的打印輸出等設計.此部份內容可能比力多.開發和測試生產環境說明7.1開發環境7.2測試及產物環境-Developmentevnironment:programminglanuague,databaseWindwos2003,iis6.0,MySQL,8.模塊設計8.1用例圖8.2功能設計說明8.2.1模塊1模塊1主要分為以下幾個子模塊：子模塊1、子模塊2和子模塊N.子模塊.1設計圖功能描述簡要描述子模塊1的業務功能.輸入數據詳細描述用戶輸入的數據（包括任何輸入設備）以及這些數據的有效性檢驗規則.詳細描述從物理模型中的哪些表獲取數據以及獲取這些數據的條件.輸出數據詳細描述子功能1所發生的數據以及這些數據的暗示形式.業務算法和流程從業務角度詳細描述根據輸入數據發生輸出數據的業務算法和流程..6數據設計給出本法式中的局部數據結構說明,包括數據結構名稱,功能說明,具體數據結構說明（界說、注釋設計、取值）等.相關數據庫表,數據存儲設計（具體說明需要以文件方式保管的數據文件名、數據存儲格式、數據項及屬性等.）.7源法式文件說明給出本法式的各源法式文件的說明,包括源法式文件名稱及其所在目錄,功能說明,包括的前導文件及函數名稱等..8函數說明具體說明本法式中的各個函數,包括函數名稱及其所在文件,功能,格式,參數,全局變量,局部變量,返回值,算法說明,使用約束等.限制條件其他說明8.2.2模塊2模塊1主要分為以下幾個子模塊：子模塊1、子模塊2和子模塊N.子模塊.1設計圖.2功能描述簡要描述子模塊1的業務功能..3輸入數據詳細描述用戶輸入的數據（包括任何輸入設備）以及這些數據的有效性檢驗規則.詳細描述從物理模型中的哪些表獲取數據以及獲取這些數據的條件..4輸出數據詳細描述子功能1所發生的數據以及這些數據的暗示形式..5業務算法和流程從業務角度詳細描述根據輸入數據發生輸出數據的業務算法和流程.數據設計給出本法式中的局部數據結構說明,包括數據結構名稱,功能說明,具體數據結構說明（界說、注釋設計、取值）等.相關數據庫表,數據存儲設計（具體說明需要以文件方式保管的數據文件名、數據存儲格式、數據項及屬性等.）源法式文件說明給出本法式的各源法式文件的說明,包括源法式文件名稱及其所在目錄,功能說明,包括的前導文件及函數名稱等..8函數說明具體說明本法式中的各個函數,包括函數名稱及其所在文件,功能,格式,參數,全局變量,局部變量,返回值,算法說明,使用約束等..9限制條件其他說明9.接口設計9.1內部接口9.2外部接口9.2.1接口說明例如：XX子系統通過XX從XX子系統取得XX等,相關標準調用示例,可根據需要增加章節描述接口.9.2.2調用方式例如：內部接口調用：例:/***通過用戶服務號碼取得該客戶認證密碼等信息如果該客戶存在返回為0,其他情況參考毛病編碼*/publicRUserlnfogetUserinfo(StringuserNo);10.數據庫設計詳見［xxx數據庫設計說明書如果數據庫設計內容比力少,則直接在此處描述.11.系統平安保密設計11.1說明例如：由于存在與外部系統的接口,所以需要考慮訪問平安的問題.11.2設計例如：分為數據傳輸部份IP過濾部份，身份驗證部份［章節可彌補］數據傳輸部份例如：在部份數據傳遞的時候陽慮以https協議，需要在布置的時候作相關處置.IP過濾分部例如：可在系統前端通過Filter實現該Filter實現對該地址訪問的IP過濾作用可信任IP地址通過xml文件進行配置身份驗證部份例如：對信任的用戶公布身份驗證碼,通過該標識進行身份識別.12.系統性能設計13.系統犯錯處置例如：為了在系統呈現異常情況下給用戶以明確的提示,可采納兩種方式予以提示：1?使用Javascript的alert()函數直接提示這主要在輸入或修改的情況下使用；2．使用統一的毛病界面提示,該界面對應于頁面.毛病界面樣式如下圖所示：毛病提示界面14.設計和開發規范【可以列表方式列出設計開發的參考文檔的索引內容較少/關鍵內容可以章節方式填寫】數據庫設計規范【拜會《XXXX數據庫設計規范》】.NET編碼規范特別強調：?詳細請拜會《ASP.Net文檔規范》?這里只做簡單論述，如有變動，會及時同事整個項目組相關人員.不要給類名加前綴.使用PascalCasing風格，不使用匈牙利命名法.要用名詞詞組來給類型命名.使用PascalCasing風格.類名少用縮寫，不要使用下劃線字符(_).基類CBase的文件名為：FileBase.cs;泛型類命名：考慮用T來命名參數類型，類如：publicclassList〈T>.接口(Interface)命名規范和類命名規范相同，唯一區別是接口在名字前加上“I”前綴.枚舉命名：以復數結尾，標明這是一個枚舉，例如：EnumColorButtons結構命名：標明這是一個結構體，例如：StructureCustomerInfoRecord'以Record結尾?除使用工具直接生成的類外，其它所有類的功能要有注釋，即使只是一個數據對象；非罕見功能的API必需要有功能描述的注釋.自力的要被應用其他功能所調用的模塊的接口和公共API的注釋要完備，即包括功能說明、參數和返回值說明.其它情況的API的注釋盡量完備，但不強制要求.一次性的流翻開后必需關閉和釋放.一般地，在流翻開后，都有一個trycatch語句，務必加上finally塊釋放流資源.?即使IF,While是單語句，也要使用“{}”來劃分法式塊.不要有完全為調試使用的日志信息，如(“1”)；如要使用,在調試完成后請及時刪除.?一些知識性代碼，不需要寫沒需要的注釋.?不要用工具生成沒用的注釋.14.3代碼目錄結構系統架構目錄結構設計圖，如下結構說明：作用范圍包名描述整個法式ContentImages寄存圖片ScriptsJquery以及樣式表等jquery-eas