设计样本说明书课件

1、概要设计说明书概要设计说明书主讲教师主讲教师 姜季春姜季春学习目标学习目标n概要设计概述概要设计概述n概要设计说明书的内容要求与编写指南概要设计说明书的内容要求与编写指南n概要设计说明书示例概要设计说明书示例引言引言n问题定义、可行性分析和需求分析构成了软件问题定义、可行性分析和需求分析构成了软件分析阶段，通过需求分析，写出需求说明书，分析阶段，通过需求分析，写出需求说明书，并经过审核和确认后，软件系统的逻辑模型就并经过审核和确认后，软件系统的逻辑模型就确立了，对系统必须确立了，对系统必须“ 做什么做什么”应该很明确应该很明确了。了。n下一步就进入了软件开发阶段，也就是决定下一步就进入了软件开

2、发阶段，也就是决定“ 怎样做怎样做”。软件开发阶段包括设计、编码。软件开发阶段包括设计、编码和测试等。设计又分为概要设计和详细设计两和测试等。设计又分为概要设计和详细设计两个阶段，相应的文档为概要设计说明书和详细个阶段，相应的文档为概要设计说明书和详细说明书。说明书。一一.概要设计概述概要设计概述1.概要设计的任务概要设计的任务n 审查软件分析阶段提供的文档，提出候选审查软件分析阶段提供的文档，提出候选的最佳方案，审查后进入设计阶段。的最佳方案，审查后进入设计阶段。n 设计软件的整体结构，划分程序功能模块，设计软件的整体结构，划分程序功能模块，决定模块间的接口关系和传递信息，设计系统决定模块间

3、的接口关系和传递信息，设计系统全局的存储数据结构、文件或者数据库，设计全局的存储数据结构、文件或者数据库，设计系统输入、输出的方式和格式，确定测试要求。系统输入、输出的方式和格式，确定测试要求。进行安全性、出错处理、代码等各种设计。进行安全性、出错处理、代码等各种设计。n 编写概要设计说明书、用户手册、制定测编写概要设计说明书、用户手册、制定测试计划。试计划。一一.概要设计概述概要设计概述n2.概要设计的步骤概要设计的步骤n1）设想供选择的方案）设想供选择的方案n在概要设计阶段分析员考虑各种可能的在概要设计阶段分析员考虑各种可能的实现方案，并且力求从中选出最佳方案。实现方案，并且力求从中选出最

4、佳方案。在概要设计阶段开始时只有系统的逻辑在概要设计阶段开始时只有系统的逻辑模型，分析员有充分的自由分析比较不模型，分析员有充分的自由分析比较不同的物理实现方案，一旦选出了最佳的同的物理实现方案，一旦选出了最佳的方案，将能大大提高系统的性能、价格方案，将能大大提高系统的性能、价格比。比。一一.概要设计概述概要设计概述n需求分析阶段得出的需求分析阶段得出的数据流图数据流图是概要设计的极好的出是概要设计的极好的出发点。数据流图中的某些处理，可以逻辑地归并在一发点。数据流图中的某些处理，可以逻辑地归并在一个自动化边界内作为一组，另一些处理可以放在另一个自动化边界内作为一组，另一些处理可以放在另一个自

5、动化边界内作为另一组。这些自动化边界通常意个自动化边界内作为另一组。这些自动化边界通常意味着某种实现策略。味着某种实现策略。n设想供选择的方案的一种常用的方法是设想供选择的方案的一种常用的方法是: 设想数据流图设想数据流图中的处理分组的各种可能的方法，抛弃在技术上行不中的处理分组的各种可能的方法，抛弃在技术上行不通的分组方法表可能的实现方法，并且可以启示供选通的分组方法表可能的实现方法，并且可以启示供选择的物理系统。择的物理系统。n在概要设计的这个步骤中分析员仅仅一个边界一个边在概要设计的这个步骤中分析员仅仅一个边界一个边界地设想并且列出供选择的方案，并不评价这些方案。界地设想并且列出供选择的

