GJB438B军用软件开发文档通用要求
合集下载
相关主题
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
文档若为电子文档，应规定电子文档的 格式（如DOC文件、PDF文件等）。
软件开发活动分类
基本活动类（18个）
项目策划和监控
风险管理
保密性有关活动
系统 需求分析
软件 需求 分析
系统 设计
系统
系统
集成与测试 合格性测试
软件 设计
软件 实现与单 元测试
单元 集成与
测试
CSCI 合格性
测试
软件使用准备 分承制方管理
页码编制
文档正文的目录使用小写罗马数字编号； 文档正文和附录均使用阿拉伯数字顺序编号； 若一个文档分为若干卷，则每一卷应重新开始按顺序编
号。
自变量：字母X和Y为各文档小条编号的自变 量。标题上圆括源自文库中的文字在编写时要用实 际内容替换。
文档结构
封面。封面宜包括文档标识及版本号、密级、编制/ 修订日期、文档名称、编制单位、编写、审核、批 准。
本标准规定了执行GJB2786A所产生的军用软 件开发文档，适用于军用软件开发过程中文 档的编制。
GJB438B 其他说明
本标准代替GJB 438A-1997。 与GJB 438A-1997相比，本次修订将标准的名
称更改为《军用软件开发文档通用要求》。 依据GJB 2786A，从软件开发和管理的角度，
规定了相应的文档编制要求。 考虑承研单位的实际要求，对测试计划的部
分内容也进行了充实和调整。
文档编制
文档的内容是根据GJB 2786A各活动描 述的工作任务而产生的，描述了军用软 件开发过程中的主要活动信息和要求。
开发方应按照本标准的要求记录有关信 息，编写有关文档，并按合同（或软件 研制任务书）的要求交付。
修订背景（续1）
软件文档是整个软件开发工作的重要产品，是实行管 理、监督、控制软件开发的重要的方式。
软件文档把软件开发过程中的一些不可见的事物转化 成为可见的文字资料，便于管理人员在各个阶段检查 开发计划的进展情况，以提高软件生产过程的可见性 和可控性。
软件文档作为软件产品的一部分，文档的质量在很大 程度上决定了软件的质量。
军用软件开发的通用要求，包括软件开发过程的 开发、支持和管理等方面的要求。 本标准适用于需方和开发方获取、开发及维护军 用软件（含固件中的软件）。
适用范围（续1）
本标准中所涉及的“系统”有两类： 一类是 硬件－软件系统（例如一个雷达系统），对 于这种系统，本标准只适用于系统中的软件 部分；另一类是软件系统（例如一个地理信 息系统），对这类系统，本标准适用于其整 个系统。
比较适合于采用结构化软件开发方法和瀑布式开发模型， 缺乏灵活性；
对于大型信息系统的软件开发缺少有关规定（如：对于需 求逐步明确的情况、数据库设计和实现）；
对上个世纪九十年代以后广泛采用的软件工程有关要求、 技术和方法未明确涉及，如软件开发策划和跟踪、测量和 分析、质量保证、软件重用等。
软件质量管理规定和GJB5000的贯彻实施，促使军用软件有关 各方对软件工程化和软件过程改进的认识有很大提高。同时， 也感到GJB 2786在有些方面还没有明确支持，或不够协调。
文档剪裁
承制方可根据项目所选择的生存周期、合同（或软件研 制任务书）的要求以及实际活动，确定项目产生的文档 种类，并根据实际情况对文档的种类进行合并、拆分。
例如，可以在《软件开发计划》中描述了软件质量保证计划和 软件配置管理计划的内容，也可不产生单独的《软件质量保证 计划》、《软件配置管理计划》。
软件移交准备
软件验收支持
与IV&V机构联系 与相关开发方协调
支持活动类（6个）
软件配置管理 软件工作产品评价
软件质量保证 纠正措施
联合评审 测量与分析
组织活动类（2个）
软件开发环境建立
项目过程的改进
文档表示方式
表示形式：为使各文档章条的信息更加清晰 可读，可采用图、表、矩阵或其它形式的表 示方式进行说明。
《军用软件开发文档通用要求》。
概貌
第1章 第2章 第3章 第4章 第5章 附录
范围 引用文件 术语、定义和缩略语 一般要求 详细要求 28个附录
适用范围
在GJB 438B范围一节中明确指出：本标准规定了 军用软件开发文档编制的种类、结构、格式和内 容等要求。
本标准适用于军用软件开发过程中文档的编制。 而在GJB2786A的范围一节中指出，该标准规定了
软件的种类、文档的多少、文档的内容要求，对软件 开发效率、开发成本以及将来的维护都产生重要的影 响。
在软件开发中不论是软件承制方还是软件订购方对文 档都极为重视。
修订背景（续2）
GJB 2786A《军用软件开发 通• 用要求》在修订过程中， 主要以MIL-STD-498“软件开发与文档编制”的框架 为参考，并增加相关的软件工程实践。
GJB438B 概述
GJB438B 课题组 2010.07
提纲
背景 全貌 适用范围 一般要求 详细要求
修订背景
随着装备信息化迅速发展，装备中计• 算机软件的种类、规模、 以及安全、保密等属性的要求都迅速增加或提高。实践中许多 军用软件开发者感到GJB 2786《武器系统软件开发》存在一些 问题，如：
修改页。修改页应包括修改时间、修改内容以及修 改人等。
目录。目录应包括章、条、图表、注释和附录的编 号、标题及其所在页码。
正文。正文为各文档的具体内容，详细要求见标准 的第5章。
附录。文档的附录应提供文档维护的详细信息（例 如：图、表、分类数据等）。每个附录都应在文档 的正文中被引用。为方便起见，附录可单独装订成 册。
因此，与之配套的文档类型、内容和形式上都要相 应发生变化。
需要对GJB 438A进行修订，保留其有效方面，改进 其不足之处，以适应当前我军装备软件研制的需要。
GJB 438B更名原因
本标准是与GJB 2786A（修订中）配套使用 GJB 2786在修订过程中，专家建议将名称改
为《军用软件开发通用要求》 本标准修订时也将名称作了相应变化，改为
根据需要，也可以对文档内容进行剪裁。
按文档标题顺序与本标准规定的标题顺序相同的原则，若剪裁 了某章条或某小条，则在被裁去的章条（或小条）的标题下将 其标识为“不适用”，并说明理由。
软件开发活动分类
基本活动类（18个）
项目策划和监控
风险管理
保密性有关活动
系统 需求分析
软件 需求 分析
系统 设计
系统
系统
集成与测试 合格性测试
软件 设计
软件 实现与单 元测试
单元 集成与
测试
CSCI 合格性
测试
软件使用准备 分承制方管理
页码编制
文档正文的目录使用小写罗马数字编号； 文档正文和附录均使用阿拉伯数字顺序编号； 若一个文档分为若干卷，则每一卷应重新开始按顺序编
号。
自变量：字母X和Y为各文档小条编号的自变 量。标题上圆括源自文库中的文字在编写时要用实 际内容替换。
文档结构
封面。封面宜包括文档标识及版本号、密级、编制/ 修订日期、文档名称、编制单位、编写、审核、批 准。
本标准规定了执行GJB2786A所产生的军用软 件开发文档，适用于军用软件开发过程中文 档的编制。
GJB438B 其他说明
本标准代替GJB 438A-1997。 与GJB 438A-1997相比，本次修订将标准的名
称更改为《军用软件开发文档通用要求》。 依据GJB 2786A，从软件开发和管理的角度，
规定了相应的文档编制要求。 考虑承研单位的实际要求，对测试计划的部
分内容也进行了充实和调整。
文档编制
文档的内容是根据GJB 2786A各活动描 述的工作任务而产生的，描述了军用软 件开发过程中的主要活动信息和要求。
开发方应按照本标准的要求记录有关信 息，编写有关文档，并按合同（或软件 研制任务书）的要求交付。
修订背景（续1）
软件文档是整个软件开发工作的重要产品，是实行管 理、监督、控制软件开发的重要的方式。
软件文档把软件开发过程中的一些不可见的事物转化 成为可见的文字资料，便于管理人员在各个阶段检查 开发计划的进展情况，以提高软件生产过程的可见性 和可控性。
软件文档作为软件产品的一部分，文档的质量在很大 程度上决定了软件的质量。
军用软件开发的通用要求，包括软件开发过程的 开发、支持和管理等方面的要求。 本标准适用于需方和开发方获取、开发及维护军 用软件（含固件中的软件）。
适用范围（续1）
本标准中所涉及的“系统”有两类： 一类是 硬件－软件系统（例如一个雷达系统），对 于这种系统，本标准只适用于系统中的软件 部分；另一类是软件系统（例如一个地理信 息系统），对这类系统，本标准适用于其整 个系统。
比较适合于采用结构化软件开发方法和瀑布式开发模型， 缺乏灵活性；
对于大型信息系统的软件开发缺少有关规定（如：对于需 求逐步明确的情况、数据库设计和实现）；
对上个世纪九十年代以后广泛采用的软件工程有关要求、 技术和方法未明确涉及，如软件开发策划和跟踪、测量和 分析、质量保证、软件重用等。
软件质量管理规定和GJB5000的贯彻实施，促使军用软件有关 各方对软件工程化和软件过程改进的认识有很大提高。同时， 也感到GJB 2786在有些方面还没有明确支持，或不够协调。
文档剪裁
承制方可根据项目所选择的生存周期、合同（或软件研 制任务书）的要求以及实际活动，确定项目产生的文档 种类，并根据实际情况对文档的种类进行合并、拆分。
例如，可以在《软件开发计划》中描述了软件质量保证计划和 软件配置管理计划的内容，也可不产生单独的《软件质量保证 计划》、《软件配置管理计划》。
软件移交准备
软件验收支持
与IV&V机构联系 与相关开发方协调
支持活动类（6个）
软件配置管理 软件工作产品评价
软件质量保证 纠正措施
联合评审 测量与分析
组织活动类（2个）
软件开发环境建立
项目过程的改进
文档表示方式
表示形式：为使各文档章条的信息更加清晰 可读，可采用图、表、矩阵或其它形式的表 示方式进行说明。
《军用软件开发文档通用要求》。
概貌
第1章 第2章 第3章 第4章 第5章 附录
范围 引用文件 术语、定义和缩略语 一般要求 详细要求 28个附录
适用范围
在GJB 438B范围一节中明确指出：本标准规定了 军用软件开发文档编制的种类、结构、格式和内 容等要求。
本标准适用于军用软件开发过程中文档的编制。 而在GJB2786A的范围一节中指出，该标准规定了
软件的种类、文档的多少、文档的内容要求，对软件 开发效率、开发成本以及将来的维护都产生重要的影 响。
在软件开发中不论是软件承制方还是软件订购方对文 档都极为重视。
修订背景（续2）
GJB 2786A《军用软件开发 通• 用要求》在修订过程中， 主要以MIL-STD-498“软件开发与文档编制”的框架 为参考，并增加相关的软件工程实践。
GJB438B 概述
GJB438B 课题组 2010.07
提纲
背景 全貌 适用范围 一般要求 详细要求
修订背景
随着装备信息化迅速发展，装备中计• 算机软件的种类、规模、 以及安全、保密等属性的要求都迅速增加或提高。实践中许多 军用软件开发者感到GJB 2786《武器系统软件开发》存在一些 问题，如：
修改页。修改页应包括修改时间、修改内容以及修 改人等。
目录。目录应包括章、条、图表、注释和附录的编 号、标题及其所在页码。
正文。正文为各文档的具体内容，详细要求见标准 的第5章。
附录。文档的附录应提供文档维护的详细信息（例 如：图、表、分类数据等）。每个附录都应在文档 的正文中被引用。为方便起见，附录可单独装订成 册。
因此，与之配套的文档类型、内容和形式上都要相 应发生变化。
需要对GJB 438A进行修订，保留其有效方面，改进 其不足之处，以适应当前我军装备软件研制的需要。
GJB 438B更名原因
本标准是与GJB 2786A（修订中）配套使用 GJB 2786在修订过程中，专家建议将名称改
为《军用软件开发通用要求》 本标准修订时也将名称作了相应变化，改为
根据需要，也可以对文档内容进行剪裁。
按文档标题顺序与本标准规定的标题顺序相同的原则，若剪裁 了某章条或某小条，则在被裁去的章条（或小条）的标题下将 其标识为“不适用”，并说明理由。