软件详细设计说明书示例 软件详细设计说明书实例

软件详细设计说明书

面向对象软件设计说明书模板

软件详细设计说明书示例 软件详细设计说明书实例

软件详细设计说明书示例 软件详细设计说明书实例

1 概述

1.1 系统简述

对系统要完成什么，所面向的用户以及系统运行的环境的简短描述，这部分主要来源于需求说明书的开始部分。

1.2 软件设计目标

这部分论述整个系统的设计目标，明确地说明哪些功能是系统决定实现而哪些时不准备实现的。同时，对于非功能性的需求例如性能、可用性等，亦需提及。需求规格说明书对于这部分的内容来说是很重要的参考，看看其中明确了的功能性以及非功能性的需求。

这部分必须说清楚设计的全貌如何，务必使读者看后知道将实现的系统有什么特点和功能。在随后的文档部分，将解释设计是怎么来实现这些的。

1.3 参考资料

列出本文档中所引用的参考资料。（至少要引用需求规格说明书）

1.4 修订版本记录

列出本文档修改的历史纪录。必须指明修改的内容、日期以及修改人。

2 术语表

对本文档中所使用的各种术语进行说明。如果一些术语在需求规格说明书中已经说明过了，此处不用再重复，可以指引读者参考需求说明。

3 用例

此处要求系统用用例图表述（UML），对每个用例（正常处理的情况）要有中文叙述。

4 设计概述

4.1 简述

这部分要求突出整个设计所采用的方法（是面向对象设计还是结构化设计）、系统的体系结构（例如客户/结构）以及使用到的相应技术和工具（例如OMT、Rose）

4.2 系统结构设计

这部分要求提供高层系统结构的描述，使用方框图来显示主要的组件及组件间的交互。是把逻辑结构同物理结构分离，对前者进行描述。别忘了说明图中用到的俗语和符号。

4.2.1 顶层系统结构

4.2.2 子系统1结构

4.2.3 子系统2结构

4.3 系统界面

各种提供给用户的界面以及外部系统在此处要予以说明。如果在需求规格说明书中已经对用户界面有了叙述，此处不用再重复，可以指引读者参考需求说明。如果系统提供了对其它系统的接口，比如说从其它软件系统导入/导出数据，必须在此说明。

4.4 约束和定

描述系统设计中最主要的约束，这些是由客户强制要求并在需求说明书写明的。说明系统是如何来适应这些约束的。

另外如果本系统跟其它外部系统交互或者依赖其它外部系统提供一些功能辅助，那么系统可能还受到其它的约束。这种情况下，要求清楚地描述与本系统有交互的软件类型（比如某某某数据库软件，某某某EMail软件）以及这样导致的约束（比如只允许纯文本的Email）。

实现的语言和平台也会对系统有约束，同样在此予以说明。

对于因选择具体的设计实现而导致对系统的约束，简要地描述你的想法思路，经过怎么样的权衡，为什么要采取这样的设计等等。

5 对象模型

5.1 系统对象模型

提供整个系统的对象模型，如果模型过大，按照可行的标准把它划分成小块，例如可以把客户端和端的对象模型分开成两个图表述。

对象图应该包含什么呢?

在其中应该包含所有的系统对象。这些对象都是从理解需求后得到的。要明确哪些应该、哪些不应该被放进图中。

所有对象之间的关联必须被确定并且必须指明联系的基数（一对一、一对多还是多对多，0..1，，1..）。聚合和继承关系必须清楚地确定下来。每个图必须附有简单的说明。

可能经过多次反复之后才能得到系统的正确的对象模型。

6 对象描述

在这个部分叙述每个对象的细节，它的属性、它的方法。在这之前必须从逻辑上对对象进行组织。你可能需要用结构图把对象按子系统划分好。

为每个对象做一个条目。在系统对象模型中简要的描述它的用途、约束（如只能有一个实例），列出它的属性和方法。如果对象是存储在持久的数据容器中，标明它是持久对象，否则说明它是个临时对象（transient object）。

对每个对象的每个属性详细说明：名字、类型，如果属性不是很直观或者有约束（例如，每个对象的该属性必须有一个的值或者值域是有限正整数等）。

对每个对象的每个方法详细说明：方法名，返回类型，返回值，参数，用途以及使用的算法的简要说明（如果不是特别简单的话）。如果对变量或者返回值由什么定的话，Pre-conditions和Post-conditions必须在此说明。列出它或者被它调用的方法需要访问或者修改的属性。，提供可以验证实现方法的测试案例。

