软件开发文档国标Word格式.docx

资源描述

软件开发文档国标Word格式.docx

《软件开发文档国标Word格式.docx》由会员分享，可在线阅读，更多相关《软件开发文档国标Word格式.docx（91页珍藏版）》请在冰点文库上搜索。

软件开发文档国标Word格式.docx

分。

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

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

而异。

管理人员：

可行性研究报告，

项目开发计划，

模块开发卷宗，

开发进度月报，

项目开发总结报告；

开发人员：

软件需求说明书，

数据要求说明书，

概要设计说明书，

详细设计说明书，

数据库设计说明书，

测试计划，

维护人员：

设计说明书，

测试分析报告，

用户：

用户手册，

操作手册。

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

必须交给用户。

一项软件的用户应该得到的文件的种类由供应者与用户之间签订

的合同规定。

一项计算机软件，从出现一个构思之日起，经过这项软件开发成功投入使用，

直到最后决定停止使用，并被另一一项软件代替之时止，被认为是该软件的一个生存周期。

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

可行性与计划

研究阶段

需求分析阶段

设计阶段

实现阶段

测试阶段

运行与维护阶段

在可行性研究与计划阶段内，要确定该软件的开发目标和总的要求，要进行可

行性分析、投资一收益分析、制订开发计划，并完成应编制的文件。

在需求分析阶段内，由系统分析人员对被设计的系统进行系统分析，确定对该

软件的各项功能、性能需求和设计约束，确定对文件编制的要求，作为本阶段工

作的结果，一般地说，软件需求说明书、数据要求说明书和初步的用户手册应该

编写出来。

在设计阶段内，系统设计人员和程序设计人员应该在反复理解软件需求的基础

上，提出多个设计，分析每个设计能履行的功能并进行相互比较，最后确定一个

设计，包括该软件的结构、模块的划分、功能的分配以及处理流程。

在被设计系

统比较复杂的情况下，设计阶段应分解成概要设计阶段和详细设计阶段两个步

骤。

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

概要设计说明书、详细设计说明书和测

试计划初稿。

在实现阶段内，要完成源程序的编码、编译（或汇编）和排错调试得到无语法

错的程序清单，要开始编写模块开发卷宗，并且要完成用户手册、操作手册等面

向用户的文件的编写工作，还要完成测试计划的编制。

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

一般要完

成模块开发卷宗和测试分析报告，作为开发工作的结束，所生产的程序、文件以

及开发工作本身将逐项被评价，最后写出项目开发总结报告。

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

在运行和维护阶段，软件将在运行使用中不断地被维护，根据新提出的需求进

行必要而且可能的扩充和删改。

对于一项软件而言，其生存周期各阶段与各种文件编写工作的关系可见表互，

其中有些文件的编写工作可能要在若干个阶段中延续进行。

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

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

是一个从形成最初轮廓，经反复检查和

修改，直到程序和文件正式交付使用的完整过程。

其中每一步都要求工作人员做

出很大努力。

要保证文件编制的质量，要体现每个开发项目的特点，也要注意不

要花太多的人力。

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

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

这些读者包括个人或小组、软件开发单位的

成员或社会上的公众、从事软件工作的技术人员、管理人员或领导干部。

他们期

待着使用这些文件的内容来进行工作，例如设计、编写程序、测试、使用、维护

或进行计划管理。

因此，这些文件的作者必须了解自己的读者，这些文件的编写

必须注意适应自己的特定读者的水平、特点和要求。

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

较明显的重复有两类。

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

概。

第二类明显的重复是各种文件中的说明部分，如对功能性能的说明、对输入

和输出的描述、系统中包含的设备等。

这是为了方便每种文件各自的读者，每种

产品文件应该自成体系，尽量避免读一种文件时又不得不去参考另一种文件。

当

然，在每一种文件里，有关引言、说明等同其他文件相重复的部分，在行文上、

在所用的术语上、在详细的程度上，还是应该有一些差别，以适应各种文件的不

同读者的需要。

鉴于软件开发是具有创造性的脑力劳动，也鉴于不同软件在规模上和复杂程

度上差别极大，本指南认为在文件编制工作中应允许一定的灵活性。

这种灵活性

表现在如下各款。

531

尽管本指南认为在一般情况下，一项软件的开发过程中，应产生的文件有十四

种，然而针对一项具体的软件开发项目，有时不必编制这么多的文件，可以把几

种文件合并成一种。

一般地说，当项目的规模、复杂性和成败风险增大时，文件

编制的范围、管理手续和详细程度将随之增加。

反之，则可适当减少。

