软件详细设计文档模板最全面详细设计文档.docx

软件详细设计文档模板最全面详细设计文档.docx

《软件详细设计文档模板最全面详细设计文档.docx》由会员分享，可在线阅读，更多相关《软件详细设计文档模板最全面详细设计文档.docx（12页珍藏版）》请在冰豆网上搜索。

软件详细设计文档模板最全面详细设计文档

研发生产中心

文档编号

版本

A1

密级

商密A

工程名称

Xx系统

工程来源

Xxx系统

详细设计说明书

（内部资料请勿外传）

编写：

日期：

检查：

日期：

审核：

日期：

批准：

日期：

XX公司

版权所有不得复制

文档变更记录

序号

变更〔+/-〕说明

作者

版本号

日期

批准

1

2

1.引言

1.1背景

此文档的背景

1.2编写目的和范围

说明写这份详细设计说明书的目的。

本详细设计说明书编写的目的是说明程序模块的设计考虑，包括程序描述、输入/输出、算法和流程逻辑等，为软件编程和系统维护提供根底。

本说明书的预期读者为系统设计人员、软件开发人员、软件测试人员和工程评审人员。

1.3术语表

定义系统或产品中涉及的重要术语，为读者在阅读文档时提供必要的参考信息。

序号

术语或缩略语

说明性定义

1

PM

ProjectManager,工程经理

2

1.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.系统详细需求分析

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

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

3.1详细需求分析

3.1.1详细功能需求分析

3.1.2详细性能需求分析

3.1.3详细资源需求分析

3.1.4详细接口需求分析

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

4.总体方案确认

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

4.1系统总体结构确认

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

包括：

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

4.1.2应用系统结构确认

4.1.3支撑系统结构确认

4.1.4系统集成确认

4.1.5系统工作流程确认

4.2系统详细界面划分

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

应用系统与支撑系统之间的界面包括系统主效劳器与其他效劳器的效劳范围及访问方式，网络及数据库对应用系统的支撑方式，全局数据的管理与存取方式等。

4.2.2系统内部详细界面划分

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

5.全局数据结构说明

本章说明本程序系统中使用的全局数据常量、变量和数据结构。

5.1常量

包括数据文件名称及其所在目录，功能说明，具体常量说明等。

5.2变量

本章说明本程序系统中使用的全局数据常量、变量和数据结构。

5.3数据结构

包括数据结构名称，功能说明，具体数据结构说明〔定义、注释、取值〕等。

6.系统详细设计

6.1功能结构图

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

对系统的组成及逻辑结构进行设计前确认。

划分系统功能模块或子系统〔如果有或者有必要，特别是大型的软件系统〕。

6.3系统功能模块详细设计

按结构化设计方法，在系统功能逐层分解的根底上，对系统各功能模块或子系统进行设计。

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

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

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

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

每个模块的描述说明可参照以下格式：

模块编号：

模块名称：

输入：

处理：

算法描述：

输出：

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

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

如果对软件需进行二次开发〔包括功能扩展、功能改造、用户界面改造等〕，那么相应的设计工作应该设立子课题完成。

6.4系统界面详细设计

系统界面说明应用系统软件的各种接口。

整个系统的其他接口〔如系统硬件接口、通讯接口等〕在相应的局部说明。

6.4.1外部界面设计

根据系统界面划分进行系统外部界面设计，对系统的所有外部接口〔包括功能和数据接口〕进行设计。

6.4.2内部界面设计

设计系统内部各功能模块间的调用关系和数据接口。

6.4.3用户界面设计

规定人机界面的内容、界面风格、调用方式等，包括所谓的表单设计、报表设计和用户需要的打印输出等设计。

此局部内容可能比拟多。

7.开发和测试生产环境说明

7.1开发环境

7.2测试及产品环境

-Developmentevnironment:

programminglanuague,database

Windwos2003,iis6.0,MySQL,

8.模块设计

8.1用例图

8.2功能设计说明

8.2.1模块1

模块1主要分为以下几个子模块：

子模块1、子模块2和子模块N。

8.2.1.1子模块1

8.2.1.1.1设计图

8.2.1.1.2功能描述

简要描述子模块1的业务功能。

8.2.1.1.3输入数据

详细描述用户输入的数据（包括任何输入设备）以及这些数据的有效性检验规那么。

详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件。

8.2.1.1.4输出数据

详细描述子功能1所产生的数据以及这些数据的表现形式。

8.2.1.1.5业务算法和流程

从业务角度详细描述根据输入数据产生输出数据的业务算法和流程。

8.2.1.1.6数据设计

