最新GJB438B军用软件开发文档通用要求精选
GJB438B军用软件开发文档通用要求 课堂
? 需要对GJB 438A进行修订，保留其有效方面，改进 其不足之处，以适应当前我军装备软件研制的需要。
5
Байду номын сангаас GJB 438B更名原因
? 本标准是与 GJB 2786A （修订中）配套使用 ? GJB 2786在修订过程中，专家建议将名称改
3
修订背景（续1）
? 软件文档是整个软件开发工作的重要产品，是实行管 理、监督、控制软件开发的重要的方式。
? 软件文档把软件开发过程中的一些不可见的事物转化 成为可见的文字资料，便于管理人员在各个阶段检查 开发计划的进展情况，以提高软件生产过程的可见性 和可控性。
? 软件文档作为软件产品的一部分，文档的质量在很大 程度上决定了软件的质量。
? 本标准适用于军用软件开发过程中文档的编制。 ? 而在GJB2786A的范围一节中指出，该标准规定了
军用软件开发的通用要求，包括软件开发过程的 开发、支持和管理等方面的要求。 ? 本标准适用于需方和开发方获取、开发及维护军 用软件（含固件中的软件）。
8
适用范围（续1）
? 本标准中所涉及的“系统”有两类： 一类是 硬件－软件系统（例如一个雷达系统），对 于这种系统，本标准只适用于系统中的软件 部分；另一类是软件系统（例如一个地理信 息系统），对这类系统，本标准适用于其整 个系统。
规定了相应的文档编制要求。 ? 考虑承研单位的实际要求，对测试计划的部
分内容也进行了充实和调整。
10
文档编制
?文档的内容是根据GJB 2786A各活动描 述的工作任务而产生的，描述了军用软 件开发过程中的主要活动信息和要求。
?开发方应按照本标准的要求记录有关信 息，编写有关文档，并按合同（或软件 研制任务书）的要求交付。
软件需求规格说明编写指南438B
密级：（软件项目名称）软件需求规格说明标识：版本：页数：拟制：SQA审核：审核：批准：拟制部门：修改文档历史记录：日期版本说明修改人目录1 范围 (1)1.1 标识 (1)1.2 系统概述 (1)1.3 文档概述 (2)2 引用文档 (2)3 需求 (2)3.1 要求的状态和方式 (2)3.2 CSCI能力需求 (5)3.2.X（CSCI能力） (5)3.3 CSCI外部接口需求 (7)3.3.1 接口标识和接口图 (7)3.3.X（接口的项目唯一的标识符） (7)3.4 CSCI内部接口需求 (10)3.5 CSCI内部数据需求 (11)3.6 适应性需求 (12)3.7 安全性需求 (12)3.8 保密性需求 (13)3.9 CSCI环境需求 (14)3.10 计算机资源需求 (14)3.10.1 计算机硬件需求 (14)3.10.2 计算机硬件资源使用需求 (14)3.10.3 计算机软件需求 (15)3.11 软件质量因素 (15)3.12 设计和实现约束 (16)3.13 人员需求 (16)3.14 培训需求 (17)3.15 后勤保障需求 (17)3.16 其它需求 (17)3.17 验收、交付和包装需求（修改有关内容） (17)3.18 需求的优先顺序和关键程度 (17)4 合格性规定 (17)5 需求可追踪性 (18)6 注释 (19)1 范围1.1 标识【本条应描述本文档所适用的系统和软件的完整标识，适用时，包括其标识号、名称、缩略名、版本号与发布号。
】示例：系统标识如下：a)已批准的标识号：b)产品名称：XXXXXXc)产品代号：XXXXXXd)版本号：XXXXXe)缩略名：1.2 系统概述【本条应概述本文档所适用的系统和软件的用途。
它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构；标识当前和计划的运行现场；列出其它有关文档。
软件设计说明编写指南(438B)
密级：（软件项目名称）软件设计说明标识：版本：页数：拟制：SQA审核：审核：批准：拟制部门：年月日修改文档历史记录：日期版本说明修改人目录1 范围 (1)1.1 标识 (1)1.2 系统概述 (1)1.3 文档概述 (1)2 引用文档 (1)3 CSCI级设计决策 (1)4 CSCI体系结构设计 (2)4.1 CSCI部件 (2)4.1.1 CSCI结构 (3)4.1.2 CSC描述 (3)4.1.2.1 CSC名称和项目唯一标识号 (3)4.1.3 系统状态和模式 (4)4.2 执行方案 (4)4.2.1 CSC数据流与控制流图 (5)4.2.2 系统状态与模式的数据流与控制流 (5)4.3 接口设计 (6)4.3.1 接口设计准则 (6)4.3.2 接口标识和接口图 (6)4.3.X（接口的项目唯一的标识符） (7)5 CSCI详细设计 (10)5.X（软件单元的项目唯一的标识符，或者一组软件单元的标志符） (10)6 需求可追踪性 (12)7 注释 (12)1 范围1.1 标识【本条应描述本文档所适用的系统和软件的完整标识，适用时，包括其标识号、名称、缩略名、版本号及发布号。
】1.2 系统概述【本条应概述本文档所适用的系统和软件的用途。
它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构等；标识当前和计划的运行现场；列出其它有关文档。
】1.3 文档概述【本条应概述本文档的用途和内容，并描述与它的使用有关的保密性方面的要求。
】例：本文档描述XXXX系统软件的概要设计和详细设计，其内容和格式遵循GJB438B-2009的要求。
本文档可作为设计评审的基础，编码的依据，软件测试的基准。
2 引用文档【本章应列出引用文档的编号、标题、编写单位、修订版本及日期。
还应标识不能通过正常采购活动得到的文档的来源。
】例：表X 引用文档3 CSCI级设计决策【本章应根据需要分条给出CSCI级设计决策，即CSCI行为设计的决策（忽略其内部实现，从用户角度出发描述系统将怎样运转以满足需求）和其它影响组成该CSCI的软件单元的选择与设计的决策。
GJB438B-软件开发计划-模板
GJB438B-软件开发计划-模板技术文件标识：密级：xxxxxx软件开发计划册号：x/x 总页数：页xxxxXxxxx软件开发计划编写：审核：批准：x年x月x日修改文档历史记录：日期版本说明修改人x V1.0首次提交x1 范围1.1 标识本条应描述本文档所适用的系统和软件的完整标识，适用时，包括其标识号、标题、缩略名、版本号和发行号。
1.2 系统概述本条应概述本文档所适用的系统和软件的用途。
它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构等；标识当前和计划的运行现场；列出其他有关文档。
1.3 文档概述本条应概述本文档的用途和内容，并描述与它的使用有关的保密性方面的要求。
1.4 与其他计划之间的关系本条应描述本计划和其他项目管理计划的关系。
2 引用文档本章应列出引用文档的编号、标题、编写单位、修订版及日期，还应标识不能通过正常采购活动得到的文档的来源。
3 策划背景概述本章按需要可分为若干条，并应对后续章条描述的策划提供背景信息，主要包括如下方面的概述：a)所要开发系统、软件的需求和约束；b)项目文档的需求和约束；c)项目在系统寿命周期中的位置；d)所选用的工程项目/获取策略或其他方面对它的需求或约束；e)项目进度安排及资源的需求与约束；f)其他需求和约束，例如；项目的保密性、方法、标准、硬件和软件开发的相互依赖关系等。
4 软件开发活动的总体实施计划如果项目的不同构建版或不同软件要求不同的策划，就应在下述相应条中注明这些区别。
除下面规定的内容外，每条应标识适用的风险/不确定性和它们的处理计划。
4.1 软件开发过程本条应描述要采用的软件开发过程，软件生存周期模型的定义和选择。
计划的内容应覆盖合同（或软件研制任务书）中涉及该方面要求的所有条款，应包括已标识的计划的构建版，合适时，包括各构建版的目标以及每个构建版要执行的软件开发活动。
4.2 软件开发总体计划4.2.1 软件开发方法本条应描述或引用所使用的软件开发方法，包括为支持这些方法所使用的手工的和自动的工具以及规程的描述。
GJB438B军用软件开发文档通用要求
软件使用准备 分承制方管理
软件移交准备 与IV&V机构联系
软件验收支持 与相关开发方协调
组织活动类（2个）
软件开发环境建立
项目过程的改进
文档表示方式
表示形式：为使各文档章条的信息更加清晰 可读，可采用图、表、矩阵或其它形式的表 示方式进行说明。 页码编制
文档正文的目录使用小写罗马数字编号； 文档正文和附录均使用阿拉伯数字顺序编号； 若一个文档分为若干卷，则每一卷应重新开始按顺序编 号。
软件移交计划（STrP）
描述开发方向保障机构移交应交付项的计 划。 如果在合同或软件研制任务书中规定了向 独立保障方移交的责任，应制定STrP。
STrP的主要内容
软件保障资源：描述支持可交付软件所需的设施、硬件、软 件及其相关的文档，描述支持可交付软件所需的人员及其它 资源，并标识各部分软件保障资源之间的关系。 推荐的过程：描述为支持可交付的软件和相关的保障环境， 开发方希望向保障机构推荐的规程，包括建议和经验教训。 培训：描述开发方关于软件交付支持人员的培训计划。
STP的主要内容
测试依据：列出软件测试必须遵循的依据。
软件测试环境：描述在各测试现场的测试活动所需的软件项、硬件和固件 项等，描述网络拓扑图及所需的其它材料，描述与软件测试环境中每个元 素有关的专有性质、需方权利与许可证等问题，描述开发方安装、测试和 控制软件测试环境中的每一项的计划，描述拟建立的测试环境与需求环境 之间的差异，描述参与现场测试的组织及职责、人员及分工，描述测试前 和测试期间要进行的人员培训，标识测试现场要执行的测试等。 测试标识：描述要执行的测试的级别、类别、一般测试条件、测试进展、 数据记录整理和分析等一般信息，描述计划执行的测试等。 测试进度：描述实施本计划中所标识测试的进度表。 测试终止条件：描述被测软件的评价准则和方法以及结束测试的条件。 需求的可追踪性。
软件设计说明编写指南(438B)
密级：（软件项目名称）软件设计说明标识：版本：页数：拟制：SQA审核：审核：批准：拟制部门：年月日修改文档历史记录：日期版本说明修改人目录1 范围 (1)1.1 标识 (1)1.2 系统概述 (1)1.3 文档概述 (1)2 引用文档 (1)3 CSCI级设计决策 (1)4 CSCI体系结构设计 (2)4.1 CSCI部件 (2)4.1.1 CSCI结构 (3)4.1.2 CSC描述 (3)4.1.2.1 CSC名称和项目唯一标识号 (3)4.1.3 系统状态和模式 (4)4.2 执行方案 (4)4.2.1 CSC数据流与控制流图 (5)4.2.2 系统状态与模式的数据流与控制流 (5)4.3 接口设计 (6)4.3.1 接口设计准则 (6)4.3.2 接口标识和接口图 (6)4.3.X（接口的项目唯一的标识符） (7)5 CSCI详细设计 (10)5.X（软件单元的项目唯一的标识符，或者一组软件单元的标志符） (10)6 需求可追踪性 (12)7 注释 (12)1 范围1.1 标识【本条应描述本文档所适用的系统和软件的完整标识，适用时，包括其标识号、名称、缩略名、版本号及发布号。
】1.2 系统概述【本条应概述本文档所适用的系统和软件的用途。
它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构等；标识当前和计划的运行现场；列出其它有关文档。
】1.3 文档概述【本条应概述本文档的用途和内容，并描述与它的使用有关的保密性方面的要求。
】例：本文档描述XXXX系统软件的概要设计和详细设计，其内容和格式遵循GJB438B-2009的要求。
本文档可作为设计评审的基础，编码的依据，软件测试的基准。
2 引用文档【本章应列出引用文档的编号、标题、编写单位、修订版本及日期。
还应标识不能通过正常采购活动得到的文档的来源。
】例：表X 引用文档3 CSCI级设计决策【本章应根据需要分条给出CSCI级设计决策，即CSCI行为设计的决策（忽略其内部实现，从用户角度出发描述系统将怎样运转以满足需求）和其它影响组成该CSCI的软件单元的选择与设计的决策。
GJB438B-软件开发计划-模板
GJB438B-软件开发计划-模板技术文件标识：密级：xxxxxx软件开发计划册号：x/页数：xxxx页Xxxxx软件开发计划编写：审核：批准：x年x月x日修改文档历史记录：日期x版本V1.0首次提交说明修改人x1范围1.1标识本条应描述本文档所适用的系统和软件的完整标识，适用时，包括其标识号、标题、缩略名、版本号和发行号。
1.2系统概述本条应概述本文档所适用的系统和软件的用途。
它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构等；标识当前和计划的运行现场；列出其他有关文档。
1.3文档概述本条应概述本文档的用途和内容，并描述与它的使用有关的失密性方面的要求。
1.4与其他打算之间的关系本条应描述本计划和其他项目管理计划的关系。
2引用文档3策划背景概述本章按需要可分为若干条，并应对后续章条描述的策划提供背景息，主要包括如下方面的概述：a)所要开发系统、软件的需求和约束；b)项目文档的需求和约束；c)项目在系统寿命周期中的位置；d)所选用的工程项目/获取策略或其他方面对它的需求或约束；e)项目进度安排及资源的需求与约束；f)其他需求和约束，比方；项目的失密性、方法、标准、硬件和软件开发的相互依靠关系等。
4软件开发活动的总体实施打算如果项目的不同构建版或不同软件要求不同的策划，就应在下述相应条中注明这些区别。
除下面规定的内容外，每条应标识适用的风险/不确定性和它们的处理计划。
4.1软件开发过程本条应描述要采用的软件开发进程，软件保存周期模型的定义和选择。
打算的内容应掩盖合同（或软件研制任务书）中触及该方面要求的所有条款，应包孕已标识的打算的构建版，合适时，包孕各构建版的目标以及每一个构建版要执行的软件开发活动。
4.2软件开发总体计划4.2.1软件开发方法本条应描述或引用所使用的软件开发方法，包孕为支持这些方法所使用的手工的和自动的工具以及规程的描述。
该方法应掩盖合同（或软件研制任务书）中触及该方面要求的所有条款。
GJB438B-软件开发计划-模板
技术文件标识：密级：xxxxxx软件开发计划册号：x/x 总页数：页xxxxXxxxx软件开发计划编写：审核：批准：x年x月x日修改文档历史记录：日期版本说明修改人x V1.0首次提交x1 范围1.1 标识本条应描述本文档所适用的系统和软件的完整标识，适用时，包括其标识号、标题、缩略名、版本号和发行号。
1.2 系统概述本条应概述本文档所适用的系统和软件的用途。
它还应描述系统与软件的一般特性；概述系统开发、运行和维护的历史；标识项目的需方、用户、开发方和保障机构等；标识当前和计划的运行现场；列出其他有关文档。
1.3 文档概述本条应概述本文档的用途和内容，并描述与它的使用有关的保密性方面的要求。
1.4 与其他计划之间的关系本条应描述本计划和其他项目管理计划的关系。
2 引用文档本章应列出引用文档的编号、标题、编写单位、修订版及日期，还应标识不能通过正常采购活动得到的文档的来源。
3 策划背景概述本章按需要可分为若干条，并应对后续章条描述的策划提供背景信息，主要包括如下方面的概述：a)所要开发系统、软件的需求和约束；b)项目文档的需求和约束；c)项目在系统寿命周期中的位置；d)所选用的工程项目/获取策略或其他方面对它的需求或约束；e)项目进度安排及资源的需求与约束；f)其他需求和约束，例如；项目的保密性、方法、标准、硬件和软件开发的相互依赖关系等。
4 软件开发活动的总体实施计划如果项目的不同构建版或不同软件要求不同的策划，就应在下述相应条中注明这些区别。
除下面规定的内容外，每条应标识适用的风险/不确定性和它们的处理计划。
4.1 软件开发过程本条应描述要采用的软件开发过程，软件生存周期模型的定义和选择。
计划的内容应覆盖合同（或软件研制任务书）中涉及该方面要求的所有条款，应包括已标识的计划的构建版，合适时，包括各构建版的目标以及每个构建版要执行的软件开发活动。
4.2 软件开发总体计划4.2.1 软件开发方法本条应描述或引用所使用的软件开发方法，包括为支持这些方法所使用的手工的和自动的工具以及规程的描述。