计算机软件产品开发文件编制指南文档格式.docx

计算机软件产品开发文件编制指南文档格式.docx

《计算机软件产品开发文件编制指南文档格式.docx》由会员分享，可在线阅读，更多相关《计算机软件产品开发文件编制指南文档格式.docx（42页珍藏版）》请在冰豆网上搜索。

　　C．记录开发过程中的技术信息，便于协调以后的软件开发、使用和修改；

　　d．提供对软件的有关运行、维护和培训的信息，便于管理人员、开发人员、操作人员和用户之间相互了解彼此的工作；

　　e．向潜在用户报导软件的功能和性能，使他们能判定该软件能否效劳于自己的需要。

　　换言之，本指南认为：

文件的编制必须适应计算机软件整个生存周期的需要。

　　计算机软件所包含的文件有两类：

一类是开发过程中填写的各种图表，可称之为工作表格；

另一类那么是应编制的技术资料或技术管理资料，可称之为文件。

本指南规定软件文件的编制形式，并提供对这些规定的解释。

本指南的目的是使得所编制的软件文件确实能够起到软件文件应该发挥的作用。

2围

　　本指南是一份指导性文件。

本指甫建议，在一项计算机软件的开发过程中，一般地说，应该产生十四种文件。

这十四种文件是：

　　可行性研究报告；

　　工程开发方案；

　　软件需求说明书；

　　数据要求说明书；

　　概要设计说明书；

　　详细设计说明书；

　　数据库设计说明书；

　　用户手册；

　　操作手册；

　　模块开发卷宗；

　　测试方案；

　　测试分析报告；

　　开发进度月报；

　　工程开发总结报告。

　　本指南将给出开发过程中建议产生的这十四种文件的编制指导，同时，本指南也是这十四种文件的编写质量的检验准那么。

但是，本指南并未涉及软件开发过程中如何填写工作表格的问题。

　　一般地说，一个软件总是一个计算机系统〔包括硬件、固件和软件〕的组成局部。

鉴于计算机系统的多样性，本指南一般不涉及整个系统开发中的文件编制问题，本指南仅仅是软件开发过程中的文件编制指南。

3文件的使用者

　　对于使用文件的人员而言，他们所关心的文件的种类，随他们所承当的工作而异。

　　管理人员：

可行性研究报告，工程开发方案，模块开发卷宗，开发进度月报，工程开发总结报告；

　　开发人员：

可行性研究报告，工程开发方案，软件需求说明书，数据要求说明书，概要设计说明书，详细设计说明书，数据库设计说明书，测试方案，测试分析报告；

　　维护人员：

设计说明书，测试分析报告，模块开发卷宗；

　　用户：

用户手册，操作手册。

　　尽管本指南提出了在软件开发中文件编制的要求，但并不意味着这些文件都必须交给用户。

一项软件的用户应该得到的文件的种类由供给者与用户之间签订的合同规定。

第一篇文件的编制指导

4软件生存周期与各种文件的编制

　　一项计算机软件，从出现一个构思之日起，经过这项软件开发成功投入使用，直到最后决定停顿使用，并被另一一项软件代替之时止，被认为是该软件的一个生存周期。

一般地说这个软件生存周期可以分成以下六个阶段：

　　可行性与方案研究阶段

　　需求分析阶段

　　设计阶段

　　实现阶段

　　测试阶段

　　运行与维护阶段

　　在可行性研究与方案阶段，要确定该软件的开发目标和总的要求，要进展可行性分析、投资一收益分析、制订开发方案，并完成应编制的文件。

　　在需求分析阶段，由系统分析人员对被设计的系统进展系统分析，确定对该软件的各项功能、性能需求和设计约束，确定对文件编制的要求，作为本阶段工作的结果，一般地说，软件需求说明书、数据要求说明书和初步的用户手册应该编写出来。

　　在设计阶段，系统设计人员和程序设计人员应该在反复理解软件需求的根底上，提出多个设计，分析每个设计能履行的功能并进展相互比拟，最后确定一个设计，包括该软件的构造、模块的划分、功能的分配以及处理流程。