6、方案，并不评价这些方案。一一.概要设计概述概要设计概述n2）选取合理的方案）选取合理的方案n应该从前一步得到的一系列供选择的方案中选应该从前一步得到的一系列供选择的方案中选取若干个合理的方案，通常至少选取低成本、取若干个合理的方案，通常至少选取低成本、中等成本和高成本的三种方案。在判断哪些方中等成本和高成本的三种方案。在判断哪些方案合理时应该考虑在问题定义和可行性研究阶案合理时应该考虑在问题定义和可行性研究阶段确定的工程规模和目标，有时可能还需要进段确定的工程规模和目标，有时可能还需要进一步征求用户的意见。一步征求用户的意见。n对每个合理的方案分析员都应该准备系统流程对每个合理的方案分析员都应

7、该准备系统流程图、组成系统的物理元素清单、成本图、组成系统的物理元素清单、成本/ 效益分效益分析、实现这个系统的进度计划等四份资料。析、实现这个系统的进度计划等四份资料。一一.概要设计概述概要设计概述n3）推荐最佳方案）推荐最佳方案n分析员应该综合分析对比各种合理方案的利弊，分析员应该综合分析对比各种合理方案的利弊，推荐一个最佳的方案，并且为推荐的方案制定推荐一个最佳的方案，并且为推荐的方案制定详细的实现计划。详细的实现计划。n用户和有关的技术专家应该认真审查分析员所用户和有关的技术专家应该认真审查分析员所推荐的最佳系统，如果该系统确实符合用户的推荐的最佳系统，如果该系统确实符合用户的需要，并

8、且是在现有条件下完全能够实现的，需要，并且是在现有条件下完全能够实现的，则应该提请使用部门负责人进一步审批，在使则应该提请使用部门负责人进一步审批，在使用部门的负责人也接受了分析员所推荐的方案用部门的负责人也接受了分析员所推荐的方案之后，将进入概要设计过程的下一个重要阶之后，将进入概要设计过程的下一个重要阶段段结构设计。结构设计。一一.概要设计概述概要设计概述n4）功能分解）功能分解n为了最终实现目标系统，必须设计出组成这个系统的为了最终实现目标系统，必须设计出组成这个系统的所有程序和文件所有程序和文件(特别是复杂的大型程序特别是复杂的大型程序)设计。结构设计。结构设计确定程序由哪些模块组成以

9、及这些模块之间的关设计确定程序由哪些模块组成以及这些模块之间的关系系; 过程设计确定每个模块的处理过程。结构设计是概过程设计确定每个模块的处理过程。结构设计是概要设计阶段的任务，过程设计是详细设计阶段的任务。要设计阶段的任务，过程设计是详细设计阶段的任务。n为确定软件结构，需要从实现角度把复杂的功能进一为确定软件结构，需要从实现角度把复杂的功能进一步分解。分析员结合算法描述仔细分析数据流图中的步分解。分析员结合算法描述仔细分析数据流图中的每个处理，如果一个处理的功能过分复杂，必须把它每个处理，如果一个处理的功能过分复杂，必须把它的功能适当地分解成一系列比较简单的功能。功能分的功能适当地分解成一

10、系列比较简单的功能。功能分解导致数据流图的进一步细化，同时还应该用解导致数据流图的进一步细化，同时还应该用IPO 图图或其他适当的工具简要描述细化后每个处理的算法。或其他适当的工具简要描述细化后每个处理的算法。一一.概要设计概述概要设计概述n5）设计软件结构）设计软件结构n通常程序中的一个模块完成一个适当的子功能。通常程序中的一个模块完成一个适当的子功能。应该把模块组织成良好的层次系统，顶层模块应该把模块组织成良好的层次系统，顶层模块调用它的下层模块以实现程序的完整功能，每调用它的下层模块以实现程序的完整功能，每个下层模块再调用更下层的模块，从而完成程个下层模块再调用更下层的模块，从而完成程序

11、的一个子功能，最下层的模块完成具体的功序的一个子功能，最下层的模块完成具体的功能。软件结构用层次图或结构图来描绘。能。软件结构用层次图或结构图来描绘。n如果数据流图已经细化到适当的层次，则可以如果数据流图已经细化到适当的层次，则可以直接从数据流图映射出软件结构。直接从数据流图映射出软件结构。一一.概要设计概述概要设计概述n6）数据库设计）数据库设计n需要使用数据库的那些应用领域，分析员应该在需求分析阶段对需要使用数据库的那些应用领域，分析员应该在需求分析阶段对系统数据要求所做的分析的基础上进一步设计数据库。数据库设系统数据要求所做的分析的基础上进一步设计数据库。数据库设计通常包括下述计通常包括

