基于GJB 5000B的信息系统软件开发文档剪裁指南

随着信息化时代的深入发展，信息已成为现代战争中的核心要素，其战略地位不亚于传统的兵力、火力和机动能力。在这一背景下，制信息权成为各国军事竞争的战略制高点。为抢占先机，世界各国持续加大信息系统的研发投入，力求在信息化战争中掌握主动权。

信息系统作为信息流处理的核心平台，构成复杂、集成度高，并以软件为主导。软件在系统功能实现、性能优化与安全保障中发挥着关键作用。同时，信息系统也依赖于计算机硬件、网络与通信设备、信息资源、信息用户及规章制度等重要组成部分。这些要素相互关联、协同作用，共同构成以信息处理为目标的人机一体化系统。

在信息系统软件的研制过程中，软件文档贯穿于整个生命周期。文档不仅是传统意义上的产品图样资料，其本身也构成软件产品的重要组成部分，文档质量在很大程度上决定了软件的质量[1-2]。然而，在推行GJB 5000B—2021《军用软件能力成熟度模型》[3]软件工程化管理模式的过程中，所需编制的文档数量庞大，对设计人员而言任务繁重且复杂。

为提高软件文档质量与编制效率，需结合软件生存周期模型与开发活动，对研制过程中所需文档进行顶层规划。为此，本文针对信息系统的软件特点，系统梳理了开发过程中所需文档类别，按其作用划分为 7 大类，总结归纳相应的剪裁方法，并建立分类剪裁矩阵，以提升开发效率与文档管理的有效性。

GJB 438C—2021 《军用软件开发文档通用要求》[4]依据GJB 2786A—2009 《军用软件开发通用要求》[5]标准，明确了软件开发过程中需形成的主要文档共20份。这些文档的排列顺序基本与GJB 2786中的开发活动流程保持一致。与GJB 438B相比，新版标准减少了8类文档，显著减轻了开发人员的文档编制负担。

信息系统通常以软件为核心，具有规模大、配置项多、集成度高、关联复杂等特点[6-7]，其功能涵盖指挥控制、信息处理、安全防护等多个方面，旨在提升部队作战能力和信息化战争应对水平。因此，在软件开发过程中必须严格遵循相关标准规范。

为推进基于GJB 5000B的软件工程化实施，便于开发文档的编写与合理剪裁，本文依据 GJB 438C—2021要求，结合软件工程实践，将开发文档按其作用和功能划分为以下7类。

1.1　计划管理类文档

计划管理类文档为软件开发提供了明确的指导和策划，确保软件开发活动按照既定的目标和计划有序进行，同时提高了项目的透明度，确保软件的质量和可靠性，计划管理类包含5份文档，如表1所示。

1.2　需求分析类文档

需求分析类文档描述了系统、子系统或软件配置项的功能需求、性能需求、接口需求等，是软件开发和测试的基础，需求分析类包含 4 份文档，如表2所示。

1.3　设计说明类文档

设计说明类文档描述了系统、子系统或软件配置项的架构设计、模块划分、接口设计和数据库设计等，为软件实现提供了详细的指导，设计说明类包含4份文档，如表3所示。

1.4　测试验证类文档

测试验证类文档涵盖了软件测试的各个方面，包括测试对象、测试方法、测试用例、测试环境和测试结果等，是确保软件质量的重要手段，测试验证类包含3份文档，如表4所示。

1.5　使用手册类文档

使用手册类文档主要为开发人员和保障人员等提供编程辅助信息，有助于指导后续软件的二次开发和更新维护，使用手册类包含2份文档，如表5所示。

1.6　总结报告类文档

总结报告类文档是在软件开发周期结束时或软件版本更新时编制，总结了软件开发的经验教训、版本变更内容等，为后续的软件维护和升级提供了重要参考，总结报告类包含3份文档，如表6所示。

1.7　产品交付类文档

产品交付类文档描述了软件产品的最终形态，并为用户和维护人员提供了软件的安装、使用和保障指南，确保软件能够顺利运行并持续满足用户需求，产品交付类包含3份文档，如表7所示。

GJB 5000B 将软件成熟度等级划分为 5 个级别，从低到高依次为：初始级 （一级）、规范级（二级）、全面级 （三级）、量化级 （四级） 和卓越级 （五级），每一个等级是实现下一个等级的基础，实现分级递进。每个等级代表了企业或组织在军用软件研制过程中的不同能力水平，以及相对应的过程管理和文档管理的规范化程度。

GJB 5000B的等级划分体系对企业或组织评估和提升军用软件开发和维护方面的能力提供了强有力的指导作用，也为组织带来了不断改进的动力。每个等级的特点如表8所示。

文档剪裁主要根据项目特性和需求、开发过程和全生命周期模型、文档的必要性和实用性，以及软件工程化管理要求，应确保不影响项目的正常进行和文档的完整性，剪裁后的文档应当清晰、准确、易于理解和使用，具体包括以下5大原则。

a） 合 规 性 ： 剪 裁 后 的 文 档 必 须 满 足 GJB 5000B标准和软件工程化管理的基本要求，确保软件开发过程的合规性。

b） 实用性：文档应该聚焦于项目实际需求，避免不必要的冗余，提高文档的实用价值。

c） 可追溯性：剪裁后的文档应当保持良好的可追溯性，确保软件质量可追踪、可验证。

d） 灵活性：根据项目特点、规模、复杂度等，灵活调整文档的内容和格式，以适用不同的开发场景。

e） 一致性：剪裁过程中应当保持文档内部及文档间的协调一致。

4.1　军用软件等级划分

参照 GJB/Z 102A—2012 《军用软件安全性设计指南》 确定软件安全性等级通常划分为 A、B、C、D4 个级[7]；参照 GJB 8000A—2013 《军用软件研制能力等级要求》 软件重要性等级由高到低通常分为 I、Ⅱ、Ⅲ、Ⅳ，软件规模分为巨、大、中、小、微5级[8]，软件分级对应关系如下：

a）关键软件通常包括A级软件、I级软件；

b）重要软件通常包括B级软件、Ⅱ级软件；

c） 一般软件通常包括 C、D 级软件，以及Ⅲ级、Ⅳ级软件。

4.2　剪裁思路

剪裁的主要形式包括文档剪裁、章节剪裁和内容合并等。剪裁时应考虑软件的重要性等级和软件规模等，具体剪裁方法如下。

a） 需求牵引：根据项目的实际需求 （通常是合同或技术协议中规定的） 确定哪些文档是必须拟制的，哪些文档是可以剪裁或合并的。

b） 过程剪裁：根据GJB 5000B的实施指南和项目选择的全生命周期开发模型，对软件开发过程进行剪裁，同步调整相关软件文档的内容和格式。

c） 模板定制：基于剪裁后的文档要求，定制符合标准的文档模板，规范文档的编制和管理。

d） 评审反馈：组织同行专家对剪裁后的文档进行评审，收集反馈意见，持续迭代完善剪裁策略、方法。

4.3　剪裁矩阵

针对上述7大类软件文档，建立基于信息系统软件开发文档的剪裁矩阵，具体如表9~15所示。