ＩＣＳ Ｎ ２５．０４０．４０ １８ 囝园 中华人民共和国国家标准 ＧＢ／Ｔ ２６８０５．４—２０ 工业控制计算机系统 １ １ 软件 第４部分：工程化文档规范 Ｉｎｄｕｓｔｒｉａｌ ｃｏｎｔｒｏｌ ｃｏｍｐｕｔｅｒ ｓｙｓｔｅｍ—Ｓｏｆｔｗａｒｅ— Ｐａｒｔ ４：Ｅｎｇｉｎｅｅｒｉｎｇ ｄｏｃｕｍｅｎｔ ｓｐｅｃｉｆｉｃａｔｉｏｎ ２０１１－０７－２９发布 ２０１１—１２－０１实施 丰瞀粥紫瓣訾幞瞥鐾发布 中国国家标准化管理委员会徼１” ＧＢ／Ｔ ２６８０５．４—２０１ １ 目 次 前言………………………………………………………… Ｉ 范围………………………………………………・…… ２规范性引用文件………………………………………・ ３术语和定义……………………………………………－ ４文档规范………………………………………………・ 附录Ａ（规范性附录） 可行性研究报告的编写格式…… 附录Ｂ（规范性附录） 软件项目开发计划书的编写提示 附录Ｃ（规范性附录） 软件需求规格说明书的编写提示 附录Ｄ（规范性附录）数据需求说明书的编写提示…… 附录Ｅ（规范性附录） 软件概要设计说明书的编写提示 附录Ｆ（规范性附录） 软件详细设计说明书的编写提示 附录Ｇ（规范性附录） 数据库设计说明书的编写提示… 附录Ｈ（规范性附录） 软件模块规格说明书的编写提示 附录Ｉ（规范性附录） 软件质量保证计划的编写提示… 附录Ｊ（规范性附录） 软件配置管理计划的编写提示… 附录Ｋ（规范性附录）用户手册的编写提示…………… 附录Ｉ。（规范性附录）操作手册的编写提示…………… 附录Ｍ（规范性附录）程序维护手册的编写提示……… 附录Ｎ（规范性附录）测试计划的编写提示…………… 附录Ｏ（规范性附录） 测试分析报告的编写提示……… 附录Ｐ（规范性附录） 安装实施过程的编写提示……… 表１ Ⅲ● ， 耵如北“媚鸲引碍踮船叭鸥％盯∞ｎ 各阶段的质量记录………・ 表２项目质量保证活动日程表一 表３配置项命名规则表……… 表４配置项和配置基线列表… 表５项目配置管理活动的日程表 毖毖孙孙盯 ＧＢ／Ｔ ２６８０５．４—２０１１ 刖 ＧＢ／Ｔ 昂 ２６８０５（＜工业控制计算机系统软件》分为以下几部分： ——第ｌ部分：评价体系； ——第２部分：测试方法； ——第３部分：文档管理指南； ——第４部分：工程化文档规范； ——第５部分：用户软件文档。 本部分是ＧＢ／Ｔ ２６８０５的第４部分。 本部分的附录Ａ、附录Ｂ、附录ｃ、附录Ｄ、附录Ｅ、附录Ｆ、附录Ｇ、附录Ｈ、附录Ｉ、附录Ｊ、附录Ｋ、附 录Ｌ、附录Ｍ、附录Ｎ、附录０和附录Ｐ均为规范性附录。 本部分由中国机械工业联合会提出。 本部分由全国工业过程测量和控制标准化技术委员会（ｓＡｃ／Ｔｃ １２４）归口。 本部分负责起草单位：深圳市研祥软件技术有限公司。 本部分参加起草单位：北京研华兴业电子科技有限公司、西南大学、中国计算机学会工业控制计算 机专业委员会。 本部分主要起草人：陈志列、刘志永。 本部分参加起草人：刘学东、刘永池、杨颂华、刘枫、张为群、吕静、杨盂飞。 Ⅲ ＧＢ／Ｔ ２６８０５．４—２０ １ １ 工业控制计算机系统软件 第４部分：工程化文档规范 １范围 ＧＢ／Ｔ ２６８０５的本部分规定了工业控制软件项目，在其生命周期的各个阶段所产生的主要软件文 档的内容、格式及编制要求，以便作为软件项目的开发、评审、使用与维护的基准。 本部分适用于工业控制软件及其修订版本的技术文档的编制。 ２规范性引用文件 下列文件中的条款通过ＧＢ／Ｔ ２６８０５的本部分的引用而成为本部分的条款。凡是注日期的引用文 件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分，然而，鼓励根据本部分达成 协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本 部分。 ＧＢ／Ｔ ７７１４—２００５文后参考文献著录规则（ＩＳＯ ６９０：１ ９８７，ＮＥＱ） ＧＢ／Ｔ ８５６７ ２００６计算机软件文档编制规范 ＧＢ／Ｔ １ １４５７－－２００６信息技术软件工程术语 ＧＢ／Ｔ ２６８０５．３ ２０１１ 工业控制计算机系统软件第３部分：文档管理指南 ３术语和定义 ＧＢ／Ｔ ｌ １４５７－－２００６确立的以及下列术语和定义适用于ＧＢ／Ｔ ２６８０５的本部分。 ３．１ 系统ｓｙｓｔｅｍ 除有特殊说明外，是指软件系统。 ３．２ 敏感部位ｓｅｎｓｉｔｉｖｅ ｐｏｓｉｔｉｏｎ 系统或某一部分对某些因素易于感受的性能的部分或部位。 ３．３ 敏感度ｓｅｎｓｉｔｉｖｅｎｅｓｓ 系统或某一部分对某些因素易于感受的性能。 ３．４ 敏感条件ｓｅｎｓｉｔｉｖｅ ｃｏｎｄｉｔｉｏｎ 系统或某一部分对某些因素易于感受的性能的条件。 ３．５ 工程化文档ｅｎｇｉｎｅｅｒｉｎｇ ｄｏｃｕｍｅｎｔ 工业控制软件项目的生命周期中产生的文档。 ４文档规范 ４．１可行性研究报告 ４．１．１总则 可行性研究报告要对工业控制对象作概要的描述．根据需求和实现环境把对软件开发项目在一定 ＧＢ／Ｔ ２６８０５．４—２０１１ 工业、技术、经济和社会条件下实现的可行性研究结果写成文档，为管理部门决定本开发项目的进行提 供依据。可行性研究报告见ＧＢ／Ｔ ８５６７－－２００６中的７．１部分。 可行性研究报告的编写示例见附录Ａ。 ４．１．２可行性研究报告的内容 ４．１．２．１概述 ４．１．２．１．１编写目的 对工业控制对象作概要的描述，根据需求和实现环境把对软件开发项目在一定工业、技术、经济和 社会条件下实现的可行性研究结果写成文档．为管理部门决定本开发项目的进行提供依据。 ４．１．２．１．２背景 包括： ａ） 待开发的软件系统的名称； ｂ）提出者和交办单位； ｃ） 承办单位和承办人员； ｄ）用户。 ４．１．２．１．３参考资料 按照ＧＢ／Ｔ ７７１ ４－－２００５格式要求，列出本文档中引用到的参考资料，包括资料的编号、作者、标题、 来源、出版单位、日期等。 ４．１．２．１．４术语与缩略语 列出本文档中专用的术语、定义或缩略语。 ４．１．２．２可行性研究的前提 ４．１．２．２．１概述 说明开发项目进行可行性研究的前提，如需求、目标、假定、限制、进行方法和评价准则。 ４．１．２．２．２需求 根据工业控制对象和用户的要求说明对软件开发的基本需求，如： ａ）功能，如数据采集、调节控制、图形显示、组态功能等； ｂ）性能，如控制精度、响应时间、实时性要求、可靠性、灵活性等； ｃ）输出．如控制量、开关量、报告、文件或数据，对每项输出要说明其特征，如用途、产生频率、类型 以及接口； ｄ）输入，说明来自工业控制对象和操作者的各种输入，包括数据的来源、类型、数量、数据的组织 以及提供的频率； ｅ）用图表的方式表示出最基本的数据流程和处理流程，并扼要说明； ｆ）在安全与保密方面的要求； ｇ） 同本系统相连接的其他系统； ｈ）完成期限。 ４．１．２．２．３目标 说明建议开发软件的主要开发目标，如： ａ）处理速度的提高； ｂ）控制精度的提高； ｃ） 调节品质的改善； ｄ） 提高工作效率和减轻劳动强度； ｅ）提高经济效益（提高产品质量．降低能源消耗等）； ｆ）提高生产自动化程度。 ９ ＧＢ／Ｔ ２６８０５．４—２０１１ ４．１．２．２．４条件、假定和限制 说明开发工作中作出的假定和所受到的限制，如： ａ）整个系统的运行寿命； ｂ） 经费、投资方面的来源和限制； ｃ） 硬件、软件、运行环境和开发环境方面的条件和限制； ｄ） 法律和政策方面的限制。 ４．１．２．２．５可行性研究的方法 说明可行性研究的基本方法和评价准则，如调查、加权、确定模型、建立基准点或仿真等。 ４．１．２．２．６评价尺度 说明对系统进行评价时的主要尺度，如费用多少、各项功能的优先次序、可靠性的地位、实时性的考 虑等。 ４．１．２．３现有系统的分析 ４．１．２．３．１定义 现有系统是指当前实际使用的系统，这个系统可能是计算机系统，也可能是一个机械系统甚至是一 个人工系统。 分析现有系统的目的是为了进一步阐明开发新系统或修改现有系统的必要性。 ４．１．２．３．２处理流程和数据流程 说明现有系统的基本的处理流程和数据流程。 ４．１．２．３．３工作负荷 列出现有系统所承担的工作及工作量。 ４．１．２．３．４费用开支 列出由于运行现有系统所引起的费用支出，如人力、设备、空间、支持性服务、材料等项开支以及开 支总额。 ４．１．２．３．５局限性 列出现存系统的各种主要局限性，如处理时间不能满足需要、响应时间不及时、数据存储能力不足、 处理功能不够等。 ４．１．２．４建议的系统 ４．１．２．４．１概述 说明建议系统的目标和要求将如何被满足。 ４．１．２．４．２说明 概括地说明所建议系统，说明要求将如何得到满足，说明所使用的基本方法及理论根据。 ４．１．２．４．３处理流程和数据流程 如用户的操作规程、源数据的处理、系统失效的后果及恢复的处理办法等。 ４．１．２．４．４改进之处 根据主要开发目标，逐项说明所建议系统相对于现存系统具有的改进。 ４．１．２．４．５影响 说明在建立所建议系统时，预期将带来的影响，包括： ａ） 设备的影响。说明新提出的设备要求，对现有设备的修改。 ｂ）对软件的影响。说明对现有应用软件和支持软件所作的修改和补充。 ｃ）对系统运行过程的影响。如用户的操作规范、源数据的处理、系统失效的后果及恢复的处理办 法等。 ４．１．２．４．６局限性 说明建议的系统尚存在的局限性以及这些问题未能消除的原因。 ３ ＧＢ／Ｔ ２６８０５．４—２０ １ １ ４．１．２．４．７其他可选择的系统 说明曾研究过的各种可选择的系统，包括需开发的和可从国内外直接购买的，若没有可供选择的系 统方案，则要加以说明。 ４．１．２．４．８技术条件方面的可行性 说明技术条件方面的可行性，如： ａ） 在当前的限制条件下．该系统的目标能否达到； ｂ）利用现有的技术．该系统的功能能否实现； ｃ） ｄ） 对开发人员的数量和质量的要求能否满足； 在规定的期限内本系统的开发能否完成。 ４．１．２．５投资及效益分析 ４．１．２．５．１支出 说明建议系统需要的费用。 ４．１．２．５．２基本建设投资 包括采购、开发和安装下列各项所需费用，如： ａ） 计算机及外围设备； ｂ）数据通讯设备； ｃ）支持软件； ｄ）其他。 ４．１．２．５．３经常性支出 经常性支出包括： ａ）人员工资； ｂ）管理费用； ｃ）设备租金折旧费用； ｄ）其他。 ４．１．２．５．４效益 说