为了恰当

地掌握这种灵活性，本指南要求贯彻分工负责的原则，这意味着：

一个软件开发单位的领导机构应该根据本单位经营承包的应用软件的专业

领域和本单位的管理能力，制定一个对文件编制要求的实施规定，主要是：

在不

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

这些文件的详细程度？

该开发单位的每一个项

目负责人，必须认真执行这个实施规定。

这种规定的两个例子可叹本指南的附

录o（参考件）；

b．对于一个具体的应用软件项目，项目负责人应根据上述实施规定，确定一

个文件编制计划，主中包括:

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

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

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

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

每项工作必须落实到人。

这个文件编制计划是整个开发计划的重要组成部分；

C．有关的设计人员则必须严格执行这个文件编制计划。

532

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

百页。

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

此详细程度取决于任务的规模、复杂性和

项目负责人对该软件的开发过程及运行环与所需要的详细程度的判断。

533

当被开发系统的规模非常大（例如源码超过一百万行）时，一种文件可以分成

几卷编写，可以按其。

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

项目开发计划可能包括：

质量保证计划，

配置管理计划，

用户培训计划，

安装实施计划；

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

系统设计说明书，

子系统设计说明书；

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

程序设计说明书，

接口设计说明书，

版本说明；

操作手册可分写成：

操作手册，

安装实施过程；

．测试计划可分写成：

测试设计说明，

测试规程，

测试用例；

测试分析报告可分写成：

综合测试报告，

验收测试报告；

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

534

在有些文件中，可以使用本指南所提供的章、条标题，但在条内又存在一系列

需要分别讨论的因素本指南认为，所有的条都可以扩展，可以进一步细分，以

适应实际需要。

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

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

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

535

本指南对于程序的设计表现形式并未作出规定或限制，可以使用流程图的形

式、判定表的形式，1可以使用其他表现形式，如程序设计语言（PDL）、问题

分析图（PAD）等。

536

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

使用形式化语言。

537

当本指南中规定的文件种类尚不能满足某些应用部门的特殊需要时，他们可以

建立一些特殊的文件种类要求，例如软件质量保证计划、软件配置管理计划等，

这些要求可以包含在本单位的文件编制实施规定中。

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

用。

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

理必须贯穿于整个开发过程。

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

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

文件是软件产品

的必不可少的组成部分；

在软件开发过程的各个阶段中，必须按照规定及时地完

成各种产品文件的编写工作；

必须把在一个开发步骤中作出的决定和取得的结果

及时地写入文件；

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

这些文件的

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

这些文件上必须有编写者、评审者和

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

在软件开发的过程中，产生的文件是很多的，为了便于保存、查找、使用和

修改，应该对文件按层次地加以分类组织。

一个软件开发单位应该建立一个对本

单位文件的标识方法，使文件的每一页都具有明确的标识。

例如可以按如下四个

层次对文件加以分类和标识。

a．文件所属的项目的标识；

b．文件种类的标识；

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

d．页号。

此外，对每种文件还应根据项目的性质，划定它们各自的保密级别，确定他

们各自的发行范围。

在一项软件的开发过程中，随着程序的逐步形成和逐步修改，各种文件亦在不

断地产生、不断地修改或补充。

因此，必须加以周密的控制，以保持文件与程序

产品的一致性，保持各种文件之间的一致性和文件的安全性。

这种控制表现为：

a．就从事一项软件开发工作的开发集体而言，应设置一位专职的文件管理人

员（接口管理工程师或文件管理员）；

在开发集体中，应该集中保管本项目现有

全部文件的主文本两套，由该文件管理人员负责保管；

b．每一份提交给文件管理人员的文件都必须具有编写人、审核人和批准人的

签字；

C．这两套主文本的内容必须完全一致；

其中有一套是可供出借的，另一套是

绝对不能出借的，以免发生万一；

可出借的主文本在出借时必须办理出借手续，

归还时办理注销出借手续；

d．开发集体中的工作人员可以根据工作的需要，在本项目的开发过程中持有

一些文件，即所谓个人文件，包括为使他完成他承担的任务所需要的文件，以及

他在完成任务过程中所编制的文件；

但这种个人文件必须是主文本的复制品，必

须同主文本完全一致，若要修改，必须首先修改主文本；

e．不同开发人员所拥有的个人文件通常是主文本的各种子集；

所谓子集是指

把主文本的各个部分根据承担不同任务的人员或部门的工作需要加以复制、组装

而成的若干个文件的集合；

文件管理人员。

应该列出一份不同子集的分发对象的

清单，按照清单及时把文件分发给有关人员或部门；

