软件概要设计报告文档模板
1. 引言 ..............................................................................................................................................................2 1.1 编写目的 ...............................................................................................................................................2 1.2 项目风险 ...............................................................................................................................................2 1.3 预期读者和阅读建议.........................................................................................................................2 1.4 参考资料 ...............................................................................................................................................2 2. 设计概述 .....................................................................................................................................................3 2.1 限制和约束 ..........................................................................................................................................3 2.2 设计原则和设计要求.........................................................................................................................3 3. 系统逻辑设计 ............................................................................................................................................4 3.1 系统组织设计 ......................................................................................................................................4 3.2 系统结构设计 ......................................................................................................................................4
3.2.1 系统特性表 ........................................................................................ 5 3.2.2 系统特性结构图 ................................................................................. 6
3.3 系统接口设计 ......................................................................................................................................6
3.3.1 系统接口表 ........................................................................................ 6 3.3.2 系统接口传输协议说明 ....................................................................... 7
3.4 系统完整性设计..................................................................................................................................7
4. 系统出错处理设计 ...................................................................................................................................8 4.1 系统出错处理表..................................................................................................................................8 4.2 维护处理过程表..................................................................................................................................9 5. 技术设计 ...................................................................................................................................................10 5.1 系统开发技术说明表.......................................................................................................................10 5.2 开发技术应用说明 ...........................................................................................................................11 6. 数据库设计...............................................................................................................................................11 7. 词汇表........................................................................................................................................................11 8. 进度计划 ...................................................................................................................................................11
1. 引言
引言是对这份软件系统概要设计报告的概览,是为了帮助阅读者了解这份文档是如何编写的,并且应该如何阅读、理解和解释这份文档。
1.1 编写目的
说明这份软件系统概要设计报告是基于哪份软件产品需求规格说明书编写的,开发这个软件产品意义、作用、以及最终要达到的意图。通过这份软件系统概要设计报告详尽说明了该软件产品的软件结构,包括数据库结构和出错处理,从而对该软件产品的结构的描述。 如果这份软件系统概要设计报告只与整个系统的某一部分有关系,那么只定义软件系统概要设计报告中说明的那个部分或子系统。
1.2 项目风险
具体说明本软件开发项目的全部风险承担者,以及各自在本阶段所需要承担的主要风险,首要风险承担者包括:
● 任务提出者; ● 软件开发者; ● 产品使用者。
1.3 预期读者和阅读建议
列举本软件系统概要设计报告所针对的各种不同的预期读者,例如,可能的读者包括: ● 用户;
● 开发人员; ● 项目经理; ● 营销人员; ● 测试人员;
● 文档编写人员; ● 等等。
描述文档中,其余部分的内容及其组织结构,并且针对每一类读者提出最适合的文档阅读建议。
1.4 参考资料
列举编写软件产品概要设计报告时所用到的参考文献及资料,可能包括: ● 本项目的合同书;
● 上级机关有关本项目的批文; ● 本项目已经批准的计划任务书; ● 用户界面风格指导;
● 开发本项目时所要用到的标准;
● 系统规格需求说明; ● 使用实例文档;
● 属于本项目的其它已发表文件;
● 本软件系统概要设计报告中所引用的文件、资料: ● 相关软件系统概要设计报告: ● 等等。
为了方便读者查阅,所有参考资料应该按一定顺排列。如果可能,每份资料都应该给出: ● 标题名称;
● 作者或者合同签约者; ● 文件编号或者版本号; ● 发表日期或者签约日期; ● 出版单位或者资料来源。
2. 设计概述
本节描述现有开发条件和需要实现的目标,说明进行概要设计时应该遵循的设计原则和必须采用的设计方法。
2.1 限制和约束
简要描述起到限制和约束作用的各种可能存在的条件,例如: ● 技术条件;
● 资金状况;
● 开发环境(包括:工具和平台);
● 时间限制; ● 等等。
并且说明在上述条件下,应该实现的系统目标,
2.2 设计原则和设计要求
描述对本软件系统进行概要设计的原则,通常可以考虑以下几方面的内容: ● 命名规则; ● 模块独立性原则: ● 边界设计原则; ● 数据库设计规则; ● 必须的安全措施; ● 安全性和保密原则; ● 系统灵活性要求; ● 系统易操作性要求; ● 系统可维护性要求; ● 等等。
3. 系统逻辑设计
本节内容主要根据软件产品需求规格说明书和软件产品数据字典建立系统的逻辑模型。此种模型暂时与系统的物理因素(例如:计算机、数据库管理系统)无关。它是系统需求与物理实现的中间结构,它的主要结果是建立:系统结构图、系统界面结构图、系统出错处理、以及系统开发技术说明。
说明:如果进行系统设计时尚未编写软件数据字典:应首先参照附录B说明,编写软件数据字典。在完成软件数据字典后,再进行系统设计。
3.1 系统组织设计
系统组织设计通过系统组织表描述本系统由哪些子系统(模块)组成,这些子系统与业务职能之间的关系,以及各个子系统的安装地点。系统组织表的格式如下: 子系统编号 其中: 英文名称 中文名称 业务职能 安装地点 备注 ● 子系统编号
给出本系统中指定子系统的顺序编号。如果本系统末划分为多个子系统,仅由一
个运行模块组成;则本项内容仍需要描述,但是本表内容只有一行。
说明:在一个系统中有可能安装若干个相同的子系统,在这种情况下,应该视为 一个子系统,并且对多个安装地点分别进行描述。如果相同的子系统通过系统设 置,实现的业务职能具有明显差异时,应该采用多行进行分别描述,并且在备注 中说明其差异所在。
● 子系统英文名称
给出本子系统的英文名称,该名称是在应用软件中实际使用的可执行文件名称,
必须能够说明该子系统的特点。
若本系统中只有一个子系统,则本项内容仍需要描述,但是本表内容只有一行。 ● 子系统中文名称
给出本子系统的中文名称,该名称必须能够说明该子系统的特点。
若本系统中只有一个子系统,则本项内容仍需要描述,但是本表内容只有一行。 ● 业务职能
描述该子系统完成的核心业务。 ● 安装地点
描述该子系统实际安装的部门、或者某个具体地点。 ● 备注
针对该子系统,需要说明的其它有关问题。
3.2 系统结构设计
本节将对系统特性作较为详细的描述,并给出系统特性结构图。
3.2.1 系统特性表
系统特性是系统中完成某项具体操作的基本单元,它由入口参数,出口参数以及处理过程三部分组成。
系统特性可以具有操作界面,也可以没有操作界面;可以被其它操作界面、或者系统特性调用,也可以调用其它操作界面、非操作界面、或者系统特性;但是不允许递归调用(调用自己),包括间接递归调用。
当系统由多个子系统(模块)组成时,每个子系统分别使用一张系统特性表进行描述。系统特性表的格式如下: 子系统编号: 子系统英文名称: 子系统中文名称: 特性编号 说明: 其中 ● 子系统编号 含义同上。 ● 子系统英文名称 含义同上。 ● 子系统中文名称
含义同上。
● 特性编号
整个系统所有特性的统一编号。
● 系统特性英文名称
系统特性的英文正式名称,将来用于软件开发中,必须符合命名规范。 ● 系统特性中文名称
系统特性的中文正式名称,来源于需求规格说明书中,系统特性一节中的有关描 述。 ● 操作功能
是指该特性实际完成的操作说明。
● 调用对象
是指调用该系统特性的系统对象,这里的系统对象可以是系统特性、也可以是操作界面。 ● 被调用对象
是指被该系统特性调用的系统对象,这里的系统对象可以是系统特性、也可以是操作界面。
说明:某些较低层的系统特性,可能不存在被调用对象。 ● 备注
描述与该系统特性有关的其它注意事项。 ● 说明
描述与该系统特性表有关的其它注意事项。
系统特征 英文名称 系统特征 中文名称 操作功能 调用对象 被调用 对象 备注