GJB 438C-2021《军用软件开发文档要求》全面解析（落地版）

GJB438C-2021《军用软件开发文档通用要求》全面解析（落地版）适用场景：军工软件项目研制、GJB5000B三级/四级内审、二方审核、军方测评、验收归档、项目合规落地替代关系：2022年3月实施，替代GJB438B-2009配套标准：对接GJB2786A-2021《军用软件开发通用要求》、GJB5000B-2021《军用软件能力成熟度模型》一、标准定位与核心作用1.1标准定义GJB438C-2021是军用软件全生命周期文档编制的顶层通用规范，规定了军用软件研制文档的种类、组成、通用格式、编制规则、各文档详细内容要求，明确纸质、电子、数据库格式文档的合规准则。该标准不规定软件开发技术方法，只规定过程输出物（文档）的合规性、完整性、可追溯性、可审计性，是军工软件验收、测评、贯标审查的核心依据。1.2核心价值1.统一全军工软项目文档编制口径，解决旧版文档冗余、缺失、格式不统一问题；2.实现软件研制过程可追溯、结果可验证、证据可审计，适配GJB5000B过程管控要求；3.与GJB2786A开发活动一一对应，做到“做什么活动、出什么文档”；4.支持电子化、数据库化文档归档，适配军工数字化研制转型。1.3适用范围适用于军用各类软件（系统软件、应用软件、嵌入式软件、测控软件、仿真软件）的研制、升级、维护、定型验收文档编制；也适用于军工配套单位、外协单位软件文档合规管控。二、GJB438C-2021与438B-2009核心差异（重点变更）本次换版为结构性升级，适配2021版军软体系（2786A+5000B），核心变化如下：2.1整体架构优化1.新增文档数据库、电子化格式规范，不再局限于传统纸质文档；2.明确页号、页标记、版本标识、签署、追溯标识的统一要求；3.精简冗余文档内容，取消重复章节，强化“按需编制、适度剪裁”原则。2.2重点文档内容修订（高频考点/审核重点）1.系统/子系统设计说明新增系统体系结构设计专项要求，明确需说明设计假设、系统状态依赖、禁止重复设计原则；强化内外接口设计、部件间接口设计决策描述。2.接口需求规格说明、接口设计说明细化外部接口、内部部件接口、数据交互、协议约束、异常处理、接口兼容性要求，杜绝接口描述模糊、无边界定义问题。3.软件测试计划、测试说明强化测试策略、测试层级、覆盖性要求、回归测试、风险测试、数据测试要求，适配测评中心审查标准。4.数据库设计说明新增数据库范式、数据字典、数据安全、数据备份、数据一致性、权限管控编制要求。5.软件研制总结报告强制要求增加过程符合性、问题闭环、基线管控、配置管理、合规性自查内容，成为验收核心终审文档。2.3管控理念升级从“重格式、重篇幅”转向重证据、重追溯、重闭环、重适配，文档必须真实反映研制过程，杜绝套模板、空内容、前后矛盾。三、GJB438C、GJB2786A、GJB5000B三者逻辑关系（必懂）1.GJB2786A-2021：规定军用软件开发活动（做什么），包含工程、管理、支持全流程活动；2.GJB438C-2021：规定开发活动对应的输出文档（产出什么、怎么写）；3.GJB5000B-2021：规定软件企业能力成熟度（过程怎么管、怎么落地、怎么持续改进）。总结：5000B定体系、2786A定过程、438C定交付文档，三者必须统一适配、闭环对应。四、GJB438C-2021标准文档清单（全套官方文档）标准明确了军用软件全生命周期必备文档，可根据项目规模（小型/中型/大型）、安全等级、研制阶段合规剪裁，禁止私自增删核心文档。4.1立项与策划类文档1.软件研制任务书2.软件开发计划3.软件质量保证计划4.软件配置管理计划4.2需求分析类文档1.系统/子系统规格说明2.软件需求规格说明（SRS）3.接口需求规格说明4.数据需求说明4.3设计类文档1.系统/子系统设计说明2.软件设计说明（概要+详细设计）3.接口设计说明4.数据库设计说明4.4测试与验证类文档1.软件测试计划2.软件测试说明（用例、规程）3.软件测试报告4.软件问题报告、问题闭环记录4.5交付与运维类文档1.软件用户手册2.软件维护手册3.软件运行方案说明4.6总结归档类文档1.软件研制总结报告（验收必审）2.软件版本说明五、通用编制要求（所有文档必须遵守）5.1格式通用要求1.统一封面、扉页、签署页、目录、版本页、更改记录；2.全文统一页号、页标记、章节编号体系；3.所有变更必须留痕，设置更改单号、更改内容、更改人、审核人、日期；4.电子文档、数据库文档需保证不可篡改、可追溯、可归档、可检索。5.2内容通用要求1.唯一性：每条需求、设计、测试项唯一标识，杜绝重复、歧义；2.可验证性：所有指标、功能、性能、接口必须可测试、可量化、可验证；3.一致性：前后文档无矛盾，需求、设计、测试、交付一一对应；4.完整性：无缺项、无空白章节、无关键内容缺失；5.追溯性：实现需求→设计→代码→测试→问题闭环全链路追溯。5.3签署与版本要求1.所有正式文档必须完成编制、审核、批准、标准化审查签署；2.版本迭代清晰，V1.0、V1.1、V2.0区分初始版、修改版、升版；3.作废文档必须标识作废，禁止混用新旧版本。六、核心重点文档编制细则（审核高频关注点）6.1软件需求规格说明（SRS）1.必须包含：功能需求、性能需求、接口需求、数据需求、安全保密需求、可靠性需求、可维护性需求、环境需求；2.所有需求量化、无模糊描述，每条需求可对应测试用例；3.明确需求优先级、需求来源、变更记录；4.禁止出现“大概、可能、尽量、适当”等非量化表述。6.2系统/软件设计说明1.必须明确系统体系结构、分层架构、模块划分、设计原则、设计假设；2.内外接口、模块间接口全部定义完整，包含协议、数据格式、交互时序、异常处理；3.设计必须100%覆盖需求，无需求外冗余设计、无需求漏设计；4.新增架构设计合理性说明、无重复设计说明。6.3软件测试计划与测试报告1.测试层级清晰：单元测试、集成测试、配置项测试、系统测试分层说明；2.明确测试覆盖性要求、回归测试策略、风险测试方案；3.测试报告必须完整记录问题、整改、复测、闭环证据；4.覆盖所有功能、性能、接口、安全、边界、异常场景。6.4软件研制总结报告（验收核心）必须包含：研制过程综述、需求完成情况、设计实现情况、测试验证情况、配置管理执行情况、质量保证情况、问题整改闭环、合规性自查、遗留问题及处理方案、结论。七、文档剪裁规则（合规可裁剪范围）GJB438C-2021支持项目适度剪裁，禁止盲目全套照搬或随意删减核心文档：1.小型简单软件：可合并部分管理计划、简化数据库文档、精简架构描述；2.无数据库软件：可删减数据库设计说明，但需在剪裁报告中说明；3.迭代升级项目：可复用历史基线文档，重点新增变更、差异、验证内容；4.绝对不可剪裁：需求规格、设计说明、测试计划/报告、研制总结、版本说明。八、常见不合规问题（审核高频扣分点）1.文档新旧版本混用，沿用438B旧模板，未适配2021新版架构、新增章节；2.需求不可量化、不可验证，无唯一标识，无法对应测试；3.架构设计缺失、接口描述不全，无内外接口区分；4.文档前后矛盾，需求、设计、测试不匹配，追溯链路断裂；5.变更无记录、无审批、无闭环，更改留痕缺失；6.电子化文档无版本管控、无防篡改、无归档记录；7.研制总结报告内容空洞，未体现过程合规性、问题整改情况。九、落地实施建议（适配GJB5000B贯标+军方验收）1.统一替换438C新版模板，废除所有438B旧模板，企业标准化固化；2.建立文档编写-审核-对标-闭环四级审查机制，重点核查新增架构、接口、安全、追溯要求；3.全程落实需求追溯矩阵，保证需求、设计、代码、测试全覆盖；4.电子化文档实行版本管控、权限管控、备份管控、防篡改管控；5.每阶段输出文档同步完成审查记录、问题整改记录，作为5000B过程