给出本程序中的局部数据结构说明，包括数据结构名称，功能说明，具体数据结构说明〔定义、注释设计、取值〕等。

相关数据库表，数据存储设计〔具体说明需要以文件方式保存的数据文件名、数据存储格式、数据项及属性等。

〕

8.2.1.1.7源程序文件说明

给出本程序的各源程序文件的说明，包括源程序文件名称及其所在目录，功能说明，包含的前导文件及函数名称等。

8.2.1.1.8函数说明

具体说明本程序中的各个函数，包括函数名称及其所在文件，功能，格式，参数，全局变量，局部变量，返回值，算法说明，使用约束等。

8.2.1.1.9限制条件

8.2.1.1.10其他说明

8.2.2模块2

模块1主要分为以下几个子模块：

子模块1、子模块2和子模块N。

8.2.2.1子模块1

8.2.2.1.1设计图

8.2.2.1.2功能描述

简要描述子模块1的业务功能。

8.2.2.1.3输入数据

详细描述用户输入的数据（包括任何输入设备）以及这些数据的有效性检验规那么。

详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件。

8.2.2.1.4输出数据

详细描述子功能1所产生的数据以及这些数据的表现形式。

8.2.2.1.5业务算法和流程

从业务角度详细描述根据输入数据产生输出数据的业务算法和流程。

8.2.2.1.6数据设计

给出本程序中的局部数据结构说明，包括数据结构名称，功能说明，具体数据结构说明〔定义、注释设计、取值〕等。

相关数据库表，数据存储设计〔具体说明需要以文件方式保存的数据文件名、数据存储格式、数据项及属性等。

〕

8.2.2.1.7源程序文件说明

给出本程序的各源程序文件的说明，包括源程序文件名称及其所在目录，功能说明，包含的前导文件及函数名称等。

8.2.2.1.8函数说明

具体说明本程序中的各个函数，包括函数名称及其所在文件，功能，格式，参数，全局变量，局部变量，返回值，算法说明，使用约束等。

8.2.2.1.9限制条件

8.2.2.1.10其他说明

9.接口设计

9.1内部接口

9.2外部接口

9.2.1接口说明

例如：

xx子系统通过xx从xx子系统取得xx等，相关标准，调用例如，可根据需要增加章节描述接口。

9.2.2调用方式

例如：

内部接口调用：

例:

/**

*通过用户效劳号码取得该客户认证密码等信息，如果该客户存在返回为0，其他情况参考错误编码

*/

publicRUserInfogetUserInfo（StringuserNo）;

10.数据库设计

详见[xxx数据库设计说明书]

如果数据库设计内容比拟少，那么直接在此处描述。

11.系统平安保密设计

11.1说明

例如：

由于存在与外部系统的接口,所以需要考虑访问平安的问题.

11.2设计

例如：

分为数据传输局部,IP过滤局部,身份验证局部.[章节可补充]

11.2.1数据传输局部

例如：

在局部数据传递的时候,考虑以s协议,需要在部署的时候作相关处理.

11.2.2IP过滤分部

例如：

可在系统前端通过Filter实现,该Filter实现对该地址访问的IP过滤作用.可信任IP地址通过xml文件进行配置.

11.2.3身份验证局部

例如：

对信任的用户,颁发身份验证码,通过该标识进行身份识别.

12.系统性能设计

13.系统出错处理

例如：

为了在系统出现异常情况下给用户以明确的提示，可采用两种方式予以提示：

1．使用Javascript的alert（）函数直接提示，这主要在输入或修改的情况下使用；

2．使用统一的错误界面提示，该界面对应于页面。

错误界面样式如下列图所示：

错误提示界面

14.设计和开发标准

【可以列表方式列出设计开发的参考文档的索引，内容较少/关键内容可以章节方式填写】

14.1数据库设计标准

【参见?

XXXX数据库设计标准?

】

14.2.NET编码标准

特别强调：

✧详细请参见?

ASP.Net文档标准?

✧这里只做简单阐述，如有变动，会及时同事整个工程组相关人员。

（1）不要给类名加前缀。

使用PascalCasing风格，不使用匈牙利命名法。

（2）要用名词词组来给类型命名。

使用PascalCasing风格。

（3）类名少用缩写,不要使用下划线字符（_）。

（4）基类CBase的文件名为：

FileBase.cs;

（5）泛型类命名：

考虑用T来命名参数类型，类如：

publicclassList。

（6）接口〔Interface〕命名标准和类命名标准相同，唯一区别是接口在名字前加上“I〞前缀。

（7）枚举命名：

以复数结尾，说明这是一个枚举，例如：

EnumColorButtons

（8）结构命