6.1 子系统1中的对象

6.1.1 对象：对象1

用途：

约束：

持久性：

6.1.1.1 属性描述：

1. 属性：属性1

类型：

描述：

约束：

2. 属性：属性2

6.1.1.2 方法描述：

1. 方法：方法1

返回类型：

参数：

返回值：

Pre-Condition：

Post-Condition：

读取/修改的属性：

调用的方法：

处理逻辑：

测试例：用什么参数调用该方法，期望的输出是什么

7 动态模型

这部分的作用是描述系统如何响应各种。例如，可以建立系统的行为模型。一般使用顺序图和状态图。

确定不同的场景（Scenario）是步，不需要确定所有可能的场景，但是必须至少要覆盖典型的系统用例。不要自己去想当然地创造场景，通常的策略是描述那些客户可以感受得到的场景。

7.1 场景（Scenarios）

对每个场景做一则条目，包括以下内容：

场景名：给它一个可以望文生义的名字

场景描述：简要叙述场景是干什么的以及发生的动作的顺序。

顺序图：描述各种及发生的相对时间顺序。

7.1.1 场景：场景1

描述：

动作1

动作2

7.2 状态图

这部分的内容包括系统动态模型重要的部分的状态图。可能你想为每个对象画一个状态图，但事实上会导致太多不期望的细节信息，只需要确定系统中一些重要的对象并为之提供状态图即可。

7.2.1 状态图1：

8 非功能性需求

在这个部分，必须说明如何处理需求文档中指定的非功能性需求。尽可能客观地评估系统应付每一个非功能性的需求的能力程度。如果某些非功能性需求没有完全在设计的系统中实现，请务必在此说明。另外，你也需要对系统将来的进化作一个估计并描述本设计如何使系统能够适应这些可预见的变化。

9 辅助文档

提供能帮助理解设计的相应文档。

10 词汇索引

文章录入

软件开发详细设计说明书中的功能设计怎么写?请详述？

详细设计阶段: 在这个阶段，各个模块可以分给不同的人去并行设计。在详细设计阶段，设计者的工作对象是一个模块，根据概要设计赋予的局部任务和对外接口，设计并表达出模块的算法、流程、状态转换等内容。这里要注意，如果发现有结构调整（如分解出子模块等）的必要，必须返回到概要设计阶段，将调整反应到概要设计文档中，而不能就地解决，不打招呼。详细设计文档最重要的部分是模块的流程图、状态图、局部变量及相应的文字说明等。一个模块一篇详细设计文档。

概要设计文档相当于机械设计中的装配图，而详细设计文档相当于机械设计中的零件图。文档的编排、装订方式也可以参考机械图纸的方法。

不同对模块的认识和传统定义有所不同，认为是较大的软件功能单元才可以称作模块。这种认识使大家对概要设计和详细设计的分工产生了混乱的理解，降低了文档的可用性，应该予以纠正。、

概要设计中较顶层的部分便是所谓的方案。方案文档的作用是在宏观的角度上保持设计的合理性。

有的项目采用面向对象的分析、设计方法。可能在概要设计、详细设计的分工上疑问更多。其实，面向对象的分析、设计方法并没有强调结构化方法那样的阶段性，因此一般不引入概要、详细设计的概念。如果按照公司的文档体系，非要有这种分工的话，可以将包的划分、类及对象间的关系、类的对外属性、方法及协作设计看做概要设计；类属性、方法的内部实现看做详细设计。 换言之，面向对象的设计方式中，概设指的是有哪些类，祥设指的是类中的方法和出入参等(可以是伪代码)

1.需求分析--产生软件功能规格说明书,需要确定用户对软件的需求,要作到明确、无歧义。不涉及具体实现方法。用户能看得明白，开发人员也可据此进行下面的工作（概要设计）。

2.概要设计--产生软件概要设计说明书，说明系统模块划分、选择的技术路线等，整体说明软件的实现思路。并且需要指出关键技术难点等。

3.详细设计--产生软件详细设计说明书，对概要设计的进一步细化，一般由各部分的担当人员依据概要设计分别完成，然后在集成，是具体的实现细节。理论上要求可以照此编码。

软件详细设计文档示例【软件总体设计说明书】

软件总体设计说明书

一、引言

