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

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

《软件系统详细设计说明书模板.docx》由会员分享，可在线阅读，更多相关《软件系统详细设计说明书模板.docx（16页珍藏版）》请在冰豆网上搜索。

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

XXXXX系统

详细设计说明书

文件状态：

文件标识：

[V]草稿

当前版本：

1.0

[]正式发布

作者：

[]正在修改

完成日期：

版本历史

版本/状态

作者

参与者

起止日期

备注

1.0

开始编写

修改记录

日期

修订版本

修改章节

修改描述

作者

1引言5

1.1编写目的5

1.2背景5

1.3参考资料5

1.4术语定义及说明5

2设计概述5

2.1任务和目标5

2.1.1需求概述5

2.1.2运行环境概述5

2.1.3条件与限制6

2.1.4详细设计方法和工具6

3系统详细需求分析6

3.1详细需求分析6

3.2详细系统运行环境及限制条件分析接口需求分析6

4总体方案确认6

4.1系统总体结构确认6

4.2系统详细界面划分7

4.2.1应用系统与支撑系统的详细界面划分7

4.2.2系统部详细界面划分7

5系统详细设计7

5.1系统程序代码架构设计7

5.1.1UI（UserInterface）用户界面表示层7

5.1.2BLL（BusinessLogicLayer）业务逻辑层8

5.1.3DAL（DataAccessLayer）数据访问层8

5.1.4Common类库8

5.1.5EntityClass实体类8

5.2系统结构设计及子系统划分8

5.3系统功能模块详细设计9

5.3.1XX子系统9

•1XX模块9

歹u表和分页9

创建XX9

.2XX模块9

XX列表9

XX修改9

5.3.2XX子系统9

5.3.6.1用户管理模块9

5.3.6.2角色管理模块14

5.3.6.3系统设置模块14

5.3.6.4系统登录注销模块14

5.4系统界面详细设计14

5.4.1外部界面设计14

5.4.2部界面设计14

5.4.3用户界面设计14

6数据库系统设计14

6.1设计要求14

6.2信息模型设计14

6.3数据库设计14

6.3.1设计依据14

6.3.2数据库种类及特点15

6.3.3数据库逻辑结构15

6.3.4物理结构设计15

6.3.5数据库安全15

6.3.6数据字典15

7信息编码设计15

7.1代码结构设计15

7.2代码编制15

1引言

1.1编写目的

说明编写详细设计方案的主要目的。

说明书编制的目的是说明一个软件系统各个层次中的每个程序（每个模块或子程序）和数据库系统的设计考虑,为程序员编码提供依据。

如果一个软件系统比较简单,层次很少，本文件可以不单独编写,和槪要设计说明书中不重复部分合并编写。

方案重点、是模块的执行流程和数据库系统详细设计的描述。

1.2背景

应包含以下几个方面的容:

A.待开发软件系统名称;

B.该系统基本概念,如该糸统的类型、从属地位等;

C.开发项目组名称。

1.3参考资料

列出详细设计报告引用的文献或资料，资料的作者、标题、出版单位和出版日期等信息,必要时说明如何得到这些资料。

1.4术语定义及说明

列出本文档中用到的可能会引起混淆的专门术语、定义和缩写词的原文。

2设计概述

2.1任务和目标

说明详细设计的任务及详细设计所要达到的目标。

2.1.1需求概述

对所开发软件的概要描述,包括主要的业务需求、输入、輸出、主要功能、性能等,尤其需要描述系统性能需求。

2.1.2运行环境概述

对本系统所依轍于运行的硬件,包括操作系统、数据库系统、中间件、接口软件、可能的性能监控与分析等软件环境的描述,及配置要求。

2.1.3条件与限制

详细描述系统所受的部和外部条件的约束和限制说明。

包括业务和技术方面的条件与限制以及进度、管理等方面的限制。

2.1.4详细设计方法和工具

简要说明详细设计所采用的方法和使用的工具。

如11IP0图方法、IDEF（I2DEF）方法、E-R图，数据流程图、业务流程图、选用的CASE工具等,尽量采用标准规和辅助工具。

3系统详细需求分析

主要对系统级的需求进行分析。

首先应对需求分析提出的企业需求进一步确认，并对由于情况变化而带来的需求变化进行较为详细的分析。

3.1详细需求分析

包括:

•详细功能需求分析

•详细性能需求分析

•详细资源需求分析

•详细系统运行环境及限制条件分析

3.2详细系统运行环境及限制条件分析接口需求分析

包括:

•系统接口需求分析

•现有硬、软件资源接口需求分析

•引进硬、软件资源接口需求分析

4总体方案确认

着重解决系统总体结构确认及界面划分问题。

4.1系统总体结构确认

对系统组成、逻辑结构及层次进行确认,对应用系统、支撑系统及各自实现的功能进行确认,细化集成设计及系统工作流程,特别要注意因软件的引进造成的系统本身结构和公司其他系统的结构变化。

包括:

•系统组成、逻辑结构及层次确认

•应用糸统结构确认

•支撑糸统结构确认

•糸统集成确认

系统工作流程确认

4.2系统详细界面划分

4.2.1应用系统与支撑系统的详细界面划分

应用系统与支撑系统之间的界面包括系统主服务器与其他服务器的服务围及访问方式,网络及数据库对应用糸统的支撑方式,全局数据的管理与存取方式筝。

4.2.2系统部详细界面划分

