软工概要设计

附 录 E

概要设计说明书的编写提示

（参考件）

E.1 引言

E.1.1 编写目的

说明编写这份概要设计说明书的目的，指出预期的读者。

E.1.2 背景

说明：

a. 待开发软件系统的名称；

b. 列出此项目的任务提出者、开发者、用户以及将运行该软件的计算站（中心）。

E.1.3 定义

列出本文件中用到的专门术语的定义和外文首字母组词的原词组。

E.1.4 参考资料

列出有关的参考文件，如：

a. 本项目的经核准的计划任务书或合同，上级机关的批文；

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

c. 本文件中各处引用的文件、资料，包括所要用到的软件开发标准。

列出这些文件的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。

E.2 总体设计

E.2.1 需求规定

说明对本系统的主要的输入输出项目、处理的功能性能要求，详细的说明可参见附录C。

E2.2 运行环境

简要地说明对本系统的运行环境（包括硬件环境和支持环境）的规定，详细说明参见附录C。

E2.3 基本设计概念和处理流程

说明本系统的基本设计概念和处理流程，尽量使用图表的形式。

E.2.4 结构

用一览表及框图的形式说明本系统的系统元素（各层模块、子程序、公用程序等）的划分，扼要说明每个系统元素的标识符和功能，分层次地给出各元素之间的控制与被控制关系。

E.2.5 功能需求与程序的关系

本条用一张如下的矩阵图说明各项功能需求的实现同各块程序的分配关系：

程序1 程序2 …… 程序m

功能需求1 √

功能需求2 √

功能需求 √ √

E.2.6 人工处理过程

说明在本软件系统的工作过程中不得不包含的人工处理过程（如果有的话）。

E.2.7 尚未解决的问题

说明在概要设计过程中尚未解决而设计者认为在系统完成之前必须解决的各个问题。

E.3 接口设计

E.3.1 用户接口

说明将向用户提供的命令和它们的语法结构，以及软件的回答信息。

E.3.2 外部接口

说明本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各支持软件之间的接口关系。

E.3.3 内部接口

说明本系统之内的各个系统元素之间的接口的安排。

E.4 运行设计

E.4.1 运行模块组合

说明对系统施加不同的外界运行控制时所引起的各种不同的运行模块组合，说明每种运行所历经的内部模块和支持软件。

E.4.2 运行控制

说明每一种外界的运行控制的方式方法和操作步骤。

E.4.3 运行时间

说明每种运行模块组合将占用各种资源的时间。

E.5 系统数据结构设计

E.5.1 逻辑结构设计要点

给出本系统内所要使用的每个数据结构的名称、标识符以及它们之中每个数据项、记录、文卷和系的标识、定义、长度及它们之间的层次的或表格的相互关系。

E.5.2 物理结构设计要点

给出本系统内所使用的每个数据结构中的每个数据项的存储要求，访问方法、存取单位、存取的物理关系（索引、设备、存储区域）、设计考虑和保密条件。

E.5.3 数据结构与程序的关系

说明各个数据结构与访问这些数据结构的各个程序之间的对应关系，可采用如下的矩阵图形式：

程序1 程序2 …… 程序m

功能需求1 √

功能需求2 √ √

功能需求 √ √

E.6 系统出错处理设计

E.6.1 出错信息

用一览表的方式说明每种可能的出错或故障情况出现时，系统输出信息的形式、含意及处理方法。

E.6.2 补救措施

说明故障出现后可能采取变通措施，包括：

a. 后备技术 说明准备采用的后备技术，当原始系统数据数据万一丢失时启用的副本的建立和启动的技术，例如周期性地把磁盘信息记录到磁带上去就是对于磁盘媒体的一种后备技术；

b. 降效技术 说明准备采用的后备技术，使用另一个效率稍低的系统或方法来求得所需结果的某些部分，例如一个自动系统的降效技术可以是手工操作和数据的人工记录；

E.6.3 系统维护设计

说明为了系统维护的方便而在程序内部设计中作出的安排，包括在程序中专门安排用于系统的检查与维护的检测点和专用模块。