12、下述四个步骤四个步骤:n模式设计。模式设计的目的是确定物理数据库结构。第三范式模式设计。模式设计的目的是确定物理数据库结构。第三范式形式的实体及关系数据模型是模式设计过程的输入，模式设计的形式的实体及关系数据模型是模式设计过程的输入，模式设计的主要问题是处理具体的数据库管理系统的结构约束。主要问题是处理具体的数据库管理系统的结构约束。n子模式设计。子模式是用户使用的数据视图。子模式设计。子模式是用户使用的数据视图。n完整性和安全性设计。指完整性约束条件及用户鉴定标识，存完整性和安全性设计。指完整性约束条件及用户鉴定标识，存取控制、视图和密码存储等设计。取控制、视图和密码存储等设计。n优化。主要

13、目的是改进模式和子模式，以优化数据的存取。优化。主要目的是改进模式和子模式，以优化数据的存取。一一.概要设计概述概要设计概述n7）制定测试计划）制定测试计划n在软件开发的早期阶段考虑测试问题，在软件开发的早期阶段考虑测试问题，能促使软件设计人员在设计时注意提高能促使软件设计人员在设计时注意提高软件的可测试性。软件的可测试性。一一.概要设计概述概要设计概述n8）书写文档）书写文档n应该用正式的文档记录概要设计的结果，在这个阶段应该用正式的文档记录概要设计的结果，在这个阶段应该完成的文档通常有下述几种应该完成的文档通常有下述几种:n 用户手册，根据概要设计阶段的结果，修改更正在用户手册，根据概要设

14、计阶段的结果，修改更正在需求分析阶段产生的初步的用户手册。需求分析阶段产生的初步的用户手册。n 测试计划，包括测试策略，测试方案。测试计划，包括测试策略，测试方案。n 详细的实现计划，给出系统目标，进行概要设计、详细的实现计划，给出系统目标，进行概要设计、数据设计、处理方式设计、运行设计和出错设计。数据设计、处理方式设计、运行设计和出错设计。n 数据库设计结果，通常包括数据库管理系统的选择、数据库设计结果，通常包括数据库管理系统的选择、模式、子模式、完整性和安全性以及优化方法等。模式、子模式、完整性和安全性以及优化方法等。一一.概要设计概述概要设计概述n9）审查和复审）审查和复审n最后应该对概

15、要设计的结果进行严格的最后应该对概要设计的结果进行严格的技术审查，在技术审查通过之后再由使技术审查，在技术审查通过之后再由使用部门的负责人从管理角度进行复审。用部门的负责人从管理角度进行复审。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n概要设计的文档可以围绕下列主要的概要设计的文档可以围绕下列主要的设设计任务计任务来安排编制内容。用来安排编制内容。用系统流程图系统流程图来表达软件系统的处理流程，即数据在来表达软件系统的处理流程，即数据在设定的系统中，各种物理构成元素之间设定的系统中，各种物理构成元素之间的流动状况。的流动状况。二二.概要设计说明书的内容要求概要设

16、计说明书的内容要求与编写指南与编写指南n用模块结构层次图来表达软件总体的模块结构组织，用模块结构层次图来表达软件总体的模块结构组织，模块结构一方面要表达系统功能模块的划分，另一方模块结构一方面要表达系统功能模块的划分，另一方面要表达模块之间的调用关系或者组成关系。在调用面要表达模块之间的调用关系或者组成关系。在调用关系中，上、下层的模块在实现时都将有对应的程序关系中，上、下层的模块在实现时都将有对应的程序段实体。而组成关系中，只是表达逻辑相关的一组下段实体。而组成关系中，只是表达逻辑相关的一组下层模块的集合关系，代表这个集合的上层模块没有对层模块的集合关系，代表这个集合的上层模块没有对应的程序

17、实体。结构图中应该用不同的符号代表这两应的程序实体。结构图中应该用不同的符号代表这两种不同的模块结构关系。种不同的模块结构关系。n用适当的图形和说明来表达存储数据结构的数据模型。用适当的图形和说明来表达存储数据结构的数据模型。设计的出发点是分析阶段得到的数据概念模型，据此设计的出发点是分析阶段得到的数据概念模型，据此设计出选定的支撑系统软件所允许的数据模型，如，设计出选定的支撑系统软件所允许的数据模型，如，文件的结构集合或者各种形式的数据库数据模型。文件的结构集合或者各种形式的数据库数据模型。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n概要设计说明书一般包括引言