系统各功能之间的界面包括覆盖围,模块间功能调用涉及到的系统模块及方法,全局数据格式,系统性能要求等。

5系统详细设计

5.1系统程序代码架构设计

系统采用三层架构模型，将应用系统划分为用户界面表示层、业务逻辑层、数据访问层，以及

EntityClass实体类、Common类库组成，各层的关系如下图所示：

5.1.1UI（UserInterface）用户界面表示层

负责与用户进行交互，显示、接受数据，与此同时，做一些简单逻辑处理，如：

输入数据有效性判断、显示各种异常、处理Dataset记录集数据。

它只与BLL（BusinessLogicLayer）业务逻辑层、EntityClass实体类两个项目发生关联，可能与Common类库发生关联。

5.1.2BLL（BusinessLogicLayer）业务逻辑层

是整个系统的核心，它承担了所有的逻辑判断，实现了程序的功能，它是灵活的。

BLL层既是调用者，又是被调用者，因此，要适当的进行设计达到解耦的效果。

BLL层只关联DAL层和实体类,可能关联Common类库。

虽然BLL层被U层调用，但是BLL层无需关心UI层的情况。

数据库中每个表都对应一个BLL类，为了达到解耦效果，BLL类不能直接调用其他表的DAL类，可以BLL类之间相互调用。

5.1.3DAL（DataAccessLayer）数据访问层

提供数据访问的接口，没有任何逻辑。

在接口中对数据库操作语句进行组合装配。

DAL层一般关联Common类库中的最底层，最基础的数据库类（比如：

数据库），必须关联EntityClass实体类项目。

DAL层只是数据库的管理者，但不是访问者，不直接与数据库发生关联。

数据库中每个表都对应一个DAL层的接口（访问控制）类。

5.1.4Conamon类库

用于存放公用的类。

最常用的就是数据库访问类，比如：

字符串，数据库引擎类。

它直接与数据库进行机械式的交换，无任何逻辑。

5.1.5EntityClass实体类

相当于加强的数据结构，实现了对数据的封装。

数据库中每个表都对应一个实体类，表的字段就是实体类的属性，类型一一对应。

UI、BLL、DAL这三层的交互主要就是通过实体类作为参数，并Return回信息。

5.2系统结构设计及子系统划分

根据业务和功能，将系统的逻辑结构划分为XX子系统、XX子系等6个子系统，如下图所示：

各个子系统按照功能角度分解，划分出若干不同的功能模块，如下面各图所示:

5.3系统功能模块详细设计

按结构化设计方法,左系统功能逐层分解的基础上,对系统各功能模块或子系统进行设计。

此为详细设计的主要部分之一。

用层次图描述系统的总体结构、功能分解及各个模块之间的相互调用关系和信恵交互,用］P0图或其他方法描述各模块完成的功能。

以上建议采用11IP0图进行功能分解与模块描述,更高的要求建议采用IDEFO方法进行功能模型设计。

详细设计应用系统的各个构成模块完戒的功能及其相互之间的关系,用IPO或结构图描述各模块的组成结构、算法、模块间的接口关系,以及需求、功能和模块三者之间的交叉参照关系。

每个模块的描述说明可卷照以下格式:

模块编号:

模块名称:

输入:

处理:

算法描述:

输出:

其中处理和算法描述部分主要采用伪码或具体的程序语言完成。

对详细设计更高的要求建议用IDEFO图进行各功能模块的设计。

如果对软件需迸行二次开发（包括功能扩展、功能改造、用户界面改造等），则相应的设计工作应该设立子课題完成。

注意：

算法描述主要是说明BLL层的代码逻辑，UI层只做简单的输入验证和界面显示功能。

5.3.1XX子系统

•1XX模块

列表和分页

创建XX

.2XX模块

XX列表

XX修改

5.3.2XX子系统

5.3.6.1用户管理模块

模块描述：

管理系统用户，包括添加用户并赋予角色、修改用户资料和角色、刪除用户。

主要功能：

添加用户、修改用户、刪除用户、列表和分页。

5.3.6.1.1列表和分页

1、流程图

省略

2、输入项

分页索引页面传参数页面加载时为1

3、输出项

1）列表详细记录；

2）当前页码；

3）分页总数；

4）记录总数。

4、算法描述

系统管理用户数据量不大，而且该功能使用频率不高，可以不用优化分页，直接获取用户表全部记录，建议UI层使用gridview控件，调用ExamSys.BLL.SystemadmininfoGetAllList（）绑定控件,利用gridview自带分页功能，显示分页按钮、当前页、分页总数、记录总数、

53.6.1.2添加用户

1、流程图

2、输入项

用户ID

string

必填

string

必填

用户密码

string

必填

确认密码

string

必填

联系

string

E-mail

string

状态

char

用户角色ID

string

3、输出项

1）成功，UI提不添加用户完成；

2）失败，UI提示具体信息。

4、算法描述

1）前端js判断必填项的输入和二次密码是否相同，角色可以不选;

2）BLL须验证必填项，用户名是唯一的不能重复；

3）加密密码使用MD5.Encrypt（stringString,stringKey）>Key=wXXXXXXXXn;

4）用户信息保存至表Systeni_admin_info,ExamSys.DAL.System_admin_infoAdd（ExamSys.Model.Systemadniinin『omodel）;

5）分拆角色ID字符串并循环字符串数组，信息保存至表Dict_admin_vs_roles,ExamSys・BLL・Di