《计算机软件产品开发文件编制指南》

附录五国家标准《计算机软件产品开发文件编制指南》国家标准《计算机软件产品开发文件编制指南》（GB8567—88）是一份指导性文件。它建议在软件的开发过程申编下述14个文件：可行性研究报告、项目开发计划、软件需求说明书、数据要求说明书、总体设计说明书、详细设计说明、数据库设计说明书、用户手册、操作手册、模块开发卷、测试计划、测试分析报告、开发进度表、项目开发总结。该指南给出了这14个文件的编制提示，它同时也是这14个文件编写质量的检验准则。下面详细介绍这14种文件的编写目的与内容要求。l、可行性研究报告可行性研究报告的目的是：说明该软件开发项目的实现在技术上、经济上和社会条上的可行性，论述为了合理地达到开发目标而可能选择的各种方案，说明并论证所选定的方案。可行性研究报告的编写内容见表l。表l可行性研究报告1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.可行性研究的前提2.1要求2.2目标2.3条件、假定和限制2.4进行可行性研究的方法2.5评价尺度3.对现有系统的分析3.1数据流程和处理流程3.2工作负荷3.3消费开支3.4人员3.5设备3.6局限性4.所建议的系统4.1对所建议系统的说明4.2数据流程和处理流程4.3改进之处4.4影响4.4.1对设备的影响4.4.2对软件的影响4.4.3对用户单位机构的影响4.4.4对系统运行的影响4.4.5对开发的影响4.4.6对地点和设施的影响4.4.7对经费开支的影响4.5局限性4.6技术条件方面的可行性5.可选择的其他系统方案5.1可选择的系统方案15.2可选择的系统方案26.投资及收益分析6.1支出6.1.1基本建设投资6.1.2其他一次性支出6.1.3非一次性支出6.2收益6.2.1一次性收益6.2.2非一次性收益6.2.3不可定量的收益6.3收益/投资比6.4投资回收周期6.5敏感性分析7.社会条件方面的可行性7.1法律方面的可行性7.2使用方面的可行性8.结论2、项目开发计划编制项目开发计划的目的是用文件的形式，并在开发过程中各项工作的负责人员、开发进度、经费预算、所需软硬件条件等问题做出的安排记录下来，以便根据本计划开展和检查项目的开发工作。编制内容要求如表2所示。表2项目开发计划1.引言1.1编写目的1.2背景1.3定义1.4参考资料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接口人员3.3进度3.4预算3.5关键问题4.支持条件4.1计算机统支持4.2需要用户承担的工作4.3需由外单位提供的条件5.专题计划要点3、软件需求说明书软件需求说明书的编制是为了使用户和软件开发人员双方对该软件的初始规定有一个共同的理解，使之成为整个软件开发工作的基础。其内容要求见表3。表3软件需求说明书1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.任务概述2.1目标2.2用户的特点2.3假定的约束3.需求规定3.1对功能的规定3.2对性能的规定3.2.1精度3.2.2时间特性要求3.2.3灵活性3.3输入输出要求3.4数据管理要求3.5故障处理要求3.6其他专门要求4.运行环境规定4.1设备4.2支撑软件4.3接口4.4控制4、数据要求说明书数据要求说明书的编制目的是为了向整个软件开发时期提供关于被处理数据的描述和数据采集要求的技术信息，其内容要求列于表4中。表4数据要求说明书1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.数据的逻辑描述2.1静态数据2.2动态输入数据2.3动态输出数据2.4内部生成数据2.5数据约定3.数据的采集3.1要求的范围3.2输入的承担者3.3处理3.4影响5、概要设计说明书概要设计说明书又称为总体设计说明书，编制目的是说明对项目系统的设计考虑，包括基本处理流程、组织结构、模块结构、功能配置、接口设计、运行设计、系统配置、数据结构设计和出错处理设计等，为程序的详细设计提供基础。其内容要求见表5。表5概要设计说明书1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.总体设计2.1运行环境2.2基本设计概念和处理流程2.3结构2.4功能需求与程序的关系2.5人工处理过程2.6尚未解决的问题3.接口设计3.1用户接口3.2外部接口3.3内部接口4.运行设计4.1运行模块组合4.2运行控制4.3运行时间5.系统数据结构设计5.1逻辑结构设计要点5.2物理结构设计要点5.3数据结构设计要点6.系统出错处理设计6.1出错信息6.2补救措施6.3系统维护设计6、详细设计说明书详细设计说明书又称为程序设计说明，编制目的是说明一个软件系统各个层次中的每一个程序（模块）的设计考虑。如果软件系统比较简单，层次少，本文件可以不单独编写，有关内容可并入概要设计说明书。详细设计说明书的内容要求见表6。表6详细设计说明书1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.程序系统的组织结构3.程序1（结构符）设计说明3.1程序描述3.2功能3.3性能3.4输入项3.5输出项3.6算法3.7流程逻辑3.8接口3.9存储分配3.10注释设计3.11限制条件3.12测试设计3.13尚未解决的问题4.程序2（标识符）设计说明书7、数据库设计说明书数据库设计说明书的编制目的是对于设计中的数据的所有标识、逻辑结表7数据库设计说明书1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.外部设计2.1标识符和状态2.2使用它的程序2.3约定2.4专门指导2.4支撑软件3.结构设计3.1概念结构设计3.2逻辑3.3物理结构设计4.运用设计4.1数据字典设计4.2安全保密设计构和物理结构做出具体的设计规定。内容要求见表7。8、用户手册用户手册的编制是使用非专业术语的语言，充分地描述该软件系统所具有的功能及基本的使用方法。使用户通过本手册能够了解该软件的用途，并能够确定在什么情况下、如何使用它。具体的内容要求见表8。表8用户手册1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.用途2.1功能2.2性能2.2.1精度2.2.2时间特性2.2.3灵活性3.运行环境3.1硬环境3.2支撑软件3.3数据结构4.使用过程4.1安全与初始化4.2输入4.2.1输入数据的现实背景4.2.2输入格式4.2.3输入举例4.3输出4.3.1输出数据的现实背景4.3.2输出格式4.3.3输出举例4.4文卷查询4.5出错处理与恢复4.6终端操作9、操作手册操作手册的编制是为了向操作人员提供该软件每个运行的具体过程的有关知识，包括操作方法的细节。内容要求见表9。表9操作手册1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.软件概述2.1软件的结构2.2程序表2.3文卷表3.安装与初始化4.运行说明4.1运行表4.2运行步骤4.3运行1(标识符)说明4.3.1运行控制4.3.2操作信息4.3.3输出文段4.3.4输出文段4.3.5输出文段的复制4.3.6启动恢复过程4.4运行2(标识符)说明……5.非常规过程6.远程过程10、模块开发卷宗模块开发卷宗是在模块开发过程中逐步编写出来的。每完成一个模块或一组密切相关的模块，复审时编写出一份，应该把所有的模块开发卷宗汇集在一起。编写的目的是记录和汇总低层次开发的进度和结果；以便于对整个系统开发工作进行管理的复审，并为将来的维护提供有用的技术信息。具体内容要求见表10。11、测试计划表10模块开发卷宗1.标题2.模块开发情况表(见附表S10.10a)3.功能说明4.设计说明5.源代码清单6.测试说明7.复审的结论表10a模块开发情况表模块标识符模块的描述性名称代码设计计划开始日期实际开始日期计划完成日期实际完成日期模块测试计划开始日期实际开始日期计划完成日期实际完成日期组装测试计划开始日期实际开始日期计划完成日期实际完成日期代码复查日期/签字源代码行数目标模块大小项目负责人批准日期/签字这里所说的测试是指整个软件系统的组装测试和确认测试，本文件的编制是为了提供一个对该软件的测试计划，包括对每项测试活动的内容、进度安排、设计考虑、测试数据的整体性方法及评价准则。具体内容见表11。表11测试计划1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.计划2.1软件说明2.2测试内容2.3测试1(标识符)2.3.1进度安排2.3.2条件2.3.3测试资料2.3.4测试培训2.4测试2(标识符)……3.测试设计说明3.1测试1(标识符)3.1.1控制3.1.2输入3.1.3输出3.1.4过程3.2测试2(标识符)……4.评价准则4.1范围4.2数据整理4.3尺度12、测试分析报告测试分析报告的编写是为了把组装测试和确认测试的结果、发现的问题以及分析结果写出成文件形式加以保存，具体编写内容要求见表12。表12测试分析报告1.引言1.1编写目的1.2背景1.3定义1.4参考资料2.测试概要3.测试结果及发现3.1测试1(标识符)3.2测试2(标识符)……4.对软件功能的结论4.1功能1(标识符)4.1.1能力4.1.2限制4.2功能2(标识符)……5.分析摘要5.1能力5.2缺陷和限制5.3建议5.4评价6.测试资源消耗13、开发进度月报开发进度月报的编制目的是及时向有关管理部汇报项目开发的进度和情况,以便及时发现和处理开发过程中出现的问题。一般来说，开发进度月报是以项目组为单位每月编写的，具体内容要求见表13。表13开发进度月报1.标题2.工程进度与状态2.1进度2.2态度3.资源耗用与状态3.1资源耗用3.1.1工时3.1.2机时3.2状态4.经费支出与状态4.1经费支出4.1.1支出性费用4.1.2设备购置费4.2状态5.下个月的工作计划6.建议14、项目