f．一份文件如果已经被另一份新的文件所代替，则原文件应该被注销；

文件

管理人中要随时整理主文本，及时反映出文件的变化和增加情况，及时分发文件；

g．当一个项目的开发工作临近结束时，文件管理人员应逐个收回开发集体内

每个成员的个人文件，并检查这些个人文件的内容；

经验表明，这些个人文件

往往可能比主文本更详细，或同主文本的内容有所不同，必须认真监督有关人员进行修改，使主文本能真正反映实际的开发结果。

6．4文件的修改管理

在一个项目的开发过程中的任何时刻，开发集体内的所有成员都可能对开发

工作的已有成果——文件，提出进行修改的要求。

提出修改要求的理由可能是

各种各样的，进行修改而引起的影响可能很小，也可能会牵涉到本项目的很多方面。

因此，修改活动的进行必须谨慎，必须对修改活动的进行加以管理，必

须执行修改活动的规程，使整个修改活动有控制地进行。

修改活动可分如下五个步骤进行：

a．提议开发集体中的任何一个成员都可以向项目负责人提出修改建议，为此

应该填写一份修改建议表，说明修改的内容、所修改的文件和部位、以及修改

理由；

b．评议由项目负责人或项目负责人指定的人员对该修改建议进行评议，包括

审查该项修改的必要性、确定这一修改的影响范围、研究进行修改的方法、步

骤和实施计划；

c．审核一般由项目负责人进行审核，包括核实修改的自的和要求、核实修改

活动将带来的影响、审核修改活动计划是否可行；

d．批准在一般情况下，批准权属于该开发单位的部门负责人；

在批准时，主

要是决断修改工作中各项活动的先后顺序及各自的完成日期，以保证整个开发

工作按原定计划日期完成；

e．实施由项目负责人按照已批准的修改活动计划，安排各项修改活动的负责

人员进行修改，建立修改记录、产生新的文件以取代原有文件、最后把文件交

文件管理人员归档，并分发给有关的持有者。

本篇将对引言中提到的十四种文件提供内容要求，作为文件编制的技术标准。

可行性研究报告的编写目的是：

说明该软件开发项目的实现在技术、经济和

社会条件方面的可行性；

评述为了合理地达到开发目标而可能选择的各种方案；

说明并论证所选定的方案。

可行性研究报告的编写内容要求如下：

7．1C1编写目的

7．1．2背景

7．1．3定义

7．1．4参考资料7

7．2．1要求

7．2．2目标

7．2．3条件、假定和限制

7．2．4进行可行性研究的方法

7．2．5评价尺度

7．3．1数据流程和处理流程

7．3．2工作负荷

7．3．3费用开支

7．3．4人员

7．3．5设备

7．3．6局限性

7．4．1对所建议系统的说明

7．4．2数据流程和处理流程

7．4．3改进之处

7．4．4影响

7．4．4．1对设备的影响

7．4．4．2对软件的影响

7．4．4．3对用户单位机构的影响

7．4．4．4对系统运行的影响

7．4．4．5对开发的影响

7．4，4．6对地点和设施的影响

7．4．4．7对经费开支的影响

7．4．5局限性

7．4．6技术条件方面的可行性

7．5．1可选择的系统方案1

7．5．2可选择的系统方案2

．．．．．．

7．6．1支出

7．6．1．1基本建设投资

7．6．1．2其他一次性支出

7．6．1．3非一次性支出

7．6．2收益

7．6，2．1一次性收益

7．6．2．2非一次性收益

7．6．2．3不可定量的收益

7．6．3收益／投资比

7．6．4投资回收周期

7．6．5敏感性分析

7．7．1法律方面的可行性

7．7．2使用方面的可行性

编制项目开发计划的目的是用文件的形式，把对于在开发过程中各项工作的负

责人员、开发进度、所需经费预算、所需软、硬件条件等问题作出的安排记载

下来，以便根据本计划开展和检查本项目的开发工作。

编制内容要求如下：

8．1

8．1．1编写目的

8．1．2背景

8．1．3定义

8．1．4参考资料

8．2．1作内容

8．2．2主要参加人员

8．2．3产品及成果

8．2．3．1程序

8．2．3．2文件

8．2．3．3服务

8．2．3．4非移交产品

8．2．4验收标准

8．．2．5完成项目的最迟期限

8．2．6本计划的审查者与批准者

8．3．1工作任务的分解

8．3．2接口人员

8．3．3进度

8．3．4预算

8．3．5关键问题

8．4．1计算机系统支持

8．4．2需要用户承担的工作