1、编写目的

本系统介绍了在Visual Basic6.0环境下采用“自上而下地总体规划，自下而上地应用开发”的策略开发一个管理信息系统的过程。

2、背景

通过分析某一学校学生管理的不足，创建了一套行之有效的计算机管理学生的方案。适应科学技术的不断的发展。

3、定义

学生信息管理系统：对学生的基本信息、课程选择、成绩的录入、修改、删除、查询等一系列的作。

4、参考文献

《C语言程序设计》、《软件工程》

二、总体设计

1、需求规定

（1） 能够方便的对信息进行添加、修改、查询、删除和汇总、 通过条件选择查询所有信息、并进行排序。

（2）可以将数据库发布到网上、进行资源共享。

（3）学生可以在自己的权限内对信息进行访问、查询相关信息。

（4）添加功能：可以通过填写表格的形式输入学生成绩及相关信息。 （5）修改功能：通过条件查询所要修改的信息、然后对信息进行修改保存、系统会自动查找是否是重复信息。

（6）删除功能：可以对数据进行删除作。系统能够通过的条件进行查找删除信息、确定删除则数据库自动删除。

2、运行环境

Visual Basic6.0

3、基本设计概要和处理流程

4、结构

主模块的结构图：

登录结构图：

5、功能需求与程序的关系 6、人工处理过程

7、尚未解决的问题

三、接口设计

1、用户接口

2、外部接口

3、内部接口

模块间接口采用数据耦合方式，通过参数表达传送数据，交换信息。

四、运行设计

1、运行模块结合

具体软件的运行模块组合为程序多窗口的运行环境，各个模块在软件运行过程中能较好的交换信息，处理数据。

2、运行控制

软件运行有较友好的界面，基本能够实现用户的数据处理要求。

3、运行时间

系统的运行时间基本可以达到用户所提出的要求

五、系统数据结构设计

1、逻辑结构要点

根据系统需求，把系统分为登录模块，学生管理模块和教师管理模块

2、物理结构要点

系统的物理结构具体由数据库来设计与生成。

学生信息表：

表：

教师表

3、数据结构与程序关系

六、系统出错处理设计

1、出错信息

2、补救措施

由于数据在数据库中已经有备份，故在系统出错后可以依靠数据库的恢复功能，并且依靠日志文件使系统再启动，就算系统崩溃用户数据也不会丢失或遭到破坏。但有可能占用更多的数据存储空间，权衡措施由用户来决定。对一般错误给用户提示信息，用户重新输入或退出。对于错误，启动备份文件恢复，建议使用帮助文件.

软件详细设计说明书实例

列出有关的参考资料，如：

a．本项目的经核准的任务书或合同、上级机关的批文；

b．属于本项目的其他已发表的文件；

c.本文件中各处引用到的文件资料，包括所要用到的软件开发标准。 列出这些文件的标题、文件编号、发表日期和出版单位，说明能够取得这些文件的来源。

F.2程序系统的结构

用一系列图表列出本程序系统内的每个程序（包括每个模块和子程序）的名称、标识符和它们之间 的层次结构关系。

F.3程序1（标识符）设计说明

从本章开始，逐个地给出各个层次中的每个程序的设计考虑。以下给出的提纲是针对一般情况的。 对于一个具体的模块，尤其是层次比较低的模块或子程序，其很多条目的内容往往与它所隶属的上一层 模块的对应条目的内容相同，在这种情况下，只要简单地说明这一点即可。

F.3.1程序描述

给出对该程序的简要描述，主要说明安排设计本程序的目的意义，并且，还要说明本程序的特点（如 是常驻内存还是非常驻？是否子程序？是可重入的还是不可重入的？有无覆盖要求？是顺序处理还是并发 处理卜..等）。

F.3.2功能

说明该程序应具有的功能，可采用IPO图（即输入一处理一输出图）的形式。

F.3.3性能

说明对该程序的全部性能要求，包括对精度、灵活性和时间特性的要求。

F.3.4输入项

给出对每一个输入项的特性，包括名称、标识、数据的类型和格式、数据值的有效范围、输入的方式。 数量和频度、输入媒体、输入数据的来源和条件等等。

F. 3. 5输出项

给出对每一个输出项的特性，包括名称、标识、数据的类型和格式，数据值的有效范围，输出的形式、 数量和频度，输出媒体、对输出图形及符号的说明、条件等等。

F．3．6算法

