《概要设计说明书》编写指南.docxVIP

《概要设计说明书》编写参考指南 1导言 本章对该文档的目的、功能范围、术语、相关文档、参考资料、版本更新进行说明。 1目的 本文档的目的旨在推动软件工程的规范化，使设计人员遵循统一的概要设计书写规范， 节省制作文档的时间， 降低系统实现的风险， 做到系统设计资料的规范性与全面性， 以利于 系统的实现、测试、维护、版本升级等。 1 . 2范围 本文档用于软件设计阶段的概要设计，它的上游是《需求分析规格书》 ，下游是《详细 设计说明书》，并为《详细设计说明书》提供测试的依据。 软件概要设计的范围是：软件系统总体结构设计、全局数据库和数据结构设计、外部接 口设计、主要部件功能分配设计、部件之间的接口设计等方面的内容。 该范围应覆盖《需求 规格说明书》中的功能点列表、性能点列表、接口列表。 1 . 3命名规则 变量对象命名规则：申明全局变量、局部变量对象的命名规则。 数据库对象命名规则：申明数据库表名、字段名、索引名、视图名等对象的命名规则。 1 . 4术语定义 术语定义或解释一般用表格形式给出，如表 1所示。 表1术语定义或解释表 序号 术语名称 术语定义 1 总体结构 软件系统的总体逻辑结构。为一树形的功能模块结构图。 2 外部接口 本软件系统与其他软件系统之间的接口， 接口设施可以是中间件。 接 口描述包括：传输方式、带宽、数据结构、传输频率、传输量、传输 协议 3 数据结构 数据结构包括：数据库表的结构、其他数据结构等 4 概念数据 模型CDM 关系数据库的逻辑设计模型，叫做概念数据模型；主要内容包括一张 逻辑E-R图及其相应的数据字典 5 物理数据 模型PDM 关系数据库的物理设计模型，叫做物理数据模型。主要内容包括一张 物理表关系图及其相应的数据字典  6 视图 在基表或其他视图之上建立的一张虚表， 叫做视图，它具有物理表的 许多性质，在数据处理和授权上很有用 7 角色 数据库中享有某些特权操作的用户， 叫做角色。角色的权利通过授权 来实现 8 子系统 具有相对独立功能的小系统叫做子系统； 一个大的软件系统可以划分 为多个子系统，每个子系统可由多个模块或多个部件组成 9 模块 具有功能独立、能被调用的信息单元叫做模块。 10 内部接口 软件系统内部各子系统之间、 各部件之间、各模板之间的接口，叫做 内部接口。接口描述包括：调用方式、入口信息、出口信息等 11 相关文件 指当本文件内容变更后， 可能引起变更的其他文件。 如需求分析报告、 计细设计说明书、测试计划、用户手册 12 参考资料 指本文件书写时用到的其他资料。如各种有关规范、模板、标准、准 则 需求规格说明书 软件开发合同 数据库设计规范 命名规范 1 . 6相关文档 《详细设计说明书》 源程序清单 测试计划及报告 《用户使用手册》 1 . 7版本更新记录 版本更新记录格式，如表 2所示。 表2版本更新记录 版本号 创建者 创建日期 维护者 维护日期 维护纪要 ?总体设计 2.1总体结构设计 软件系统的总体逻辑结构， 按照不同的设计方法， 有不同的总体逻辑结构。 对于结构化 设计方法，画出系统总体结构图，列出系统的功能模块清单编号、名称、功能，并尽可能描 绘出功能能模块之间的关系。 总体结构示意图，如图 1所示(也可画成竖向的) 图i总体结构示意图 2 . 2运行环境设计 该软件系统的运行环境： 硬件平台： 服务器的最低配置要求 工作站的最低配置要求 外设的要求 软件平台： 服务器操作系统 数据库管理系统 中间件 客户端的操作系统 客户端的平台软件 网络平台： 通信协议 通信带宽 3子系统清单 子系统清单，如表3所示 表3子系统清单 子系统编号 子系统英文名 子系统功能简述 子系统之间的关系 SS1 SS2 SS3 2. 4功能模块清单 功能模块清单，如表 4所示 表4功能模块清单 模块编号 模块英文名 模块功能简述 模块的接口简述 M1-1 M1-2 M2-1 ?模块功能分配 具有功能独立，能被调用的信息单元叫做模块。 模块是结构化设计中的概念， 模块功能 分配的目的，就是为了将具有相同功能的模块合并，从中提取公用模块，形成公用部件，按 照构件或中间件的方式加以实现，作为本系统的公用资源，甚至作为公司级组织的公用资源， 从而充实公司级的构件库或中间件库，优化系统设计，加快开发速度，提高开发质量。 1专用模块功能分配 专用模块功能分配，如表 5所示。 表5专用模块功能分配 专业模块编号 模块英文名 模块详细功能分配 模块的接口标准 M1-1 M1-2 M2-1 3. 2公用模块功能分配 公用模块功能分配，如表 6所示: 表6公用模块功能分配 公用模块编号 模块英文名 模块详细功能分配 模块的接口标准 G-1 G-2 G-3 ?数据结构设计 4 ? 1数据库表名清单