18、、总体设概要设计说明书一般包括引言、总体设计、接口设计、运行设计、系统数据结计、接口设计、运行设计、系统数据结构设计、系统出错处理设计等六部分。构设计、系统出错处理设计等六部分。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（一）引言（一）引言n引言说明概要设计说明书的编写目的、背景、定义，引言说明概要设计说明书的编写目的、背景、定义，列出参考资料。列出参考资料。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（1）“编写目的编写目的”部分说明编写这份概要设计说明

19、书的目的，部分说明编写这份概要设计说明书的目的，指出预期的读者。指出预期的读者。n（2）“背景背景”用以说明待开发软件系统的名称用以说明待开发软件系统的名称; 列出此项目的任列出此项目的任务提出者、开发者、用户以及将运行该软件的计算站（中心）。务提出者、开发者、用户以及将运行该软件的计算站（中心）。n（3）“符号和缩略语的定义符号和缩略语的定义”列出本文件中用到的专门术语的列出本文件中用到的专门术语的定义和外文首字母组词的原词组。定义和外文首字母组词的原词组。n引言的最后列出有关的参考文件，如引言的最后列出有关的参考文件，如:n 本项目的经核准的计划任务书或合同、上级机关的批文。本项目的经核准

20、的计划任务书或合同、上级机关的批文。n 属于本项目的其他已发表文件。属于本项目的其他已发表文件。n 本文件中各处引用的文件、资料，包括所要用到的软件开发标本文件中各处引用的文件、资料，包括所要用到的软件开发标准。列出这些文件的标题、文件编号、发表日期和出版单位，说准。列出这些文件的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。明能够得到这些文件资料的来源。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（二）总体设计（二）总体设计n在概要设计说明书的总体设计部分，要在概要设计说明书的总体设计部分，要说明系统的需求规定、运行环境、基本说明系统的需

21、求规定、运行环境、基本设计概念和处理流程、模块结构等。设计概念和处理流程、模块结构等。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n在需求规定中，说明对本系统的主要的输入、输出、在需求规定中，说明对本系统的主要的输入、输出、处理的功能性能要求。见需求说明书的有关章节。处理的功能性能要求。见需求说明书的有关章节。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n2. 运行环境运行环境n将运行环境形成为一个文档，序号为将运行环境形成为一个文档，序号为S2 - 2。n在运行环境中，简要地说明对本系统的运行环境（包在运行环境中，简要地说明对本系统

22、的运行环境（包括硬件环境和支持环境）的规定。括硬件环境和支持环境）的规定。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n3. 基本设计概念和处理流程基本设计概念和处理流程n基本设计概念和处理流程，说明本系统的基本基本设计概念和处理流程，说明本系统的基本设计概念和处理流程，尽量使用图表的形式。设计概念和处理流程，尽量使用图表的形式。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n4. 概要设计模块结构图与描述表概要设计模块结构图与描述表n这部分包括三种图表这部分包括三种图表: 模块结构图、模块描述表及功能模块结构图、模块描述表及功能需求需

23、求- 模块关系表。模块关系表。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n模块结构图用框图的形式说明本系统的系统元素模块结构图用框图的形式说明本系统的系统元素（各层模块、子程序、公用程序等）得划分，分层次（各层模块、子程序、公用程序等）得划分，分层次地给出各元素之间的控制与被控制关系。地给出各元素之间的控制与被控制关系。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n 模块描述表说明模块的启动条件、输入、输出及功模块描述表说明模块的启动条件、输入、输出及功能。模块描述表设计为如下格式能。模块描述表设计为如下格式:二二.概要设计说明书的

24、内容要求概要设计说明书的内容要求与编写指南与编写指南n 功能需求功能需求- 模块关系表说明功能需求与程序的关系，模块关系表说明功能需求与程序的关系，用一张如下的矩阵图说明各项功能需求的实现同各块用一张如下的矩阵图说明各项功能需求的实现同各块程序的分配关系程序的分配关系:n模块结构图可能有多个，每个模块结构图都应该有相模块结构图可能有多个，每个模块结构图都应该有相应的模块描述表及功能需求应的模块描述表及功能需求- 模块关系表。模块关系表。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（三）接口设计（三）接口设计n在接口设计中，要说明用户接口、外部接口和内部接在接口设