在被设计系统比拟复杂的情况下，设计阶段应分解成概要设计阶段和详细设计阶段两个步骤。

在一般情况下，应完成的文件包括：

概要设计说明书、详细设计说明书和测试方案初稿。

　　在实现阶段，要完成源程序的编码、编译〔或汇编〕和排错调试得到无语法错的程序清单，要开场编写模块开发卷宗，并且要完成用户手册、操作手册等面向用户的文件的编写工作，还要完成测试方案的编制。

　　在测试阶段，该程序将被全面地测试，已编制的文件将被检查审阅。

一般要完成模块开发卷宗和测试分析报告，作为开发工作的完毕，所生产的程序、文件以及开发工作本身将逐项被评价，最后写出工程开发总结报告。

　　在整个开发过程中〔即前五个阶段中〕，开发集体要按月编写开发进度月报。

　　在运行和维护阶段，软件将在运行使用中不断地被维护，根据新提出的需求进展必要而且可能的扩大和删改。

　　对于一项软件而言，其生存周期各阶段与各种文件编写工作的关系可见表互，其中有些文件的编写工作可能要在假设干个阶段中延续进展。

表1软件生存周期各阶段中的文件编制

5文件编制中的考虑因素

　　文件编制是一个不断努力的工作过程。

是一个从形成最初轮廓，经反复检查和修改，直到程序和文件正式交付使用的完整过程。

其中每一步都要求工作人员做出很大努力。

要保证文件编制的质量，要表达每个开发工程的特点，也要注意不要花太多的人力。

为此，编制中要考虑如下各项因素。

5．1文件的读者

　　每一种文件都具有特定的读者。

这些读者包括个人或小组、软件开发单位的成员或社会上的公众、从事软件工作的技术人员、管理人员或领导干部。

他们期待着使用这些文件的容来进展工作，例如设计、编写程序、测试、使用、维护或进展方案管理。

因此，这些文件的作者必须了解自己的读者，这些文件的编写必须注意适应自己的特定读者的水平、特点和要求。

5．2重复性

　　本指南第二篇中将列出的这十四种文件的容要求中，显然存在某些重复。

较明显的重复有两类。

引言是每一种文件都要包含的容，以向读者提供总的梗概。

第二类明显的重复是各种文件中的说明局部，如对功能性能的说明、对输入和输出的描述、系统中包含的设备等。

这是为了方便每种文件各自的读者，每种产品文件应该自成体系，尽量防止读一种文件时又不得不去参考另一种文件。

当然，在每一种文件里，有关引言、说明等同其他文件相重复的局部，在行文上、在所用的术语上、在详细的程度上，还是应该有一些差异，以适应各种文件的不同读者的需要。

5．3灵活性

　　鉴于软件开发是具有创造性的脑力劳动，也鉴于不同软件在规模上和复杂程度上差异极大，本指南认为在文件编制工作中应允许一定的灵活性。

这种灵活性表现在如下各款。

5．3．1应编制的文件种类

　　尽管本指南认为在一般情况下，一项软件的开发过程中，应产生的文件有十四种，然而针对一项具体的软件开发工程，有时不必编制这么多的文件，可以把几种文件合并成一种。

一般地说，当工程的规模、复杂性和成败风险增大时，文件编制的围、管理手续和详细程度将随之增加。

反之，那么可适当减少。

为了恰当地掌握这种灵活性，本指南要求贯彻分工负责的原那么，这意味着：

　　a:

一个软件开发单位的领导机构应该根据本单位经营承包的应用软件的专业领域和本单位的管理能力，制定一个对文件编制要求的实施规定，主要是：

在不同的条件下，应该形成哪些文件？

这些文件的详细程度？

该开发单位的每一个工程负责人，必须认真执行这个实施规定。

这种规定的两个例子可叹本指南的附录o〔参考件〕；

　　b．对于一个具体的应用软件工程，工程负责人应根据上述实施规定，确定一个文件编制方案，主中包括:

　　〔1〕应该编制哪几种文件，详细程度如何？

　　〔2〕各个文件的编制负责人和进度要求；

　　〔3〕审查、批准的负责人和时间进度安排；

　　〔4〕在开发时期，各文件的维护、修改和管理的负责人，以及批准手续。

　　每项工作必须落实到人。

　　这个文件编制方案是整个开发方案的重要组成局部；

　　C．有关的设计人员那么必须严格执行这个文件编制方案。

5．3．2文件的详细程度

　　从同一份提纲起草的文件的篇幅大小往往不同，可以少到几页，也可以长达几百页。

对于这种差异本指南是允许的。

此详细程度取决于任务的规模、复杂性和工程负责人对该软件的开发过程及运行环与所需要的详细程度的判断。

5．3．3文件的扩展

　　当被开发系统的规模非常大〔例如源码超过一百万行〕时，一种文件可以分成几卷编写，可以按其。

每一个系统分别编制，也可以按容划分成多卷，例如：

　　工程开发方案可能包括：

质量保证方案，配置管理方案，用户培训方案，安装实施方案；

　　系统设计说明书可分写成：

系统设计说明书，子系统设计说明书；

　　程序设计说明书可分写成：

程序设计说明书，接口设计说明书，版本说明；

　　操作手册可分写成：

操作手册，安装实施过程；

　　测试方案可分写成：

测试方案，测试设计说明，测试规程，测试用例；

　　测试分析报告可分写成：

综合测试报告，验收测试报告；

　　工程开发总结报告亦可分写成工程开发总结报告和资源环境统计。

5．3．4节的扩与缩并

　　在有些文件中，可以使用本指南所提供的章、条标题，但在条又存在一系列需要分别讨论的因素本指南认为，所有的条都可以扩展，可以进一步细分，以适应实际需要。

反之，如果章条中的有些细节；

非必需，也可以根据实际情况缩并。

此时章条的编号应相应地改变。

5．3．5程序设计的表现形式

　　本指南对于程序的设计表现形式并未作出规定或限制，可以使用流程图的形式、判定表的形式，1可以使用其他表现形式，如程序设计语言〔PDL〕、问题分析图〔PAD〕等。

5．3．6文件的表现形式

　　本指南对于文件的表现形式亦未作出规定或限制，可以使用自然语言，也可以使用形式化语言。

5．3．7文件的其他种类

　　当本指南中规定的文件种类尚不能满足某些应用部门的特殊需要时，他们可以建立一些特殊的文件种类要求，例如软件质量保证方案、软件配置管理方案等，这些要求可以包含在本单位的文件编制实施规定中。

6文件编制的管理工作

　　文件编制工作必须有管理工作的配合，才能使所编制的文件真正发挥它的作用。

文件的编制工作实际上贯穿于一项软件的整个开发过程，因此，对文件的管理必须贯穿于整个开发过程。

在开发过程中必须进展的管理工作是以下四条。

6．1文件的形成

　　开发集体中的每个成员，尤其是工程负责人，应该认识到：

文件是软件产品的必不可少的组成局部；

在软件开发过程的各个阶段中，必须按照规定及时地完成各种产品文件的编写工作；

必须把在一个开发步骤中作出的决定和取得的结果及时地写入文件；

开发集体必须及时地对这些文件进展严格的评审；

这些文件的形成是各个阶段开发工作正式完成的标志。

这些文件上必须有编写者、评审者和批准者的签字，必须有编写、评审完成的日期和批准的日期。

6．2文件的分类与标识

　　在软件开发的过程中，产生的文件是很多的，为了便于保存、查找、使用和修改，应该对文件按层次地加以分类组织。

一个软件开发单位应该建立一个对本单位文件的标识方法，使文件的每一页都具有明确的标识。

例如可以按如下四个层次对文件加以分类和标识。

　　a．文件所属的工程的标识；

　　b．文件种类的标识；

　　C．同一种文件的不同版本号；

　　d．页号。

　　此外，对每种文件还应根据工程的性质