搜索
ICS35.080L77中华人民共和国国家标准GB/T8567-2006代替GB/T8567-1988计算机软件文档编制规范Specificationforcomputersoftwaredocumentation2006-03-14发布2006-07-01实施中华人民共和国国家质量监督检验检疫总局中国国家标准化管理委员会发布目次前言1范围2规范性引用文件3术语和定义4缩略语5文档过程5．1概述5．2源材料准备5．3文档计划5．4文档开发5．5评审5．6与其他公司的文档开发子合同6文档编制要求6．1软件生存周期与各种文档的编制6．2文档编制中的考虑因素7文档编制格式7．1可行性分析(研究)报告(FAR)7．2软件开发计划(SDP)7．3软件测试计划(STP)7．4软件安装计划(SIP)7．5软件移交计划(STrP)7．6运行概念说明(OCD)7．7系统/子系统需求规格说明(SSS)7．8接口需求规格说明(IRS)7．9系统/子系统设计(结构设计)说明(SSDD)7．10接口设计说明(IDD)7．11软件需求规格说明(SRS)7．12数据需求说明(DRD)7．13软件(结构)设计说明(SDD)7．14数据库(顶层)设计说明(DBDD)7．15软件测试说明(STD)7．16软件测试报告(STR)7．17软件配置管理计划(SCMP)7．18软件质量保证计划(SQAP)7．19开发进度月报(DPMR)7．20项目开发总结报告(PDSR)7．21软件产品规格说明(SPS)7．22软件版本说明(SVD)7．23软件用户手册(SUM)7．24计算机操作手册(COM)7．25计算机编程手册(CPM)附录A(规范性附录)面向对象软件的文档编制A．1综述A．2总体说明文档A．3用况图文档A．4类图文档A．5顺序图文档A．6协作图文档A．7状态图文档A．8活动图文档A．9构件图文档A．10部署图文档A．11包图文档参考文献GB/T8567-2006《计算机软件文档编制规范》前言本标准是GB/T8567—1988《计算机软件产品开发文件编制指南》的修订版，并改名为《计算机软件文档编制规范》。本标准从实施之日起代替GB/T8567—1988。本标准与GB/T8567—1988相比，主要变化如下：a)本标准增加了文档编写过程。其内容参考了ISO/IECJTCl/SC7N21061999/04/15《软件工程——用户文档过程》。b)本标准主要从软件开发与管理的角度，规定相应的文档及规范。其内容依据GB/T8566—2001《软件生存周期过程》。c)在编写本标准时，综合了在软件开发与管理中的经验及中软网络技术股份有限公司有关CMM中拟订的一些文档规范。d)本标准与SJ20778—2000《软件开发与文档编制》很好地链接。e)本标准在规定软件需求规格说明、软件测试文件、软件质量保证计划与软件配置管理计划等文档时，既依据相应的国标，又根据发展与实践经验作了相应的扩展。f)本标准把SJ/T11291—2003《面向对象的软件系统建模规范第3部分：文档编制》中的文档编制规范作为本标准的规范性附录。本标准的附录A是规范性附录。本标准由中华人民共和国信息产业部提出。本标准由信息产业部电子工业标准化研究所归口。本标准起草单位：中软网络技术股份有限公司、信息产业部电子工业标准化研究所、北京联想软件有限公司、用友软件股份有限公司。本标准主要起草人；周明德、冯惠、韩乃平、欧阳春生、殷树勋、黄万镒、强学锋、韩振江、邓适宜。GB/T8567-2006《计算机软件文档编制规范》计算机软件文档编制规范1范围本标准根据GB/T8566—2001《信息技术软件生存周期过程》的规定，主要对软件的开发过程和管理过程应编制的主要文档及其编制的内容、格式规定了基本要求。本标准原则上适用于所有类型的软件产品的开发过程和管理过程。使用者可根据实际情况对本标准进行适当剪裁(可剪裁所需的文档类型，也可对规范的内容作适当裁剪)。软件文档从使用的角度大致可分为软件的用户需要的用户文档和开发方在开发过程中使用的内部文档(开发文档)两类。供方应提供的文档的类型和规模，由软件的需方和供方在合同中规定。2规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。GB/T8566—2001信息技术软件生存周期过程(idtISO/IEC：12207：1995)GB/T11457—2006软件工程术语3术语和定义GB/T11457—2006确立的以及下列术语和定义适用于本标准。3.1验收acceptance需方授权代表的一项活动，通过该活动，需方接受履行合同的部分或全部的软件产品的所有权。3.2需方acquinr为自己或为另一个组织采购软件产品的组织。3.3批准approval需方的授权代表或开发方的上级组织对开发方的项目计划、设计或其他方面表示满意并可以作为下一阶段工作基础而签署的书面文件。3.4体系结构architecture一个系统或CSCI(ComputerSoftwareConfigurationItem-计算机软件配置项)的组织结构，标明它的组成，这些组成的接口和它们之间的操作概念。3.5相关开发方associatedeveloper一个既不是主承包方也不是开发方的分承包方的组织，但它在同一个或相关系统或项目中承担开发工作。3.6行为设计behavioraldesign从用户观点出发，对整个系统或CScI的行为进行的设计，它只考虑满足用户需求而不考虑系统或CSCI的内部实现。这种设计与体系结构设计不同，后者要标明系统或CSCI的内部部件，并有这些部件的详细设计。3.7构建版；开发阶段build(1)软件的一个版本，它满足完整的软件所要满足的全部需求的一个特定的子集。(2)开发满足特定需求子集的软件版本所经历的时间。注：术语一开发阶段”和一版本”之间的关系依赖于开发方：例如，可以通过几个版本来实现一个开发阶段，一个开发阶段也可以发行几个并行的版本(如发往不同的地点)，或者将它们用作为同义词。3.8计算机数据库computerdatabase见3.14数据库。3.9计算机硬件computerhardware能接收和存储计算机数据的，对计算机数据执行一系列系统性的操作的，或能产生控制输出的设备。这类设备能实现基本的解释、计算、通信、控制或其他逻辑功能。3.10计算机程序computerprogram能使计算机硬件实现计算或控制功能的计算机指令和数据定义的集合。3.11计算机软件computersoftwareGB/T8567-2006《计算机软件文档编制规范》见3.32软件。3.12计算机软件配置项computersoftwareconfigurationitem(CSCI)满足最终使用功能的软件集合，而且它由需方指定进行单独的配置管理。CSCI应从下列诸因素中进行折衷选择：软件功能、规模、宿主机或目标计算机、开发方、支持概念、重用计划、关键性、接口考虑、是否需要单独编写文档和控制以及其他因素。3.13配置项configurationitem能满足最终使用功能的硬件集合、软件集合或者软、硬件两者的集合，且由需方指定进行单独的配置管理。3.14数据库database以一种能被用户或计算机程序通过一个数据库管理系统进行访问的方式，存储在一个或多个计算机文件中的相关数据的集合。3.15数据库管理系统databasemanagementsystem是一整套计算机程序，它提供为建立、修改、使用和完整性维护一个数据库所需的功能。3.16可交付的软件产品deliverablesoftwareproduct合同要求交付给需方或其他指定的接受方的软件产品。3.17设计design开发方为响应一定的需求而对一个系统或CSCI选取的一些性能/规格。这些特性中有些是与需GB/T8567-2006求相匹配的：有一些是需求的精细化，如为了响应显示错误信息这一需求而定义所有的错误信息；有一些则是与实现有关的，如为满足需求，决定选用哪些软件配置项和逻辑。3.18开发方developer开发软件产品的组织(“开发”包括新的软件开发、修改、重用、再工程、维护或产生软件产品的任何其他活动)。开发方可以是一个承制方或者政府机构。3.19文档/文档编制document/documentation能供人或机器阅读的，一般具有永久性的一套资料(不管它们记录在什么媒体上)。3.20评价evaluation确定一个项或一个活动是否满足指定准则的过程。3.21固件firmware硬件设备和以只读软件的形式驻留在硬件设备上的计算机指令和/或计算机数据的组合。3.22硬件配置项hardwareconfigurationitem(HWCI)满足最终使用功能并由需方指定进行单独配置管理的一套硬件。3.23独立验证与确认independentverificationandvalidation(IV＆V)由一个机构对软件产品和活动作系统的评估，这个机构不负责该产品的开发或被评估的活动。IV＆V不在本标准的范围内。3.24接口interface在软件开发中，两个或多个实体(如cscI—cscIcscI—HWC：ICSCI一用户，或软件配置项一软件配置项)之间的关系。这些实体依据这种关系共享、提供或交换数据。接口并不是CSCI、软件配置项或其他的系统部件；接口只是这些实体间的一种关系。3.25联合评审jointreview由需方和开发方双方代表参加的对项目状态、软件产品和/或项目中的问题进行检查和讨论的活动或会议。3.26非交付的软件产品Non-deliverablesoftwaerproduct不是合同中要求交付给需方或其他指定接受方的软件产品。3.27过程process为实现某个既定目的而进行的一组有组织的活动，例如，软件开发过程。3.28合格性测试qualificationtesting为了向需方表明一个CSCI或系统满足其指定的需求而进行的测试。3.29再工程reengineering为了以一种新的形式重组一个现有的系统而对其进行检查和改造的过程。再工程可包括逆向工程(分析一GB/T8567-2006《计算机软件文档编制规范》个系统并产生更高一级的抽象来表示它，如从代码到设计)、重构(在同一个抽象级上把系统从一种表示形式转换到另一种表示形式)、重编文档(分析一个系统并产生用户文档式支持文档)、正向工程(从现有的系统的软件产品结合新的需求，产生新系统)、重定目标系统(对系统进行转换以便将其安装到不同的目标系统上)和翻译(将源码从一种语言转换到另一种语言或者从一种语言的某个版本转换成另一种版本)。3.30需求requirement(1)为了使需方能够接受一个系统或CSCI所必需具备的特性。(2)本标准或合同中规定的必须遵守的陈述。3.31可重用的软件产品reusablesoftwareproduct为一个用途开发但还具有别的用途的软件产品，或者专门为了用于多个项目而开发的软件产品，或者在一个项目中有多种作用的软件产品。例子包括(但不限于)上市的商用软件产品，需方已装备的软件产品，重用库中的软件产品和开发方现存的软件产品。每一次使用可以包括这些软件产品的全部或部分，也可以涉及对它的修改。这个术语可以应用于任何软件产品(例如需求，体系结构等)而不只限于软件本身。3.32软件software计算机程序和计算机数据库。注：虽然有些软件的定义中包括文档，本标准把这个定义只限于计算机程序和计算机数据库。3.33软件开发softwaredevelopment产生软件产品的一整套活动。软件开发可以包括新开发、修改、重用、再工程、维护或者任何会产生软件产品的其他活动。3.34软件开发文件softwaredevelopmentfile(SDF)与特定软件实体开发有关的资料库。