8．4．3需由外单位提供的条件

软件需求说明书的编制是为了使用户和软件开发者双方对该软件的初始规定

有一个共同的理解，使之成为整个开发工作的基础。

编制软件需求说明书的内容要求如下：

9．1．1编写目的

9．1．2背景

9．1．3定义

9．1．4参考资料

9．2

9．2．1目标

9．2．2用户的特点

9．2．3假定与约束

9．3．1对功能的规定

9．3．2对性能的规定

9．3．2．1精度

9．3．2．2时间特性耍求

9．3．2．3灵活性

9．3．3输入输出要求

9．3．4数据管理能力要求

9．3．5故障处理要求

9．3．6其他专门要求

9．4．1设备

9．4．2支持软件

9．4．3接口

9．4．4控制

数据要求说明书的编制目的是为了向整个开发时期提供关于被处理数据的描

述和数据采集要求的技术信息。

编制数据要求说明书的内容要求如下：

101

10．1．1编写目的

10．1．2背景

10．1．3定义

10．1．4参考资料

102

10．2．1静态数据

10．2．2动态输入数据

10．2．3动态输出数据

10．2．4内部生成数据

10．2．5数据约定

103

10．3．1要求和范围

10．3．2输入的承担者

10．3．3处理

10．3．4影响。

概要设计说明书又可称系统设计说明书，这里所说的系统是指程序系统。

编制

的目的是说明对程序系统的设计考虑，包括程序系统的基本处。

流程、程序系统的组织结构、模块划分、功能分配、接口设计。

运行设计、数据结构设计和

出错处理设计等，为程序的详细设计提供基础。

编制概要设计说明书的内容要

求如下：

111

11．1．1编写目的

11．1．2背景

11．1．3定义

11．1．4参考资料

11．2

11．2．1需求规定

11．2．2运行环境

11．2．3基本设计概念和处理流程

11．2．4结构

11．2．5功能需求与程序的关系

11．2．6人工处理过程

11．2．7尚未解决的问题

113

11．3．1用户接口

11．3．2外部接口

11．3．3内部接口

114

11．4．1运行模块组合

11．4．2运行控制

11．4．3运行时间

115

11．5．1逻辑结构设计要点

11．5．2物理结构设计要点

11．5．3数据结构与程序的关系

116

11．6．1出错信息

11．6．2补救措施

11．63系统维护设计

详细设计说明书又可称程序设计说明书。

编制目的是说明一个软件系统各个层

次中的每一个程序（每个模块或子程序）的设计考虑，如果一个软件系统比较

简单，层次很少，本文件可以不单独编写，有关内容合并入概要设计说明书。

对详细设计说明书的内容要求如下：

121

12．1．1编写目的

12．1．2背景

12．1．3定义

12．1．4参考资料

122

1231

12．3．1程序描述

12．3．2功能

12．3．3性能

12．3．4输入项

12．3．5输出项

12．3．6算法

12．3．7流程逻辑

12．3．8接口

12．3．．9存储分配

12．3．10注释设计

12．3．11限制条件

12．3．12测试计划．

12．3．13尚未解决的问题

1242

数据库设计说明书的编制目的是对于设计中的数据库的所有标识、逻辑结构

和物理结构作出具体的设计规定。

其内容要求如下：

131

13．1．1编写目的

13．1．2背景

13．1．3定义

13．1．4参考资料

132

13．2．1标识符和状态

13．2．2使用它的程序

13．2．3约定

13．2．4专门指导

13．2．5支持软件

133

13．3．1概念结构设计

13．3．2逻辑结构设计

13．3．3物理结构设计

134

13．4．1数据字典设计

13．4．2安全保密设计

用户手册的编制是要使用非专门术语的语言，充分地描述该软件系统所具有的

功能及基本的使用方法。

使用户（或潜在用户）通过本手册能够了解该软件的用

途，并且能够确定在什么情况下，如何使用它。

具体的内容要求如下：

141

14．1．1编写目的

14．1．2背景

14．1．3定义

14．1．4参考资料

142

14．2．1功能

14．2．2性能

14．2．2．1精度

14．2．2．2时间特性

14．2．2．3灵活性

14．2．3安全保密

143

14．3．1硬设备

14．3．2支持软件

14．3．3数据结构

144

14．4．1安装与初始化

14．4．2输入

14．4．2．1输入数据的现实背景

14．4．2．2输入格式

14．4．2．3输入举例

14．4．3输出

14．4．3．1输出数据的现实背景

14．4．3．2输出格式

14．4．3．3输出举例

14．4．4文卷查询

展开阅读全文