ＩＣＳ ２５．０４０．４０ Ｎ １８ 囝雷 中华人民共和国国家标准 ＧＢ／Ｔ ２６８０５．３—２０ 工业控制计算机系统 １１ 软件 第３部分：文档管理指南 Ｉｎｄｕｓｔｒｉａｌ ｃｏｎｔｒｏｌ ｃｏｍｐｕｔｅｒ Ｐａｒｔ ３：Ｇｕｉｄｅｌｉｎｅｓ ｆｏｒ ｔｈｅ ２０１ １－０７－２９发布 ｓｙｓｔｅｍ－－Ｓｏｆｔｗａｒｅ－－ ｄｏｃｕｍｅｎｔ ｍａｎａｇｅｍｅｎｔ ２０１ １－１２－０１实施 宰瞀嬲鬻瓣警糌瞥霎发布 中国国家标准化管理委员会“１９ ＧＢ／Ｔ ２６８０５．３—２０ １ １ 目 次 前言…………………・・・……………………………………………………－－ １范围…………・・・…・……………………………………………………一 ［１ ２规范性引用文件…………………・・・…………………………………… １ ３术语和定义…………………………・・・………………………………… １ ４软件文档………………………………………………………………… ２ ４．１概述……………………………・・・・・・………………・……・…………・ ２ ４．２主要功能……………………………………………………………… ２ ４．３工作文档………………・・・・……・……………………………………． ３ ４．４产品文档……………………………………………………………… ４ ４．５用户软件包文档……・・・・・…………………………………・………・・・ ４ ５软件文档的计划管理…………………………………………………… ４ ５．１基本任务…………………・・・…・・・・・…………………………………・ ４ ５．２管理要点…………………………・・・………………………………… ４ ６软件文档的质量管理…………………………………………………… ８ ６．１软件文档的质量分级及质量要求…………………………・…・・・・・… ８ ６．２软件文档的复审……………………………………………………… ９ ７软件文档的配置管理…・・………………………………・…・…………・・・・ Ｏ ８管理要点总结……………………………………………………………” Ｏ 附录Ａ（规范性附录）软件生命周期的定义及阶段划分・…・・…………－－ ２ Ａ．１软件生命周期的定义………………………………………………－・ ２ Ａ．２软件定义阶段……………………………………・・………………… ２ Ａ．３软件开发阶段…・…………………………………………・………… ２ Ａ．４运行维护阶段…………………・……………………………………・ ２ 附录Ｂ（规范性附录） ４ 软件生命周期各个阶段应当产生的主要软件文档 图ｌ软件文档分级与对应文档……………………………………………………… 图Ｂ．１软件生命周期各个阶段应当产生的重要软件文档示意…………・・・・…… ＧＢ／Ｔ ２６８０５．３—２０１１ 刖 吾 ＧＢ／Ｔ ２６８０５（（工业控制计算机系统软件》分为以下部分： ——第１部分：评价体系； ——第２部分：测试方法； ——第３部分：文档管理指南； ——第４部分：工程化文档规范； ——第５部分：用户软件包文档。 本部分是ＧＢ／Ｔ ２６８０５的第３部分。 本部分的附录Ａ和附录Ｂ为规范性附录。 本部分由中国机械工业联合会提出。 本部分由全国工业过程测量和控制标准化技术委员会（ＳＡＣ／ＴＣ １２４）归口。 本部分负责起草单位：西南大学。 本部分参加起草单位：深圳市研祥软件技术有限公司、北京研华兴业电子科技有限公司、中国计算 机学会工业控制计算机专业委员会。 本部分主要起草人：吕静、杨颂华、张为群、张渝、祁虔。 本部分参加起草人：陈志列、刘志永、刘学东、刘永池、杨孟飞。 ＧＢ／Ｔ ２６８０５．３—２０ １１ 工业控制计算机系统软件 第３部分：文档管理指南 １范围 ＧＢ／Ｔ ２６８０５的本部分规定了工业控制软件文档管理的基本任务和管理要点，为项目管理者实施 该类文档的管理提供指南。 本部分适用于工业控制计算机系统的软件文档管理。 ２规范性引用文件 下列文件中的条款通过ＧＢ／Ｔ ２６８０５的本部分的引用而成为本部分的条款。凡是注日期的引用文 件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分，然而，鼓励根据本部分达成 协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本 部分。 ＧＢ／Ｔ １１４５７ ２００６信息技术软件工程术语 ＧＢ／Ｔ ２６８０５．４ ２０１１工业控制计算机系统软件第４部分：工程化文档规范 ＧＢ／Ｔ ２６８０５．５—２０１１工业控制计算机系统软件第５部分：用户软件文档 ３术语和定义 ＧＢ／Ｔ １１４５７－－２００６中确立的以及下列术语和定义适用于ＧＢ／Ｔ ２６８０５的本部分。 ３．１ 文档ｄｏｃｕｍｅｎｔ 一种数据媒体和其上所记录的数据。它具有永久性并可以由人或机器阅读。 ３．２ 用户ｕｓｅｒ ａ）使用软件求解某一问题的技术人员； ｂ）实际使用软件产品或操作运行软件的组织、单位或个人。 ３．３ 产品文档ｐｒｏｄｕｃｔ ｄｏｃｕｍｅｎｔａｔｉｏｎ 软件项目开发过程中，应当编制的各种技术资料或技术管理资料。 ３．４ 工作文档ｗｏｒｋ ｄｏｃｕｍｅｎｔａｔｉｏｎ 软件项目开发过程中，所填写的或使用过的各种图表或文字资料。 ３．５ 用户需求ｕｓｅｒ ｒｅｑｕｉｒｅｍｅｎｔ 用户所期望的软件产品的全部性能、功能和限制。它主要包括对软件产品的功能要求、性能要求， 如实时性、可靠性和可维护性要求以及安全保密要求，还包括在开发费用、时间、进度和可用资源等方面 的限制。 ３．６ 评审ｒｅｖｉｅｗ 软件项目开发中的一个重要环节。它是对某个开发产品或过程进行的全面检查、鉴定和认可。目 】 ＧＢ／Ｔ ２６８０５．３—２０ １１ 的在于尽可能早地发现错误，将实现和要求进行统一和协调。 ３．７ 配置管理ｃｏｎｆｉｇｕｒａｔｉｏｎ ｍａｎａｇｅｍｅｎｔ 标识和确定系统中配置项的过程，在系统整个生存周期内控制这些项的投放和更动，记录并报告配 置的状态和更动要求，验证配置项的完整性和正确性。 ３．８ 软件产品库ｓｏｆｔｗａｒｅ ｐｒｏｄｕｃｔｉｏｎ ｌｉｂｒａｒｙ 在软件生命周期的集成与系统测试阶段结束后，用于存放作为最终产品而交付给用户运行或现场 安装的软件库。 ３．９ 软件文档ｓｏｆｔｗａｒｅ ｄｏｃｕｍｅｎｔａｔｉｏｎ 以人们可读的形式出现的技术数据和信息，包括计算机列表和打印输出，它们描述或规定软件设计 或细节，说明软件具备的能力，或为使用软件以便从软件系统得到所期望的结果而提供的操作指令。 ４软件文档 ４．１概述 有关软件文档概述如下： ａ）软件文档是由制造商提供的、软件产品生命周期中的所有文档； ｂ） 软件文档归人工作文档和产品文档两类； ｃ）软件文档是与软件产品有关的可读文件，用以描述和记载软件产品生命周期各阶段的活动及 结果； ｄ）软件文档的表现形式可以是文字、表格、图形和音像等； ｅ）软件文档中包含描述硬件访问接口（如寄存器、引脚定义、端口、组态、中断等）的文档，以及工 业现场对软件产品的要求（如可靠性、实时性、安全性等）； ｆ）软件文档可以记载于多种媒体（例如光盘、磁盘、磁带、非易失性存储器和纸等介质）上，具有持 久性，便于保存、修改、传输和自动化管理； ｇ）软件文档可以复制；软件文档可随软件升级而更新（经授权许可）。 ４．２主要功能 ４．２．１概述 软件文档应该具备以下主要功能： ａ）实现软件管理的依据； ｂ）实现任务之间联系的凭证； ｃ）提供使用须知与说明； ｄ）提供质量保证支持； ｅ）作为历史资料； ｆ）提供产权声明。 ４．２．２实现软件管理的依据 软件文档记录了软件产品在生命周期内各阶段的活动情况，为各阶段的检查、评审和管理提供依 据，同时，软件文档记录的技术信息，可以为软件产品开发的技术管理提供依据。 ４．２．３实现任务之间联系的凭证 软件开发项目的任务主要由以下各类人员承担： ａ）软件项目管理人员； ２ ＧＢ／Ｔ ２６８０５．３—２０１ １ ｂ）提出用户需求及项目要点的专家｝ ｃ）系统分析师； ｄ）软件项目的程序设计师； ｅ）提供程序代码的程序员； ｆ）软件测试员； ｇ）质量保证专家和审核人员； ｈ） 改进操作或开发加强和扩展产品性能的维护程序员。 根据软件工程化的要求，软件文档是以上各类人员之间通信和交流的凭证，从而实现任务间的 联系。 ４．２．４提供使用须知与说明 软件文档能够提供使用须知与说明，告知系统管理人员、操作人员、用户及维护人员系统怎样工作、 如何正确使用系统去实现他们的目标，同时可实现对用户的技术培训，帮助用户尽快掌握软件产品的使 用方法。 ４．２．５提供质量保证支持 软件文档必须保证向质量保证、维护和审核人员提供执行其任务时所需要的各种质量标准以及关 于期望系统完成什么功能和系统怎样实现这些功能的清晰说明；必须制订测试计划和测试规程，并报告 测试结果；还必须说明和评估相关的控制、计算、检验例行程序及其他技术。 ４．２．６作为历史资料 将软件文档用作将来进行项目开发的一种资源。通常文档记载系统的开发历史，可使有关系统结 构的基本思想和开发经验为以后的项目利用。良好的系统文档有助于把程序移植和转移到各种新的系 统环境中。 ４．２．７提供产权声明 软件文档包含软件产品的评测报告、版权、著作权、知识产权等相关资料。 ４．３工作文档 ４．３．１工作文档的目的 工作文档的目的包括： ａ）工作文档主要记录需求、设计、程序和测试方面有关决定的细节； ｂ）工作文档明确划分全体开发人员的职责范围，规定每一个人应该做什么，使他们能够各司 其职； ｃ）工作文档明确规定检查要点和进度，便于项目管理者评估项目的进展情况； ｄ）工作文档记录项目开发的历史，为开发后续项目提供参考。 ４．３．２工作文档的内容 工作文档可分为开发文档和管理文档。开发文档描述项目开发过程本身，以开发所涉及的工具、方 法等技术为主；管理文档描述开发阶段划分，各开发阶段的任务确定，以及如何实现各个阶段的衔接，记 录进度、变更和职责定义、评定等管理工作。 工作文档内容包括： ——可行性研究报告； ——软件项目开发计划书； ——软件质量保证计划书； ——软件配置管理计划书； ——安全与控制信息规格说明； ——备忘录或改变控制形式的记录。 ３ ＧＢ／Ｔ ２６８０５．３—２０ １１ 实际的工作文档可以包括上述文档中的部分或全部。根据项目开发的特点，还可以产生新的工作 文档。 工作文档的内容与格式应符合ＧＢ／Ｔ ２６８０５．４—２