GB 8567-88软件开发主要文档编写规范
本附录中列出了《计算机软件产品开发文件编制指南》GB 8567-88中主要软件文档的编写说明,供编写时参考。这些文档主要是:可行性研究报告、项目开发计划、软件需求说明书、概要设计说明书、详细设计说明书、模块开发卷宗、测试计划、测试分析报告、项目开发总结报告。
一、可行性研究报告
l 引言
1.1 编写目的
说明:说明本可行性研究报告的编写目的,指出预期的读者。 1.2 背景 说明:
a.所建议开发的软件系统的名称。
b.本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络。 c.该软件系统同其他系统或其他机构的基本的相互来往关系。 1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资料
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属干本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所需用到的软件开发标准。
列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 可行性研究的前提
说明对建议开发项目进行可行性研究的前提,如要求、目标、条件、假定和限制等。 2.1 要求
说明对所建议开发软件的基本要求,如: a.功能。 b.性能。
c.输出如报告、文件或数据,对每项输出要说明其特征,如用途、产生频度、接口以及分发对象。
d. 输入说明。系统的输入包括数据的来源、类型、数量、数据的组织以及提供的频度。
e.处理流程和数据流程。用图表的方式表示出最基本的数据流程和处理流程,并输之以叙述。
f. 在安全与保密方面的要求。 g. 同本系统相连接的其他系统。 h. 完成期限。
231 2.2 目标
说明所建议系统的主要开发目标,如: a. 人力与设备费用的减少。 b. 处理速度的提高。
c. 控制精度或生产能力的提高。
第3章 软 件 设 计
d.管理信息服务的改进。 e. 自动决策系统的改进。 f. 人员利用率的改进。 2.3 条件、假定和限制
说明对这项开发中给出的条件、假定和所受到的限制,如 a. 所建议系统的运行寿命的最小值。 b. 进行系统方案选择比较的时间。 c. 经费、投资方面的来源和限制。 d. 法津和政策方面的限制。
e. 硬件、软件、运行环境和开发环境方面的条件和限制。 f. 可利用的信息和资源。 g. 系统投入使用的最晚时间。 2.4 进行可行性研究的方法
说明这项可行性研究将是如何进行的,所建议的系统将是如何评价的。摘要说明所使用的基本方法和策略,如调查、加权、确定模型、建立基准点或仿真等。
2.5 评价尺度
说明对系统进行评价时所使用的主要尺度.如费用的多少、各项功能的优先次序、开发时间的长短及使用中的难易程度。
3 对现有系统的分析
这里的现有系统是指当前实际使用的系统。这个系统可能是计算机系统,也可能是一个机械系统甚至是一个人工系统。
分析现有系统的目的是为了进一步阐明建议中的开发新系统或修改现有系统的必要性。 3.l 处理流程和数据流程
说明现有系统的基本处理流程和数据流程。此流程可用图表即流程图的形式表示,并加以叙述。
3.2 工作负荷
列出现有系统所承担的工作及工作量。 3.3 费用开支
列出由于运行现有系统所引起的费用开支,如人力、设备、空间、支持性服务、材料等项开支以及开支总额。
3.4 人员
列出为了现有系统的运行和维护所需要的人员的专业技术类别和数量。 3.5 设备
列出现有系统所使用的各种设备。 3.6 局限性
列出本系统的主要的局限性,例如处理时间赶不上需要,响应不及时,数据存储能力不足。处理功能不够等。并且要说明,为什么对现有系统的改进维护已经不能解决问题。
4 所建议的系统
本章将用来说明所建议系统的目标和要求将如何被满足。 4.l 对所建议系统的说明 232 概括地说明所建议系统,并说明在第2节中列出的那些要求将如何得到满足,说明所使用的基本方法及理论根据。
4.2 处理流程和数据流程
给出所建议系统的处理流程和数据流程
第3章 软 件 设 计
4.3 改进之处
按2节中列出的目标,逐项说明所建议系统相对于现存系统具有的改进。 4.4 影响
说明在建立所建议系统时,预期将带来的影响,包括:
4.4.1 对设备的影响
说明新提出的设备要求及对现存系统中尚可使用的设备需作的修改。 4.4.2 对软件的影响
说明为了使现存的应用软件和支持软件能够同所建议系统相适应。而需要对这些软件所进行的修改和补充。
4.4.3 对用户单位机构的影响 说明为了建立和运行所建议系统,对用户单位机构、人员的数量和技术水平等方面的全部要求。
4.4.4 对系统运行过程的影响
说明所建议系统对运行过程的影响,如: a.用户的操作规程。 b. 运行中心的操作规程。
c. 运行中心与用户之间的关系。 d. 源数据的处理。
e. 数据进入系统的过程。
f. 对数据保存的要求,对数据存储、恢复的处理。 g. 输出报告的处理过程、存储媒体和调度方法。 h. 系统失效的后果及恢复的处理办法。
4.4.5 对开发的影响 说明对开发的影响,如:
a. 为了支持所建议系统的开发用户需进行的工作。 b. 为了建立一个数据库所要求的数据资源。
c. 为了开发和测验所建议系统而需要的计算机资源。 d. 所涉及的保密与安全问题。
4.4.6 对地点和设施的影响
说明对建筑物改造的要求及对环境设施的要求。
4.4.7 对经费开支的影响
扼要说明为了所建议系统的开发,设计和维持运行而需要的各项经费开支。 4.5 局限性
说明所建议系统尚存在的局限性以及这些问题未能消除的原因。 4.6 技术条件方面的可行性
本节应说明技术条件方面的可行性,如:
a.在当前的限制条件下,该系统的功能目标能否达到。 b. 利用现有的技术,该系统的功能能否实现。
c. 对开发人员的数量和质量的要求并说明这些要求能否满足。 d. 在规定的期限内,本系统的开发能否完成。 233 5 可选择的其他系统方案
扼要说明曾考虑过的每一种可选择的系统方案,包括需开发的和从国内国外直接购买的,如果没有供选择的系统方案可考虑,则说明这一点。
5.1 可选择的系统方案1
第3章 软 件 设 计
参照第 4节的提纲说明可选择的系统方案 1,并说明它未被选中的理由。 5.2 可选择的系统方案2
按类似5.1条的方式说明第2个乃至第N个可选择的系统方案。 6 投资及效益分析 6.1 支出
对于所选择的方案,说明所需的费用。如果已有一个现存系统,则包括该系统继续运行期间所需的费用。
6.l.1 基本建设投资
包括采购、开发和安装下列各项所需的费用,如: a. 房屋和设施。 b. ADP设备。
c. 数据通讯设备。 d. 环境保护设备。 e. 安全与保密设备。
f.ADP操作系统和应用的软件。 g. 数据库管理软件。 6.1.2 其他一次性支出 包括下列各项所需的费用,如: a. 研究(需求的研究和设计的研究)。 b. 开发计划与测量基准的研究。 c. 数掘库的建立。 d. ADP软件的转换。
e. 检查费用和技术管理性费用。
f. 培训费、旅差费以及开发安装人员所需要的一次性支出。 g. 人员的退休及调动费用等。
6.1.3 非一次性支出
列出在该系统生命期内按月或按季或按年支出的用于运行和维护的费用,包括: a. 设备的租金和维护费用。 b. 软件的租金和维护费用。
c. 数据通讯方面的租金和维护费用。 d. 人员的工资、奖全。 e. 房屋、空间的使用开支。 f. 公用设施方面的开支。 g. 保密安全方面的开支。 h. 其他经常性的支出等。 6.2 收益
对于所选择的方案,说明能够带来的收益,这里所说的收益,表现为开支费用的减少或避免、差错的减少、灵活性的增加、动作速度的提高和管理计划方面的改进等,包括:
6.2.1 一次性收益
说明能够用人民币数目表示的一次性收益,可按数据处理、用户、管理和支234 持等项分类叙述,如:
a. 开支的缩减包括改进了的系统的运行所引起的开支缩减,如资源要求的减少,运行效率的改进,数据进入、存贮和恢复技术的改进,系统性能的可监控,软件的转换和优化,数据压缩技术的采用,处理的集中化/分布化等。
第3章 软 件 设 计
b. 价值的增升包括由于一个应用系统的使用价值的增升所引起的收益,如资源利用的改进.管理和运行效率的改进以及出错率的减少等。
c.其他如从多余设备出售回收的收入等。
6.2.2 非一次胜收益
说明在整个系统生命期内由于运行所建议系统而导致的按月的、按年的能用人民币数目表示的收益,包括开支的减少和避免。
6.2.3 不可定量的收益
逐项列出无法直接用人民币表示的收益,如服务的改进,由操作失误引起的凤险的减少,信息掌握情况的改进,组织机构给外界形象的改善等。有些不可捉摸的收益只能大概估计或进行极值估计(按最好和最差情况估计)。
6.3 收益/投资比
求出整个系统生命期的收益/投资比值。 6.4 投资回收周期
求出收益的累计数开始超过支出的累计数的时间。 6.5 敏感性分析
所谓敏感性分析是指一些关键性因素如系统生命期长度、系统的工作负荷量、工作负荷的类型与这些不同类型之间的合理搭配、处理速度要求、设备和软件的配置等变化时,对开支和收益的影响最灵敏的范围的估计。在敏感性分析的基础上做出的选择当然会比单一选择的结果要好一些。
7 社会因素方面的可行性
本节用来说明对社会因素方面的可行性分析的结果,包括: 7.l 法律方面的可行性
法律方面的可行性问题增多,如合同责任、侵犯专利权、侵犯版权等方面的陷阱,软件人员通常是不熟悉的,有可能陷入,务必要注意研究。
7.2 使用方面的可行性
例如从用户单位的行政管理、工作制度等方面来看,是否能够使用该软件系统;从用户单位的工作人员的素质来看,是否能满足使用该软件系统的要求等等,都是要考虑。
8 结论
在进行可行性研究报告的编制时,必须有一个研究的结论。结论可以是: a.可以立即开始进行。
b.需要推迟到某些条件(例如资金、人力、设备等)落实之后才能开始进行。 c. 需要对开发目标进行某些修改之后才能开始进行。
d.不能进行或不必进行(例如因技术不成熟、经济上不合算等)。
二、项目开发计划
l 引言
1.1 编写目的
说明编写这份项目开发计划的目的并指出预期的读者。 1.2 背景 说明: 235 a.待开发软件系统的名称。
b.本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络。 c. 该软件系统同其他系统或其他机构的基本的相互来往关系。 1.3 定义
第3章 软 件 设 计
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资斜
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属于本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2. 项目概述 2.1 工作内客
简要地说明在本项目的开发中需进行的各项主要工作。 2.2 主要参加人员
扼要说明参加本项目开发工作的主要人员的情况,包括他们的技术水平。 2.3 产品 2.3.1 程序
列出需移交给用户的程序的名称、所用的编程语言及存储程序的媒体形式。并通过引用有关文件,逐项说明其功能和能力。
2.3.2 文件
列出需移交给用户的每种文件的名称及内容要点。
2.3.3 服务
列出需向用户提供的各项服务。如培训安装、维护和运行支持等。应逐项规定开始日期、所提供支持的级别和服务的期限。
2.3.4 非移交的产品
说明开发集体应向本单位交出但不必向用户移交的产品(文件甚至某些程序)。 2.4 验收标准
对于上述这些应交出的产品和服务,逐项说明或引用资料说明验收标准。 2.5 完成项目的推迟期限
2.6 本计划的批准者和批准日期 3. 实施计划
3.1 工作任务的分工与人员分工
对于项目开发中需完成的各项工作,从需求分析、设计、实现、测试直到维护,包括文件的编制、审批、打印、分发工作,用户培训工作,软件安装工作等,按层次进行分解,指明每项任务的负责人和参加人员。
3.2 接口人员
说明负责接口工作的人员及他们的职责,包括: a.负责本项目同用户的接口人员。
b.负责本项目同本单位各管理机构,如合同计划管理部门、财务部门、质量管理部门等的接口人员。
c. 负责本项目同各分合同负责单位的接口人员等。 3.3 进度
对于需求分析、设计、编码实现、测试、移交、培训和安装等工作,给出每236 项工作任务的预定开始日期、完成日期及所需资源,规定各项工作任务完成的先后顺序以及表征每项工作任务完成的标志性事件(即所谓的“里程碑”)。
3.4 预算
逐项列出本开发项目所需要的劳务(包括人员的数量和时间)以及经费的预算(包括办
第3章 软 件 设 计
公费、差旅费、机时费、资料费、通讯设备和专用设备的租金等)和来源。
3.5 关健问题
逐项列出能够影响整个项目成败的关键问题、技术难点和风险,指出这些同题对项目的影响。
4. 支持条件
说明为支持本项目的开发所需要的各种条件和设施。 4.1 计算机系统支持
逐项列出开发中和运行时所需的计算机系统支持,包括计算机、外围设备、通讯设备、模拟器、编译(或汇编)程序、操作系统、数据管理程序包、数据存储能力和测试支持能力等,逐项列出有关到货日期、使用时间的要求。
4.2 需由用户承担的工作
逐项列出需要用户承担的工作和完成期限。包括需由用户提供的条件及提供时间。 4.3 由外单位提供的条件
逐项列出需要外单位分合同承包者承担的工作和完成的时间,包括需要由外单位提供的条件和提供的时间。
5. 专题计划要点
说明本项目开发中需制订的各个专题计划(如分合同计划、开发人员培训计划、测试计划、安全保密计划、质量保证计划、配置管理计划、用户培训计划、系统安装计划等〕的要点。
三、软件需求说明书
l 引言
1.1 编写目的
说明编写这份软件需求说明书的目的,指出预期的读者。 1.2 背景 说明:
a.待开发的软件系统的名称。
b. 本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络。 c.该软件系统同其他系统或其他机构的基本的相互来住关系。 1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资斜
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属于本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 任务概述 2.1 目标
叙述该项软件开发的意图、应用目标、作用范围以及其他应向读者说明的有237 关该软件开发的背景材料。解释被开发软件与其他有关软件之间的关系。如果本
软件产品是一项独立的软件,而且全部内容自含,则说明这一点。如果所定义的产品是一个更大的系统的一个组成部分,则应说明本产品与该系统中其他各组成部分之间的关系,为此可使用一张方框图来说明该系统的组成和本产品同其他各部分的联系和接口。
第3章 软 件 设 计
2.2 用户的特点
列出本软件的最终用户的特点,充分说明操作人员、维护人员的教育水平和技术专长,以及本软件的预期使用频度。这些是软件设计工作的重要约束。
2.3 假定和约束
列出进行本软件开发工作的假定和约束,例如经费限制、开发期限等。 3 需求规定
3.1 对功能的规定
用列表的方式(例如,IPO表即输入、处理、输出表的形式),逐项定量和定性地叙述对软件所提出的功能要求,说明输入什么量经怎样的处理、得到什么输出,说明软件应支持的终端数和应支持的并行操作的用户数。
3.2 对性能的规定 3.2.1 精度
说明对该软件的输入、输出数据精度的要求,可能包括传输过程中的精度。 3.2.2 时间特性要求
说明对于该软件的时间特性要求,如对: a. 响应时间。 b. 更新处理时间。
c. 数据的转换和传送时间。 d. 解题时间等的要求。 3.2.3 灵活性
说明对该软件的灵活性的要求,即当需求发生某些变化时,该软件对这些变化的适应能力,如:
a. 作方式上的变化。 b. 运行环境的变化。
c. 同其他软件的接口的变化。 d. 精度和有效时限的变化。 e.计划的变化或改进。
f. 对于为了提供这些灵活性而进行的专门设计的部分应该加以标明。 3.3 输入输出要求
解释各输入输出数据类型,并逐项说明其媒体、格式、数值范围、精度等。对软件的数据输出及必须标明的控制输出量进行解释并举例,包括对硬拷贝报告(正常结果输出、状态输出及异常输出)以及图形或显示报告的描述。
3.4 数据管理能力要求
说明需要管理的文卷和记录的个数、表和文卷的大小规模,要按可预见的增长对数据及其分量的存储要求做出估算。
3.5 故障处理要求
列出可能的软件、硬件故障以及对各项性能而言所产生的后果和对故障处理的要求。 3.6 其它专门要求
如用户单位对安全保密的要求,对使用方便的要求,对可维护性、可补充性、易读性、可靠性、运行环境可转换性的特殊要求等。 238
4 运行环境规定 4.l 设备
列出运行该软件所需要的硬设备。说明其中的新型设备及其专门功能,包括: a. 处理器型号及内存容量。
第3章 软 件 设 计
b. 外存容量、联机或脱机、媒体及其存储格式,设备的型号及数量。 c. 输入及输出设备的型号和数量,联机或脱机。 d. 数据通信设备的型号和数量。 e. 功能键及其他专用硬件。 4.2 支持软件
列出支持软件,包括要用到的操作系统、编译(或汇编)程序、测试支持软件等。 4.3 接口
说明该软件同其他软件之间的接口、数据通信协议等。 4.4 控制
说明控制该软件的运行的方法和控制信号.并说明这些控制信号的来源。 四、概要设计说明书
l 引言
1.1 编写目的
说明编写这份概要设计说明书的目的,指出预期的读者。 1.2 背景 说明:
a.待开发的软件系统的名称。
b. 本项目的任务提出者、开发者、用户及运行该软件的计算中心或计算机网络。 1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资斜
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属于本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 总体设计
2.1 需求规定
说明对本系统的主要的输入输出项目、处理的功能性能要求。 2.2 运行环境
简要说明对本系统的运行环境(包括硬件环境和支持环境)的规定。 2.3 基本设计概念和处理流程
说明本系统的基本设计概念和处理流程,尽量使用图表的形式。 2.4 结构
用一览表及框图的形式说明本系统的系统元素(各层模块、子程序、公用程序等)的划分,扼要说明每个系统元素的标识符和功能,分层次地给出各元素之间的控制与被控制关系。
2.5 功能需求与程序的关系
本条用一张如下的矩阵图说明各项功能需求的实现同各块程序的分配关系,如表2.1所示。 239
表2.1 各项功能需求功能的实现与各块程序的分配关系
功能需求 功能需求1 功能需求2 程序1 程序2 … 程序m √ √ 第3章 软 件 设 计
┇ √ √ 功能需求n 2.6 人工处理过程
说明在本软件系统的工作过程中不得不包含的人工处理过程(如果有的话)。 2.7 尚未解决的问题
说明概要设计过程中尚未解决而设计者认为在系统完成之前必须解决的各个问题。 3. 接口设计 3.1 用户接口
说明将向用户提供的命令和它们的语法结构,以及软件的回答信息。 3.2 外部接口
说明本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各支持软件之间的接口关系。
3.3 内部接口
说明本系统之内的各个系统元素之间的接口的安排。 4 运行设计
4.1 运行模块组合
说明对系统施加不同的外界运行控制时所引起的各种不同的运行模块组合,说明每种运行所历经的内部模块和支持软件。 4.2 运行控制
说明每一种外界的运行控制的方式方法和操作步骤。 4.3 运行时间
说明每种运行模块组合将占用各种资源的时间。 5 系统数据结构设计 5.1 逻辑结构设计要点
给出本系统内所使用的每个数据结构的名称、标识符以及它们之中每个数据项、记录、文卷和系的标识、定义、长度及它们之间的层次的或表格的相互关系。
5.2 物理结构设计要点
给出本系统内所使用的每个数据结构中的每个数据项的存储要求,访问方法、存取单位、存取的物理关系(索引、设备、存储区域)、设计考虑和保密条件。
5.3 数据结构与程序的关系
说明各个数据结构与访问这些数据结构的形式,如表2.2所示。
表2.2 各个数据结构与访问这些数据结构的形式
功能需求 数据结构1 数据结构2 ┇ 程序1 程序2 … 程序m √ √ √ 2310 数据结构n √ √ 6 系统出错处理设计 6.1 出错信息
用一览表的方式说明每种可能的出错或故障情况出现时,系统输出信息的形式、含意及
第3章 软 件 设 计
处理方法。
6.2 补救措施
说明故障出现后可能采取的变通措施,包括: a. 后备技术说明准备采用的后备技术,当原始系统数据万一丢失时启用的副本的建立和启动的技术,例如周期性地把磁盘信息记录到磁带上去就是对磁盘媒体的一种后备技术。 b. 降效技术说明准备采用的后备技术,使用另一个效率稍低的系统或方法来求得所需结果的某些部分,例如一个自动系统的降效技术可以是手工操作和数据的人工记录。 c. 恢复及再启动技术说明将使用的恢复再启动技术,使软件从故障点恢复执行或使软件从头开始重新运行的方法。
6.3 系统维护设计
说明为了系统维护的方便而在程序内部设计中作出的安排,包括在程序中专门安排用于系统的检查与维护的检测点和专用模块。各个程序之间的对应关系,可采用矩阵图的形式。
五、详细设计说明书
l 引言
1.1 编写目的
说明编写这份详细设计说明书的目的,指出预期的读者。 1.2 背景 说明:
a.待开发的软件系统的名称。
b. 本项目的任务提出者、开发者、用户及运行该软件的计算中心或计算机网络。 1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资斜
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属于本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 程序系统的结构
用一系列图表列出本程序系统内的每个程序(包括每个模块和子程序)的名称、标识符和它们之间的层次结构关系。
3 程序1(标识符)设计说明
从本条开始逐个地给出各个层次中的每个程序的设计说明。以下给出的提纲是针对一般情况的。对于一个具体的模块,尤其是层次比较低的模块或子程序,其很多条目的内容往往与它所隶属的上一层模块的对应条目的内容相同,在这种情况下,只要简单地说明这一点即可。
3.1 程序描述
给出对该程序的简单描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点。如:是常驻内存还是非常驻?是否子程序?有无覆盖要求?是顺序处2311 理还是并发处理等。
3.2 功能
说明该程序应具有的功能,可采用IPO图(即输入一处理一输出图)的形式。 3.3 性能
第3章 软 件 设 计
说明对该程序的全部性能要求,包括对精度、灵活性和时间特性的要求。 3.4 输入项
给出对每一个输入项的特性,包括名称、标识、数据的类型和格式、数据值的有效范围、输入的方式。数量和频度、输入媒体、输入数据的来源和安全保密条件等等。
3.5 输出项
给出对每一个输出项的特性,包括名称、标识、数据的类型和格式,数据值的有效范围、输出的方式。数量和频度、输出媒体、对输出图形及符号的说明、安全保密条件等。
3.6 算法
详细说明本程序所选用的算法,具体的计算公式和计算步骤。 3.7 流程逻辑
用图表(例如流程图、判定表等)辅以必要的说明来表示本程序的逻辑流程。 3.8 接口
用图的形式说明本程序所隶属的上一层模块及隶属于本程序的下一层模块、子程序,说明参数赋值和调用方式,说明与本程序相直接关联的数据结构(数据库、数据文卷)。
3.9 存储分配
根据需要,说明本程序的存储分配。 3.10 注释设计
说明准备在本程序中安排的注释,如: a. 加在模块首部的注释。
b. 加在各分枝点处的注释;对各变量的功能、范围、缺省条件等所加的注释。 c. 对使用的逻辑所加的注释等等。 3.11 限制条件
说明本程序运行中所受到的限制条件。 3.12 测试计划
说明对本程序进行单元测试的计划,包括对测试的技术要求、输入数据、预期结果、进度安排、人员职责、设备条件驱动程序及模块等的规定。
3.13 尚未解决的问题
说明在本程序的设计中尚末解决而设计者认为在软件完成之前应解决的问题。 4 程序2(标识符)设计说明
用类似3条的方式,说明第2个程序乃至第N个程序的设计考虑。
六、模块开发卷宗
1 标题
a. 软件系统名称和标识符。
b. 模块名称和标识符(如果本卷宗包含多于一个的模块,则用这组模块的功能标识代替模块名)。
c. 程序编制员签名。 d. 卷宗的修改文本序号。 e. 修改完成日期。
f.卷宗序号(说明本卷宗在整个卷宗中的序号)。 2312 g. 编排日期(说明整个卷宗最近的一次编排日期)。 2 模块开发情况表 3 功能说明
扼要说明本模块(或本组模块)的功能,主要是输入、要求的处理、输出。可以从系统
第3章 软 件 设 计
设计说明书中摘录。同时列出在软件需求说明书中对这些功能说明的章、条、款。 4 设计说明
说明本模块(或本组模块)的设计考虑,包括:
a.在系统设计说明书中有关对本模块(或本组模块)设计考虑的叙述,包括本模块在软件系统中所处的层次,它同其他模块的接口。
b. 在程序设计说明书中有关对本模块(或本组模块)的设计考虑,包括本模块的算法、处理流程、牵涉到的数据文卷设计限制、驱动方式和出错信息等。 c. 在编制目前已通过全部测试的源代码时实际使用的设计考虑。 5 原代玛清单
要给出所产生的本模块(或本组模块)的第一份无语法错的源代码清单以及已通过全部测试的当前有效的源代码清单。 6 测试说明
说明直接要经过本模块(或本组模块)的每一项测试,包括这些测试各自的标识符和编号、进行这些测试的目的、所用的配置和输入、预期的输出及实际的输出。 7 复审的结论
把实际测试的结果,同软件需求说明书、系统设计说明书、程序设计说明书中规定的要求进行比较和给出结论。
七、测试计划
l 引言
1.1 编写目的
本测试计划具体的编写目的,指出预期的读者。 1.2 背景 说明:
a. 测试计划所从属的软件系统的名称。
b. 该开发项目的历史,列出用户和执行此项目测试的计算中心,说明在开始执行本测试计划之前必须完成的各项工作。
1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资斜
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属于本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 计划
2.1 软件说明
提供一份图表,并逐项说明被测软件的功能、输入和输出等质量指标,作为叙述测试计划的提纲。
2.2 测试内容 2313 列出组装测试和确认测试中的每一项测试内容的名称标识符、这些测试的进
度安排以及这些测试的内容和目的。例如,模块功能测试、接口正确性测试、数据文卷存取的测试、运行时间的测试、设计约束和极限的测试等。
2.3 测试1(标识符)
第3章 软 件 设 计
给出这项测试内容的参与单位及被测试的部位。
2.3.1 进度安排
给出对这项测试的进度安排,包括进行测试的日期和工作内容。如:熟悉环境、培训、准备输入数据等。
2.3.2 条件
陈述本项测试工作对资源的要求,包括:
a.设备所用到的设备类型、数量和预定使用时间。
b.软件列出将被用来支持本项测试过程而本身又并不是被测软件的组成部分的软件。如测试驱动程序、测试监控程序、仿真程序、桩模块等等。
c. 人员列出在测试工作期间预期可由用户和开发任务组提供的工作人员的人数。技术水平及有关的预备知识,包括一些特殊要求,如倒班操作和数据键入人员。
2.3.3 测试资料
列出本项测试所需的资料,如: a.有关本项任务的文件。
b. 被测试程序及其所在的媒体。 c. 测试的输入和输出举例。
d. 有关控制此项测试的方法、过程的图表。
2.3.4 测试培训
说明或引用资料说明为被测软件的使用提供培训的计划。规定培训的内容、受训的人员及从事培训的工作人员。
2.4 测试2 ( 标识符 )
用与本测试计划2.3条相类似的方式说明用于另一项及其后各项测试内容的测试工作计划。
3 测试设计说明
3.1 测试1(标识符)
说明对第一项测试内容的测试设计考虑。
3.1.l 控制
说明本测试的控制方式,如输入是人工、半自动或自动引入、控制操作的顺序以及结果的记录方法。
3.1.2 输入
说明本项测试中所使用的输入数据及选择这些输入数据的策略。 3.1.3 输出
说明预期的输出数据,如测试结果及可能产生的中间结果或运行信息。 3.l.4 过程
说明完成此项测试的一个个步骤和控制命令,包括测试的准备、初始化、中间步骤和运行结束方式。
3.2 测试2(标识符)
用与本测试计划3.1条相类似的方式说明第2项及其后各项测试工作的设计考虑。 4 评价准则 4.1 范围 2314 说明所选择的测试用例能够检查的范围及其局眼性。 4.2 数据整理
陈述为了把测试数据加工成便于评价的适当形式,使得测试结果可以同已知结果进行比较而要用到的转换处理技术。如手工方式或自动方式;如果是用自动方式整理数据,还要说
第3章 软 件 设 计
明为进行处理而要用到的硬件、软件资源。
4.3 尺度
说明用来判断测试工作是否能通过的评价尺度,如合理的输出结果的类型、测试输出结果与预期输出之间的容许偏离范围、允许中断或停机的最大次数。
八、测试分析报告
l 引言
1.1 编写目的
说明编写这份测试分析报告的目的,指出预期的读者。 1.2 背景 说明:
a. 测试计划所从属的软件系统的名称。
b. 该开发项目的历史,列出用户和执行此项目测试的计算中心,指出测试环境与实际运行环境之间可能存在的差异以及这些差异对测试结果的影响。
1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资斜
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属于本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 测试概要
用表格的形式列出每一项测试的标识符及其测试内容,并指明实际进行的测试工作内容与测试计划中预先设计的内容之间的差别,说明做出这种改变的原因。
3 测试结果及发现
3.1 测试1(标识符)
把本项测试中实际得到的动态输出(包括内部生成数据输出)结果同对于动态输出的要求进行比较,陈述其中的各项发现。
3.2 测试2(标识符)
用类似本报告3.1条的方式给出第2项及其后各项测试内容的测试结果和发现。 4 对软件功能的结论 4.l 功能1(标识符) 4.1.1 能力 简述该项功能,说明为满足此项功能而设计的软件能力以及经过一项或多项测试已证实的能力。
4.1.2 限制
说明测试数据值的范围(包括动态数据和静态数据),列出就这项功能而言,测试期间在该软件中查出的缺陷、局限性。
4.2 功能2(标识符) 2315 用类似本报告4.1的方式给出第2项及其后各项功能的测试结论。 5 分析摘要 5.1 能力
陈述经测试证实了的本软件的能力。如果所进行的测试是为了验证一项或几项特定性能
第3章 软 件 设 计
要求的实现,应提供这方面的测试结果与要求之间的比较,井确定测试环境与实际运行环境之间可能存在的差异对能力的测试所带来的影响。
5.2 缺陷和限制
陈述经测试证实的软件缺陷和限制,说明每项缺陷和限制对软件性能的影响,并说明全部测得的性能缺陷的累积影响和总影响。
5.3 建议
对每项缺陷提出改进建议,如: a. 各项修改可采用的修改方法。 b. 各项修改的紧迫程度。 c. 各项修改预计的工作量。 d. 各项修改的负责人。 5.4 评价
说明该项软件的开发是否已达到预定目标,能否交付使用。 6 测试资源消耗
总结测试工作的资源消耗数据,如工作人员的水平级别数量、机能消耗等。
九、项目开发总结报告
l 引言
1.1 编写目的
说明编写这份测试分析报告的目的,指出预期的读者。 1.2 背景 说明:
a. 测试计划所从属的软件系统的名称。
b. 该开发项目的历史,列出用户和安装此软件的计算中心。 1.3 定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 1.4 参考资斜
列出用得着的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文。 b.属于本项目的其他已发表的文件。
c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2 实际开发结果 2.l 产品
说明最终制成的产品,包括:
a.程序系统中各个程序的名字。它们之间的层次关系,以千字节为单位的各个程序的程序量、存储媒体的形式和数量。
b. 程序系统共有哪几个版本,各自的版本号及它们之间的区别。 c. 每个文件的名称。
d. 所建立的每个数据库。如果开发中制订过配置管理计划,要同这个计划2316 相比较。
2.2 主要功能和性能
逐项列出本软件产品所实际具有的主要功能和性能,对照可行性研究报告、项目开发计划、功能需求说明书的有关内客,说明原定的开发目标是达到了、未完全达到,还是超过了。
第3章 软 件 设 计
2.3 基本流程
用图给出本程序系统的实际的基本的处理流程。 2.4 进度
列出原定计划进度与实际进度的对比,明确说明实际进度是提前了、还是延迟了,分析主要原因。
2.5 费用
列出原定计划费用与实际支出费用的对比,包括: a.工时,以人月为单位,并按不同级别统计。
b.计算机的使用时间、区别CPU时间及其他设备时间。 c. 物料消耗、出差费等其他支出。
明确说明,经费是超出了、还是节余了,分析其主要原因。 3 开发工作评价
3.1 对生产效率的评价 给出实际生产效率,包括:
a. 程序的平均生产效率,即每人月生产的行数。 b.文件的平均生产效率,即每人月生产的千字数。 并列出原订计划数作为对比。 3.2 对产品质量的评价
说明在测试中检查出来的程序编制中的错误发生率,即每千条指令〔或语句〕中的错误指令数(或语句数)。如果开发中制订过质量保证计划或配置管理计划,要同这些计划相比较。
3.3 对技术方法的评价
给出对在开发中所使用的技术、方法、工具、手段的评价。 3.4 出错原因的分析
给出对于开发中出现的错误原因分析。 4 经验与教训
列出从这项开发工作中所得到的最主要经验与教训,及对今后项目开发工作的建议。
2317
因篇幅问题不能全部显示,请点此查看更多更全内容