详细说明本程序所选用的算法，具体的计算公式和计算步骤。

F．3．7流程逻辑

用图表（例如流程图、判定表等）辅以必要的说明来表示本程序的逻辑流程。

F．3.8接口

用图的形式说明本程序所隶属的上一层模块及隶属于本程序的下一层模块、子程序，说明参数赋值和调用方式，说明与本程序相直接关联的数据结构（数据库、数据文卷）。

F．3.9存储分配

根据需要，说明本程序的存储分配。

F．3．10注释设计

软件工程详细设计实例

1.0概述 这部分提供对整个设计文档的概述。描述了所有数据，结构，接口和软件构件级别的设计。 1.1 目标和对象 描述软件对象的所有目标。 1.2 陈述范围 软件描述。主要输入，过程功能，输出的描述，不考虑详细细节。 1.3 软件内容 软件被置于商业或者产品线中，讨论相关的战略问题。目的是让读者能够对“宏图”有所了解。 1.4 主要系统参数 任何商务软件或者产品线都包含软件规定、设计、实现和测试的说明和规范。 2.0 数据设计 描述所有数据结构包括内部变量，全局变量和临时数据结构。 2.1 内部软件数据结构 描述软件内部的构件之间的数据传输的结构。 2.2 全局数据结构 描述主要部分的数据结构。 2.3 临时数据结构 为临时应用而生成的文件的描述。 2.4 数据库描述 作为应用程序的一部分，描述数据库结构。 3.0 结构化和构件级别设计 描述程序结构。 3.1 程序结构 详细描述应用程序所选定的程序结构。 3.1.1 结构图 图形化描述结构。 3.1.2 选择性 讨论其它可供考虑的结构。选定3.1.1中结构类型的原因。 3.2 构件描述 详细描述结构中的每个软件构件。 3.2.1 构件过程叙述(PSPEC) 描述构件的过程。 3.2.2 构件接口描述 详细描述构件的输入和输出。 3.2.3 构件执行细节 每个构件的详细演算描述。 3.2.3.1 接口描述 3.2.3.2 演算模型(e.g., PDL) 3.2.3.3 规范/限制 ]3.2.3.4 本地数据结构 3.2.3.5 在3.2.3.6设计中包含的执行结果 3.3 软件接口描述 软件对外界的接口描述 3.3.1机器对外接口 与其他机器或者设备的接口描述。 3.3.2系统对外接口 对其它系统、产品和网络的接口描述。 3.3.3与人的接口 概述软件与任何人的界面。 4.0 用户界面设计 描述软件的用户界面设计。 4.1 描述用户界面 详细描述用户界面，包括屏幕显示图标、或者类型。 4.1.1 屏幕 从用户角度描述界面。 4.1.2 对象和作 所有屏幕对象和作的定义。 4.2 界面设计规范 用户界面的设计和实现的规范和标准。 4.3 可见构件 实现的GUI可见构件说明。 4.4 UIDS描述 用户界面开发系统描述。 5.0约束、限制和系统参数 会影响软件的规格说明、设计和实现的特殊。 6.0测试标准 测试策略和预备测试用例描述。 6.1 测试的类别 规定实施测试的类别，包括尽量详细的描述。这里是针对黑盒测试现象的描述。 6.2期待软件反馈 测试期待的结果描述。 6.3执行界线 特殊执行需要的说明。 6.4 重要构件确认 决定性构件或者需要特殊注意的构件的测试确认。 7.0附录 设计说明的补充信息。 7.1系统可跟踪矩阵 一个定期回归系统规格跟踪软件需求的矩阵。 7.2 产品战略 如果规格说明书是为一个产品设计的，描述相关的产品战略。 7.3 使用分析算法 描述所有分析活动所使用到的分析算法。 7.4 补充信息 (如果有需要特别说明的)

详细设计说明书怎么写

详细设计，这是考验技术专家设计思维的重要关卡，详细设计说明书应当把具体的模块以最’干净’的方式(黑箱结构）提供给编码者，使得系统整体模块化达到；一份好的详细设计说明书，可以使编码的复杂性减低到，实际上，严格的讲详细设计说明书应当把每个函数的每个参数的定义都精精细细的提供出来，从需求分析到概要设计到完成详细设计说明书，一个软件项目就应当说完成了一半了

换言之，一个大型软件系统在完成了一半的时候，其实还没有开始一行代码工作