25、计中，要说明用户接口、外部接口和内部接口等。口等。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n 用户接口，说明将向用户提供的命令和它用户接口，说明将向用户提供的命令和它们的语法结构以及软件的回答信息。们的语法结构以及软件的回答信息。n 外部接口，说明本系统同外界的所有接口外部接口，说明本系统同外界的所有接口的安排，包括软件与硬件之间的接口、本系统的安排，包括软件与硬件之间的接口、本系统与各支持软件之间的接口关系。与各支持软件之间的接口关系。n 内部接口，说明本系统之内的各个系统元内部接口，说明本系统之内的各个系统元素之间接口的安排。素之间接口的安排。二二.概要设

26、计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（四）系统数据结构设计（四）系统数据结构设计n用数据结构图、数据结构描述表、数据结构用数据结构图、数据结构描述表、数据结构- 模块关模块关系表这三种表来表示数据结构设计。系表这三种表来表示数据结构设计。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n数据结构描述表数据结构描述表的表头如下，在其中要说明被描述的的表头如下，在其中要说明被描述的数据结构隶属于哪个数据结构图。数据结构隶属于哪个数据结构图。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n对应于一张数据结构图，可能有多

27、张数据结构描述表，对应于一张数据结构图，可能有多张数据结构描述表，具体的数据结构描述表设计为如下格式，其中要说明具体的数据结构描述表设计为如下格式，其中要说明数据结构的类型、组成元素（序号、名称、标识符、数据结构的类型、组成元素（序号、名称、标识符、类型、长度等）。类型、长度等）。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n数据结构与模块关系表，说明各个数据结构与访问这数据结构与模块关系表，说明各个数据结构与访问这些数据结构的形式，访问方式为创建、插入、读取、些数据结构的形式，访问方式为创建、插入、读取、更新、这样就形成了数据结构与模块的矩阵。更新、这样就形成了

28、数据结构与模块的矩阵。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（五）运行设计（五）运行设计n在运行设计中，要说明运行模块组合、运行控制、运在运行设计中，要说明运行模块组合、运行控制、运行时间。行时间。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（1）运行模块组合。说明对系统施加不）运行模块组合。说明对系统施加不同的外界运行控制时，所引起的各种不同的外界运行控制时，所引起的各种不同的运行模块组合，说明每种运行所历同的运行模块组合，说明每种运行所历经的内部模块和支持软件。经的内部模块和支持软件。n（2）运行控制。说明每一种外界的运

29、行）运行控制。说明每一种外界的运行控制的方式方法和操作步骤。控制的方式方法和操作步骤。n（3）运行时间。说明每种运行模块组合）运行时间。说明每种运行模块组合将占用各种资源的时间。将占用各种资源的时间。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n（六）系统出错处理与安全保密维护设计（六）系统出错处理与安全保密维护设计二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n1.出错信息。用列表的方式说明每种可能的故障情况出现时，系出错信息。用列表的方式说明每种可能的故障情况出现时，系统输出信息的形式、含义及处理方法。统输出信息的形式、含义及处理方

30、法。n2.补救措施。说明故障出现后可能采取的变通措施，包括补救措施。说明故障出现后可能采取的变通措施，包括:n 后备技术，说明准备采用的后备技术，当原始系统数据万一丢后备技术，说明准备采用的后备技术，当原始系统数据万一丢失时，启用副本的建立和启动技术，例如，周期性地把磁盘信息失时，启用副本的建立和启动技术，例如，周期性地把磁盘信息记录到磁带上去就是对于磁盘媒体的一种后备技术。记录到磁带上去就是对于磁盘媒体的一种后备技术。n 降效技术，说明准备采用的后备技术，使用另一个效率稍低的降效技术，说明准备采用的后备技术，使用另一个效率稍低的系统或方法来求得所需结果的某些部分，例如，一个自动系统的系统或方法来求得所需结果的某些部分，例如，一个自动系统的降效技术可以是手工操作和数据的人工记录。降效技术可以是手工操作和数据的人工记录。n 恢复及再启动技术，说明将使用的恢复及再启动技术，使软件恢复及再启动技术，说明将使用的恢复及再启动技术，使软件从故障点恢复执行或使软件从头开始重新运行的方法。从故障点恢复执行或使软件从头开始重新运行的方法。二二.概要设计说明书的内容要求概要设计说明书的内容要求与编写指南与编写指南n3.安全保密设