软件系统详细设计说明书模板

-.z*****系统详细设计说明书文件状态：[√]草稿[]正式发布[]正在修改文件标识：当前版本：1.0完成日期：版本历史版本/状态作者参与者起止日期备注1.0开场编写修改记录日期修订版本修改章节修改描述作者目录TOC\o"1-4"\h\z\uHYPERLINK\l"_Toc390869734"1引言PAGEREF_Toc390869734\h5HYPERLINK\l"_Toc390869735"1.1编写目的PAGEREF_Toc390869735\h5HYPERLINK\l"_Toc390869736"1.2背景PAGEREF_Toc390869736\h5HYPERLINK\l"_Toc390869737"1.3参考资料PAGEREF_Toc390869737\h5HYPERLINK\l"_Toc390869738"1.4术语定义及说明PAGEREF_Toc390869738\h5HYPERLINK\l"_Toc390869739"2设计概述PAGEREF_Toc390869739\h5HYPERLINK\l"_Toc390869740"2.1任务和目标PAGEREF_Toc390869740\h5HYPERLINK\l"_Toc390869741"需求概述PAGEREF_Toc390869741\h5HYPERLINK\l"_Toc390869742"运行环境概述PAGEREF_Toc390869742\h5HYPERLINK\l"_Toc390869743"条件与限制PAGEREF_Toc390869743\h6HYPERLINK\l"_Toc390869744"详细设计方法和工具PAGEREF_Toc390869744\h6HYPERLINK\l"_Toc390869745"3系统详细需求PAGEREF_Toc390869745\h6HYPERLINK\l"_Toc390869746"3.1详细需求分析PAGEREF_Toc390869746\h6HYPERLINK\l"_Toc390869747"3.2详细系统运行环境及限制条件分析接口需求分析PAGEREF_Toc390869747\h6HYPERLINK\l"_Toc390869748"4总体确认PAGEREF_Toc390869748\h6HYPERLINK\l"_Toc390869749"4.1系统总体构造确认PAGEREF_Toc390869749\h6HYPERLINK\l"_Toc390869750"4.2系统详细界面划分PAGEREF_Toc390869750\h7HYPERLINK\l"_Toc390869751"应用系统与支撑系统的详细界面划分PAGEREF_Toc390869751\h7HYPERLINK\l"_Toc390869752"系统部详细界面划分PAGEREF_Toc390869752\h7HYPERLINK\l"_Toc390869753"5系统详细设计PAGEREF_Toc390869753\h7HYPERLINK\l"_Toc390869754"5.1系统程序代码架构设计PAGEREF_Toc390869754\h7HYPERLINK\l"_Toc390869755"UI(UserInterface)用户界面表示层PAGEREF_Toc390869755\h7HYPERLINK\l"_Toc390869756"BLL(BusinessLogicLayer)业务逻辑层PAGEREF_Toc390869756\h8HYPERLINK\l"_Toc390869757"DAL(DataAccessLayer)数据访问层PAGEREF_Toc390869757\h8HYPERLINK\l"_Toc390869758"Common类库PAGEREF_Toc390869758\h8HYPERLINK\l"_Toc390869759"EntityClass实体类PAGEREF_Toc390869759\h8HYPERLINK\l"_Toc390869760"5.2系统构造设计及子系统划分PAGEREF_Toc390869760\h8HYPERLINK\l"_Toc390869761"5.3系统功能模块详细设计PAGEREF_Toc390869761\h9HYPERLINK\l"_Toc390869762"**子系统PAGEREF_Toc390869762\h9HYPERLINK\l"_Toc390869763".1**模块PAGEREF_Toc390869763\h9HYPERLINK\l"_Toc390869764"列表和分页PAGEREF_Toc390869764\h9HYPERLINK\l"_Toc390869765"创立**PAGEREF_Toc390869765\h9HYPERLINK\l"_Toc390869766".2**模块PAGEREF_Toc390869766\h9HYPERLINK\l"_Toc390869767"**列表PAGEREF_Toc390869767\h9HYPERLINK\l"_Toc390869768"**修改PAGEREF_Toc390869768\h9HYPERLINK\l"_Toc390869769"**子系统PAGEREF_Toc390869769\h9HYPERLINK\l"_Toc390869770"用户管理模块PAGEREF_Toc390869770\h9HYPERLINK\l"_Toc390869771"角色管理模块PAGEREF_Toc390869771\h14HYPERLINK\l"_Toc390869772"系统设置模块PAGEREF_Toc390869772\h14HYPERLINK\l"_Toc390869773"系统登录注销模块PAGEREF_Toc390869773\h14HYPERLINK\l"_Toc390869774"5.4系统界面详细设计PAGEREF_Toc390869774\h14HYPERLINK\l"_Toc390869775"外部界面设计PAGEREF_Toc390869775\h14HYPERLINK\l"_Toc390869776"部界面设计PAGEREF_Toc390869776\h14HYPERLINK\l"_Toc390869777"用户界面设计PAGEREF_Toc390869777\h14HYPERLINK\l"_Toc390869778"6数据库系统设计PAGEREF_Toc390869778\h14HYPERLINK\l"_Toc390869779"6.1设计要求PAGEREF_Toc390869779\h14HYPERLINK\l"_Toc390869780"6.2信息模型设计PAGEREF_Toc390869780\h14HYPERLINK\l"_Toc390869781"6.3数据库设计PAGEREF_Toc390869781\h14HYPERLINK\l"_Toc390869782"设计依据PAGEREF_Toc390869782\h14HYPERLINK\l"_Toc390869783"数据库种类及特点PAGEREF_Toc390869783\h15HYPERLINK\l"_Toc390869784"数据库逻辑构造PAGEREF_Toc390869784\h15HYPERLINK\l"_Toc390869785"物理构造设计PAGEREF_Toc390869785\h15HYPERLINK\l"_Toc390869786"数据库平安PAGEREF_Toc390869786\h15HYPERLINK\l"_Toc390869787"数据字典PAGEREF_Toc390869787\h15HYPERLINK\l"_Toc390869788"7信息编码设计PAGEREF_Toc390869788\h15HYPERLINK\l"_Toc390869789"7.1代码构造设计PAGEREF_Toc390869789\h15HYPERLINK\l"_Toc390869790"7.2代码编制PAGEREF_Toc390869790\h15引言编写目的说明编写详细设计方案的主要目的。说明书编制的目的是说明一个软件系统各个层次中的每个程序〔每个模块或子程序〕和数据库系统的设计考虑，为程序员编码提供依据。如果一个软件系统比拟简单，层次很少，本文件可以不单独编写，和概要设计说明书中不重复局部合并编写。方案重点是模块的执行流程和数据库系统详细设计的描述。背景应包含以下几个方面的容：A.待开发软件系统名称；B.该系统根本概念，如该系统的类型、附属地位等；C.开发组名称。参考资料列出详细设计引用的文献或资料，资料的作者、标题、出版单位和出版日期等信息，必要时说明如何得到这些资料。术语定义及说明列出本文档中用到的可能会引起混淆的专门术语、定义和缩写词的原文。设计概述任务和目标说明详细设计的任务及详细设计所要到达的目标。需求概述对所开发软件的概要描述,包括主要的业务需求、输入、输出、主要功能、性能等，尤其需要描述系统性能需求。运行环境概述对本系统所依赖于运行的硬件，包括操作系统、数据库系统、中间件、接口软件、可能的性能监控与分析等软件环境的描述，及配置要求。条件与限制详细描述系统所受的部和外部条件的约束和限制说明。包括业务和技术方面的条件与限制以及进度、管理等方面的限制。详细设计方法和工具简要说明详细设计所采用的方法和使用的工具。如HIPO图方法、IDEF〔I2DEF〕方法、E－R图，数据流程图、业务流程图、选用的CASE工具等，尽量采用规和辅助工具。系统详细需求分析主要对系统级的需求进展分析。首先应对需求分析提出的企业需求进一步确认，并对由于情况变化而带来的需求变化进展较为详细的分析。详细需求分析包括：详细功能需求分析详细性能需求分析详细资源需求分析详细系统运行环境及限制条件分析详细系统运行环境及限制条件分析接口需求分析包括：系统接口需求分析现有硬、软件资源接口需求分析引进硬、软件资源接口需求分析总体方案确认着重解决系统总体构造确认及界面划分问题。系统总体构造确认对系统组成、逻辑构造及层次进展确认，对应用系统、支撑系统及各自实现的功能进展确认，细化集成设计及系统工作流程，特别要注意因软件的引进造成的系统本身构造和公司其他系统的构造变化。包括：系统组成、逻辑构造及层次确认应用系统构造确认支撑系统构造确认系统集成确认系统工作流程确认系统详细界面划分应用系统与支撑系统的详细界面划分应用系统与支撑系统之间的界面包括系统主效劳器与其他效劳器的效劳围及访问方式，网络及数据库对应用系统的支撑方式，全局数据的管理与存取方式等。系统部详细界面划分系统各功能之间的界面包括覆盖围，模块间功能调用涉及到的系统模块及方法，全局数据格式，系统性能要求等。系统详细设计系统程序代码架构设计系统采用三层架构模型，将应用系统划分为用户界面表示层、业务逻辑层、数据访问层，以及EntityClass实体类、Common类库组成，各层的关系如下列图所示：UI(UserInterface)用户界面表示层负责与用户进展交互，显示、承受数据，与此同时，做一些简单逻辑处理，如：输入数据有效性判断、显示各种异常、处理Dataset记录集数据。它只与BLL(BusinessLogicLayer)业务逻辑层、EntityClass实体类两个工程发生关联，可能与Common类库发生关联。BLL(BusinessLogicLayer)业务逻辑层是整个系统的核心，它承当了所有的逻辑判断，实现了程序的功能，它是灵活的。BLL层既是调用者，又是被调用者，因此，要适当的进展设计到达解耦的效果。BLL层只关联DAL层和实体类，可能关联Common类库。虽然BLL层被U层调用，但是BLL层无需关心UI层的情况。数据库中每个表都对应一个BLL类，为了到达解耦效果，BLL类不能直接调用其他表的DAL类，可以BLL类之间相互调用。DAL(DataAccessLayer)数据访问层提供数据访问的接口，没有任何逻辑。在接口中对数据库操作语句进展组合装配。DAL层一般关联Common类库中的最底层，最根底的数据库类〔比方：数据库〕，必须关联EntityClass实体类工程。DAL层只是数据库的管理者，但不是访问者，不直接与数据库发生关联。数据库中每个表都对应一个DAL层的接口(访问控制)类。Common类库用于存放公用的类。最常用的就是数据库访问类，比方：字符串，数据库引擎类。它直接与数据库进展机械式的交换，无任何逻辑。EntityClass实体类相当于加强的数据构造，实现了对数据的封装。数据库中每个表都对应一个实体类，表的字段就是实体类的属性，类型一一对应。UI、BLL、DAL这三层的交互主要就是通过实体类作为参数，并Return回信息。系统构造设计及子系统划分根据业务和功能，将系统的逻辑构造划分为**子系统、**子系等6个子系统，如下列图所示：********系统**管理子系统**管理子系统**子系统**子系统**子系统**子系统各个子系统按照功能角度分解，划分出假设干不同的功能模块，如下面各图所示：系统功能模块详细设计按构造化设计方法，在系统功能逐层分解的根底上，对系统各功能模块或子系统进展设计。此为详细设计的主要局部之一。用层次图描述系统的总体构造、功能分解及各个模块之间的相互调用关系和信息交互，用IPO图或其他方法描述各模块完成的功能。以上建议采用HIPO图进展功能分解与模块描述，更高的要求建议采用IDEF0方法进展功能模型设计。详细设计应用系统的各个构成模块完成的功能及其相互之间的关系，用IPO或构造图描述各模块的组成构造、算法、模块间的接口关系，以及需求、功能和模块三者之间的穿插参照关系。每个模块的描述说明可参照以下格式：模块编号：模块名称：输入：处理：算法描述：输出：其中处理和算法描述局部主要采用伪码或具体的程序语言完成。对详细设计更高的要求建议用IDEF0图进展各功能模块的设计。如果对软件需进展二次开发〔包括功能扩展、功能改造、用户界面改造等〕，则相应的设计工作应该设立子课题完成。注意：算法描述主要是说明BLL层的代码逻辑，UI层只做简单的输入验证和界面显示功能。**子系统**模块列表和分页创立****模块**列表**修改**子系统用户管理模块模块描述：管理系统用户，包括添加用户并赋予角色、修改用户资料和角色、删除用户。主要功能：添加用户、修改用户、删除用户、列表和分页。列表和分页流程图省略输入项分页索引页面传参数页面加载时为1输出项列表详细记录；当前页码；分页总数；记录总数。算法描述系统管理用户数据量不大，而且该功能使用频率不高，可以不用优化分页，直接获取用户表全部记录，建议UI层使用gridview控件，调用E*amSys.BLL.System_admin_infoGetAllList()绑定控件，利用gridview自带分页功能，显示分页按钮、当前页、分页总数、记录总数、添加用户流程图输入用户资料选择角色加密密码填写合规用户信息保存至表System_admin_info验证必填项验证用户名是否存在是否成功分拆角色ID字符串循环字符串数组信息保存至表Dict_admin_vs_roles返回成功信息是否是返回失败信息否是否操作记录日志输入项用户IDstring必填string必填用户密码string必填确认密码string必填联系stringE-mailstring状态char用户角色IDstring输出项成功，UI提示添加用户完成；失败，UI提示具体信息。算法描述前端js判断必填项的输入和二次密码是否一样，角色可以不选；BLL须验证必填项，用户名是唯一的不能重复；加密密码使用MD5.Encrypt(stringString,stringKey)，Key="********"；用户信息保存至表System_admin_info，E*amSys.DAL.System_admin_infoAdd(E*amSys.Model.System_admin_infomodel)；分拆角色ID字符串并循环字符串数组，信息保存至表Dict_admin_vs_roles，E*amSys.BLL.Dict_admin_vs_rolesAdd(E*amSys.Model.Dict_admin_vs_rolesmodel)。修改用户流程图输入用户资料选择角色填写合规用户信息保存至表System_admin_info验证必填项加密密码是否成功分拆角色ID字符串循环字符串数组信息保存至表Dict_admin_vs_roles返回成功信息是是返回失败信息否否根据用户ID删除表Dict_admin_vs_roles记录是否成功是否操作记录日志输入项用户IDstring页面传参数string必填用户密码string必填确认密码string必填联系stringE-mailstring状态char用户角色IDstring输出项成功，UI提示修改用户完成；失败，UI提示具体信息。算法描述前端js判断必填项的输入和二次密码是否一样，角色可以不选；加密密码使用Chukeh.Security.MD5.Encrypt(stringString,stringKey)，Key="LinLiYan"；根据用户ID删除表Dict_admin_vs_roles的记录E*amSys.BLL.Dict_admin_vs_rolesDeleteByAdminID(stringadmin_id)；分拆角色ID字符串并循环字符串数组，信息保存至该表E*amSys.BLL.Dict_admin_vs_rolesAdd(E*amSys.Model.Dict_admin_vs_rolesmodel)。删除用户流程图列表中点击删除按钮是否成功返回成功信息是返回失败信息否根据用户ID删除表Dict_admin_vs_roles记录是否成功是否根据用户ID删除表System_admin_info记录操作记录日志输入项用户IDstring页面传参数输出项成功，UI提示删除用户完成，刷新列表；失败，UI提示具体信息。算法描述根据用户ID删除表System_admin_info的记录E*amSys.DAL.System_admin_infoDelete(stringadmin_id)；根据用户ID删除表Dict_admin_vs_roles的记录E*amSys.BLL.Dict_admin_vs_rolesDeleteByAdminID(stringadmin_id)。角色管理模块系统设置模块系统登录注销模块系统界面详细设计系统界面说明应用系统软件的各种接口。整个系统的其他接口〔如系统硬件接口、通讯接口等〕在相应的局部说明。外部界面设计根据系统界面划分进展系统外部界面设计，对系统的所有外部接口〔包括功能和数据接口〕进展设计。部界面设计设计系统部各功能模块间的调用关系和数据接口。用户界面设计规定人机界面的容、界面风格、调用方式等，包括所谓的表单设计、报表设计和用户需要的打印输出等设计。此局部容可能比拟多。数据库系统设计此数据库设计可单独成册，尤其对大型的数据库应用系统，即有一个单独的"数据库设计说明书"。设计要求信息模型设计确定系统信息的类型〔实体或视图〕，确定系统信息实体的属性、关键字及实体之间的联系，详细描述数据库和构造设计，数据元素及属性定义，数据关系模式，数据约束和限制。数据库设计设计依据说明数据被访问的频度和流量，最大数据存储量，数据增长量，存储时间等数据库设计依据。数据库种类及特点说明系统应用的数据库种类、各自的特点、数量及如何实现互联，数据如何传递。数据库逻辑构造说明数据库概念模式向逻辑模式转换所采用的方法论及工具，完成数据库概念模式向逻辑模式的转换。详细列出所使用的数据构造中每个数据项、记录和文件的标识、定义、长度及它们之间的相互关系。此节容为数据库设计的主要局部。物理构造设计列出所使用的数据构造中每个数据项的存储要求、访问方法、存取单位和存取物理关系等。建立系统程序员视图，包括：数据在存中的安排，包括对索引区、缓冲区的设计；所使用的外存设备及外存空间的组织，包括索引区、数据块的组织与划分；访问数据的方式方法。数据库平安说明数据的共享方式，如何保证数据的平安性及性。数据字典编写详细的数据字典。对数据库设计中涉及到的各种工程，如数据项、记录、系、文卷模式、子模式等一般要建立起数据字典，以说明它们的标识符、同义名及有关信息。信息编码设计代码构造设计确认信息分类编码总体方案，进展分类代码构造设计。代码编制按代码构造编制信息代码