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

1、软件系统详细设计说明书模板XXXXX系统详细设计说明书文件状态：文件标识：V草稿当前版本：1.0正式发布作 者：正在修改完成日期：版本历史版本/状态作者参与者起止日期备注1.0开始编写修改记录日期修订版本修改章节修改描述作者1引言 51.1 编写目的 51.2背景 51.3参考资料 51.4术语定义及说明 52设计概述 52.1 任务和目标 52. 1. 1 需求概述 52.1.2运行环境概述 52. 1.3 条件与限制 62. 1.4 详细设计方法和工具 63系统详细需求分析 63.1 详细需求分析 63.2详细系统运行环境及限制条件分析接口需求分析 64总体方案确认 64.1 系统总体结构

2、确认 64.2系统详细界面划分 74.2.1应用系统与支撑系统的详细界面划分 74.2.2系统部详细界面划分 75系统详细设计 75.1 系统程序代码架构设计 75.1. 1 UI (User Interface)用户界面表示层 75. 1.2 BLL(Business Logic Layer)业务逻辑层 85. 1. 3 DAL (Data Access Layer)数据访问层 85.1.4 Common类库 85. 1. 5 Entity Class实体类 85.2系统结构设计及子系统划分 85.3系统功能模块详细设计 95. 3. 1 XX子系统 9 1 XX模块 9歹u表和分页 9创建

3、XX 9.2 XX模块 9XX列表 9XX修改 95. 3.2 XX子系统 95. 3. 6.1用户管理模块 95. 3. 6. 2角色管理模块 145. 3. 6. 3系统设置模块 145. 3. 6. 4系统登录注销模块 145.4系统界面详细设计 145. 4. 1 外部界面设计 145.4. 2 部界面设计 145.4.3用户界面设计 146数据库系统设计 146.1设计要求 146.2信息模型设计 146.3数据库设计 146.3.1 设计依据 146.3.2 数据库种类及特点 156. 3.3 数据库逻辑结构 156. 3.4 物理结构设计 156. 3.5 数据库安全 156.3

4、.6 数据字典 157 信息编码设计 157.1代码结构设计 157.2代码编制 151 引言1.1编写目的说明编写详细设计方案的主要目的。说明书编制的目的是说明一个软件系统各个层次中的每个程序（每个模块或子程序）和数据库 系统的设计考虑,为程序员编码提供依据。如果一个软件系统比较简单,层次很少，本文件可以不单独编写,和槪要设计说明书中不重复 部分合并编写。方案重点、是模块的执行流程和数据库系统详细设计的描述。1.2背景应包含以下几个方面的容:A.待开发软件系统名称;B.该系统基本概念,如该糸统的类型、从属地位等;C.开发项目组名称。1.3参考资料列出详细设计报告引用的文献或资料，资料的作者、

5、标题、出版单位和出版日期等信息,必 要时说明如何得到这些资料。1.4术语定义及说明列出本文档中用到的可能会引起混淆的专门术语、定义和缩写词的原文。2设计概述2.1任务和目标说明详细设计的任务及详细设计所要达到的目标。2.1.1需求概述对所开发软件的概要描述,包括主要的业务需求、输入、輸出、主要功能、性能等,尤其 需要描述系统性能需求。2.1.2运行环境概述对本系统所依轍于运行的硬件,包括操作系统、数据库系统、中间件、接口软件、可能的性 能监控与分析等软件环境的描述,及配置要求。2.1.3条件与限制详细描述系统所受的部和外部条件的约束和限制说明。包括业务和技术方面的条件与限制以 及进度、管理等方

6、面的限制。2.1.4详细设计方法和工具简要说明详细设计所采用的方法和使用的工具。如 11IP0图方法、IDEF (I2DEF)方法、E-R 图，数据流程图、业务流程图、选用的CASE工具等,尽量采用标准规和辅助工具。3系统详细需求分析主要对系统级的需求进行分析。首先应对需求分析提出的企业需求进一步确认，并对由于情况 变化而带来的需求变化进行较为详细的分析。3.1详细需求分析包括:详细功能需求分析详细性能需求分析详细资源需求分析详细系统运行环境及限制条件分析3.2详细系统运行环境及限制条件分析接口需求分析包括:系统接口需求分析 现有硬、软件资源接口需求分析引进硬、软件资源接口需求分析4总体方案确

7、认着重解决系统总体结构确认及界面划分问题。4.1系统总体结构确认对系统组成、逻辑结构及层次进行确认,对应用系统、支撑系统及各自实现的功能进行确认, 细化集成设计及系统工作流程,特别要注意因软件的引进造成的系统本身结构和公司其他系统的结 构变化。包括:系统组成、逻辑结构及层次确认应用糸统结构确认支撑糸统结构确认糸统集成确认系统工作流程确认4.2系统详细界面划分4.2.1应用系统与支撑系统的详细界面划分应用系统与支撑系统之间的界面包括系统主服务器与其他服务器的服务围及访问方式,网络及 数据库对应用糸统的支撑方式,全局数据的管理与存取方式筝。4.2.2系统部详细界面划分系统各功能之间的界面包括覆盖围

