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

《计算机软件产品开发文件编制指南》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、计算机软件产品开发文件编制指南119软件需求说明书10数据要求说明书1211概要设计说明书1212详细设计说明书1313数据库设计说明书1414用户手册1515操作手册1616模块开发卷宗1617测试计划19><>81<>8测试分析报告1919开发进度月报1920项目开发总结报告20附录C软件需求说明书的编写提示2<>8附录D数据要求说明书的编写提示31附录E概要设计说明书的编写提示32附录F详细设计说明书的编写提示35附录G数据库设计说明书的编写提示37附录H用户手册的编写提示39附录I操作手册的编写提示42附录J模块开发

2、卷宗的编写提示44附录K测试计划的编写提示45附录L测试分析报告的编写提示47附录M开发进度月报的编写提示49附录N项目开发总结报告的编写提示51摘自《计算机软件工程规范国家标准汇编》中华人民共和国国家标准GB<>87><567—<>8<>8计算机软件产品开发文件编制指南Guidelinesforcomputersoftwareproductdevelopmentdocumentation引言目的一项计算机软件的筹划、研制及实现，构成一个软件开发项目。一个软件开发项目的进行，一般需要在人力和自动化资源等方面作重大的投资。为了

3、保证项目开发的成功，最经济的花费这些投资，并且便于运行和维护，在开发工作的每一阶段，都需要编制一定的文件。这些文件连同计算机程序及数据一起，作为开发人员在一定阶段内的工件成果和结束标志；向管理人员提供软件开发过程中的进展和情况，把软件开发过程中一些“不可见的”的事物转换成“可见的”文字资料。以便管理人员在各个阶段检查开发计划的实施进展，使之能够判断原定目标是否已达到，还将继续耗用资源的种类和数量；记录开发过程中的技术信息，便于协调以后的软件开发、使用和修改；提供对软件有有关运行、维护和培训的信息，便于管理人员、开发人员、操作

4、人员和用户之间相互了解彼此的工作；向潜在用户报导软件的功能和性能，使他们能判定该软件能否服务于自己的需要。换言之，本指南认为：文件的编制必须适应计算机软件整个生存周期的需要。计算机软件所饮食的文件有两类：一类是开发过程中填写的各种图表，可称之为工作表格；另一类是则是应编制的技术资料或技术管理资料，可称之为文件。本指南规定软件文件的编制形式，并提供对这些规定的解释。本指南的目的是使得所编制的软件文件确实能够起到软件文件应该发挥的作用。范围本指南是一份指导性文件。本指南建议，在一项计算机软件的开发过程中，一般地说，应该产生十四种

5、文件。这十四种文件是：可行性研究报告；项目开发计划；软件需求说明书；数据要求说明书；概要设计说明书；详细设计说明书；数据库设计说明书；用户手册；操作手册；模块开发卷宗；测试计划；测试分析报告；开发进度月报；项目开发总结报告。本指南将给出开发过程中建议产生的这十四种文件的编制指导，同时，本指南也是这十四种文件的编写编写质量的检验准则。但是，本指南并未涉及软件开发过程中如何填写工作表格的问题。一般地说，一个软件总是一个计算机系统（包括硬件、固件和软件）的组成部分。鉴于计算机系统的多样性，本指南一般不涉及整个系统开发中的文件编制，

6、本指南仅仅是软件开发过程中的文件编制指南。文件的使用者对于使用文件的人员而言，他们所关心的文件的种类，随他们所承担的工作而异。管理人员：可行性研究报告，项目开发计划，模块开发卷宗，开发进度月报，项目开发总结报告；开发人员：可行性研究报告，项目开发计划，软件需求说明书，数据要求说明书，概要设计说明书，详细设计说明书，数据库设计说明书，测试计划，测试分析报告；维护人员：设计说明书，测试分析报告，模块开发卷宗；用户：用户手册，操作手册。尽管本指南提出了在软件开发中文件编制的要求，但并不意味羊这些文件都必须交给用户。一项软件的用户应

7、该得到的文件和种类由供应者与用户之间签订的合同规定。文件的编制指导4．软件生存周期与各种文件的编制一项计算机软件，从出现的一个构思之日起，经过这项软件开发成功投入使用，直到最后决定停止使用，并被另一项软件代替之时止，被认为是该软件的一个生存周期可以分成以下六个阶段：可行性与计划研究阶段需求分析阶段设计阶段实现阶段测试阶段运行与维护阶段在可行性研究与计划阶段内，要确定该软件的开发目标和总的要求，要进行可行性分析、投资-收益分析、制订开发计划，并完成应编制的文件。在需求分析阶段内，由系统分析人员对被设计的系统进行系统分析，确定对

8、该软件的各项功能、性能需求和设计约束，确定对文件编制的要求，作为本阶段工作的结果，一般地说，软件需求说明书、数据要求说明书和初步的用户手册应该编写出来。在设计阶段内，系统设计人员和程序设计人员应该在反复理解软件需求的基础上，提出多个设计，分析每个设计能履行的功能并进行相互比较，最后确定一个