8、,模块间功能调用涉及到的系统模块及方法,全局数据格 式,系统性能要求等。5系统详细设计5.1系统程序代码架构设计系统采用三层架构模型，将应用系统划分为用户界面表示层、业务逻辑层、数据访问层，以及Entity Class实体类、Common类库组成，各层的关系如下图所示：5.1.1 UI (User Interface)用户界面表示层负责与用户进行交互，显示、接受数据，与此同时，做一些简单逻辑处理，如：输入数据有效 性判断、显示各种异常、处理Dataset记录集数据。它只与BLL(Business Logic Layer)业务逻辑层、 Entity Class实体类两个项目发生关联，可能与Com

9、mon类库发生关联。5.1.2BLL(Business Logic Layer)业务逻辑层是整个系统的核心，它承担了所有的逻辑判断，实现了程序的功能，它是灵活的。BLL层既是 调用者，又是被调用者，因此，要适当的进行设计达到解耦的效果。BLL层只关联DAL层和实体类, 可能关联Common类库。虽然BLL层被U层调用，但是BLL层无需关心UI层的情况。数据库中每个表都 对应一个BLL类，为了达到解耦效果，BLL类不能直接调用其他表的DAL类，可以BLL类之间相互调用。5.1.3DAL (Data Access Layer)数据访问层提供数据访问的接口，没有任何逻辑。在接口中对数据库操作语句进行

10、组合装配。DAL层一般 关联Common类库中的最底层，最基础的数据库类(比如：数据库)，必须关联Entity Class实体类 项目。DAL层只是数据库的管理者，但不是访问者，不直接与数据库发生关联。数据库中每个表都 对应一个DAL层的接口(访问控制)类。5.1.4Conamon类库用于存放公用的类。最常用的就是数据库访问类，比如：字符串，数据库引擎类。它直接与数 据库进行机械式的交换，无任何逻辑。5.1.5Entity Class实体类相当于加强的数据结构，实现了对数据的封装。数据库中每个表都对应一个实体类，表的字段 就是实体类的属性，类型一一对应。UI、BLL、DAL这三层的交互主要就是

11、通过实体类作为参数，并 Return回信息。5.2系统结构设计及子系统划分根据业务和功能，将系统的逻辑结构划分为XX子系统、XX子系等6个子系统，如下图所示：各个子系统按照功能角度分解，划分出若干不同的功能模块，如下面各图所示:5.3系统功能模块详细设计按结构化设计方法,左系统功能逐层分解的基础上,对系统各功能模块或子系统进行设计。此 为详细设计的主要部分之一。用层次图描述系统的总体结构、功能分解及各个模块之间的相互调用关系和信恵交互,用P0 图或其他方法描述各模块完成的功能。以上建议采用 11IP0图进行功能分解与模块描述,更高的要 求建议采用IDEFO方法进行功能模型设计。详细设计应用系统

12、的各个构成模块完戒的功能及其相互之间的关系,用IPO或结构图描述各 模块的组成结构、算法、模块间的接口关系,以及需求、功能和模块三者之间的交叉参照关系。每个模块的描述说明可卷照以下格式:模块编号:模块名称:输入:处理:算法描述:输出:其中处理和算法描述部分主要采用伪码或具体的程序语言完成。对详细设计更高的要求建议用IDEFO图进行各功能模块的设计。如果对软件需迸行二次开发（包括功能扩展、功能改造、用户界面改造等），则相应的设计工 作应该设立子课題完成。注意：算法描述主要是说明BLL层的代码逻辑，UI层只做简单的输入验证和界面显示功能。5.3.1XX子系统1 XX模块列表和分页创建XX.2 XX

13、模块XX列表XX修改5.3.2XX子系统5.3.6.1 用户管理模块模块描述：管理系统用户，包括添加用户并赋予角色、修改用户资料和角色、刪除用户。主要功能：添加用户、修改用户、刪除用户、列表和分页。5.3.6.1.1 列表和分页1、 流程图省略2、 输入项分页索引 页面传参数 页面加载时为13、 输出项1） 列表详细记录；2） 当前页码；3） 分页总数；4） 记录总数。4、 算法描述系统管理用户数据量不大，而且该功能使用频率不高，可以不用优化分页，直接获取用户表全 部记录，建议UI层使用gridview控件，调用ExamSys. BLL. System admin info GetAllLis

14、t （）绑定控件,利 用gridview自带分页功能，显示分页按钮、当前页、分页总数、记录总数、53.6.1.2 添加用户1、流程图2、输入项用户IDstring必填string必填用户密码string必填确认密码string必填联系stringE-mailstring状态char用户角色IDstring3、输出项1） 成功，UI提不添加用户完成；2） 失败，UI提示具体信息。4、算法描述1）前端js判断必填项的输入和二次密码是否相同，角色可以不选;2)BLL须验证必填项，用户名是唯一的不能重复；3)加密密码使用 MD5. Encrypt (string String, string Key) Key = wXXXXXXXXn;4)用户信 息 保 存至表 Systeni_admin_info , ExamSys. DAL. System_admin_info Add(ExamSys. Model. System adniin ino model);5)分拆角色ID字符串并循环字符串数组，信息保存至表Dict_admin_vs_roles , ExamSys BLL Di