配置状态记录需要保留哪些信息:字段清单与记录步骤

配置状态记录要能回答四个问题:受控对象是什么、当前处于哪个版本和状态、状态由谁在何时依据什么变更产生、变更后如何核验。围绕这四点,记录至少保留配置项标识与名称、所属基线与版本号、当前状态、变更单号与原因、变更人与审批人、生效时间、验证或评审证据、存放位置与访问权限。下面按“对象—版本—状态—变更—证据”五组给出字段清单、记录步骤、角色分工、填写示例和检查项,可直接用于建表或完善现有记录模板。



要点总览(TL;DR)


  • 配置状态记录按“对象—版本—状态—变更—证据”五组字段组织,每条记录要能回答受控对象是什么、当前版本与状态、变更依据与审批人、核验证据在哪里。
  • 记录随配置项生命周期持续追加:登记入库、状态流转关联变更单、基线发布留存快照、归档后历史条目不可覆盖。
  • 登记维护、审批、核验三类动作由不同角色承担,开发负责人提交变更、审批人给出结论、测试或验证角色完成核验,配置管理员统一更新状态。
  • 检查记录是否合格,从字段完整性、状态与变更单一致性、基线与快照可追溯三方面逐项判断,发现阻断项先整改再进入下一基线。


配置状态记录的核心字段清单


配置状态记录的最小可用结构是五组字段:对象、版本、状态、变更、证据。五组字段分别对应一个追溯问题,缺一组就会在回溯时出现断点。例如只有对象和版本,能查到“现在是什么”,却说不清“为什么变成这样”;只有变更记录而没有证据字段,评审结论无法复核。


下表按组列出字段、必填程度与用途。必填程度分为“必填”和“按受控级别选填”:合规要求高、交付审计频繁的项目宜全字段必填;内部迭代型项目可精简证据类字段,但对象、版本、状态、变更单号四项建议始终保留。


字段组 字段 必填程度 作用与对应追溯问题
对象 配置项标识(唯一编号) 必填 唯一锁定受控对象,避免同名混淆
配置项名称 必填 供人阅读识别,与标识配套使用
配置项类型 必填 区分文档、代码、模型、接口定义等类别,决定后续核验方式
责任人 必填 明确该配置项的日常维护归属
版本 所属基线 必填 回答“这个版本属于哪次受控发布”
版本号 必填 回答“当前是哪一版”
基线快照标识 必填(基线发布时) 锁定发布时刻的受控组合,支撑回溯
状态 当前状态 必填 如草稿、评审中、已批准、已基线、已变更,回答“现在处于什么阶段”
状态生效时间 必填 回答“何时进入该状态”
状态变更人 必填 回答“谁推动了这次状态变化”
变更 变更单号 必填 把状态变化挂到具体变更请求上,回答“依据什么变更”
变更原因 必填 说明变更动机,供后续影响分析参考
变更发起人与审批人 必填 回答“谁提出、谁批准”,支撑职责分离
变更影响范围 按受控级别选填 记录受影响的关联配置项,便于联动核验
证据 评审或验证结论 必填 回答“变更后如何核验”,如评审通过、测试通过
证据存放位置 必填 指向评审记录、测试报告等原始材料
证据形成时间 必填 确认核验发生在变更之后
存放位置与访问权限 必填 说明记录本身存在哪里、谁可读写,保证记录可信

字段设计完成后,建议用四个问题自检一遍:拿任意一条记录,能否说出对象是什么、版本和状态是什么、变更依据和审批人是谁、核验证据在哪里。四个问题都能答上,字段清单即达到可用水平;有一项答不上,就回到对应字段组补齐。



从配置项入库到基线发布的记录步骤


记录不是一次性填表,而是随配置项生命周期持续追加的过程。以下四步覆盖从入库到基线发布的关键动作,每步给出输入、做法、输出和完成标志。


第一步:配置项识别与登记


输入是项目确定的受控范围清单,做法是为每个受控对象分配唯一标识,登记名称、类型、责任人和初始版本,输出是配置项登记条目,完成标志是该配置项在记录中可被唯一检索到,且责任人已确认。识别阶段要明确哪些对象纳入受控,范围一旦确定,后续新增受控对象也走同一登记动作。


第二步:状态流转与变更关联


输入是变更请求或评审安排,做法是每次状态变化时新增一条记录,填写新状态、生效时间、操作人,并关联变更单号和变更原因,输出是一条带变更依据的状态记录,完成标志是记录中的状态与变更单当前状态一致。状态流转采用追加方式,历史条目保持原样,不覆盖、不改写。


第三步:基线建立与快照留存


输入是达到基线条件的配置项集合,做法是确定纳入本次基线的配置项及各自版本,生成基线快照标识并写入每条记录,输出是基线清单与快照,完成标志是能通过快照标识还原发布时刻的完整受控组合。快照留存的意义在于:后续任何变更都不会改变“当时发布的是什么”。


第四步:记录归档与版本不可覆盖


输入是已完成的记录条目,做法是按配置项和基线归档,设定访问权限,输出是可检索、可审计的记录库,完成标志是任意历史条目可查、可导出,且普通角色无法修改已归档内容。归档不是流程终点,而是下一次变更追溯的起点。



角色分工与各环节交付物


记录责任悬空通常源于“谁都能改、谁都不确认”。可行的分工是把登记维护、审批、核验三类动作分开,避免同一人既发起变更又确认变更结果。下表给出角色、动作与在记录中留下的字段。


角色 主要动作 在记录中留下的字段 交付物与交接时点
配置管理员 登记配置项、维护状态条目、建立基线快照、管理归档与权限 配置项标识、名称、类型、版本号、基线快照标识、状态生效时间、存放位置 配置项登记表、基线清单;在每次状态变化和基线发布后更新
开发负责人 提出变更、说明变更原因与影响范围、提交待评审版本 变更发起人、变更原因、变更影响范围、提交版本号 变更单;在提交评审前完成填写
评审或审批人 评审变更内容、给出批准或驳回结论 审批人、评审结论、审批时间 评审记录;在评审会议或审批节点结束时签署
测试或验证角色 对变更后的配置项执行验证,提交验证结论 验证结论、证据存放位置、证据形成时间 测试报告或验证记录;在变更生效前完成核验

交接时点需要写清楚:开发负责人提交变更单后,配置管理员才更新状态为“评审中”;审批通过后,测试或验证角色完成核验,配置管理员再将状态更新为“已批准”或“已基线”。每个角色的字段在对应动作完成时填写,后一角色以前一角色的记录为输入,形成可追溯的链条。


当团队使用研发管理工具承载这些记录时,配置项、版本、变更单与评审结论可以在同一对象体系中关联。ONES ALM 方案围绕需求、基线、版本和变更建立统一管理对象,支撑过程状态追踪和交付结果回溯,可作为记录载体;字段设计与流转规则仍需团队按上表自行定义。



一个基线变更的记录示例


以下为演示情景,用于说明字段如何填写,不对应真实项目。某项目将“接口定义文档”列为受控配置项,标识为 CFG-IF-012,在 V1.2 版本时纳入基线 BL-2024-03。


变更前记录:配置项 CFG-IF-012,类型为接口文档,责任人张某,所属基线 BL-2024-03,版本号 V1.2,当前状态“已基线”,状态生效时间 3 月 10 日,状态变更人为配置管理员李某,变更单号 CR-0315,变更原因为基线发布,审批人为技术负责人王某,评审结论为“评审通过”,证据存放于项目评审库,访问权限为项目组只读。


变更发生:开发负责人提出接口字段调整,填写变更单 CR-0327,变更原因为“上游系统字段新增”,影响范围为关联的两个模块设计文档。审批人王某评审通过,测试角色完成接口联调验证并提交验证记录。


变更后记录:新增一条记录,版本号 V1.3,当前状态“已基线”,状态生效时间 4 月 2 日,状态变更人为李某,变更单号 CR-0327,变更原因同上,审批人王某,验证结论“联调通过”,证据存放位置指向验证记录,基线快照标识更新为 BL-2024-04。原 V1.2 条目保留不动,仍可通过 BL-2024-03 快照还原发布时刻的组合。


这个示例体现的规律是:每次变更新增一条记录而非修改旧记录;版本号、状态、变更单号、审批人、证据五项在一条记录内闭合;基线快照标识把版本与发布时刻绑定。迁移到自己项目时,字段名称可以调整,但“一条记录回答一次变更”的结构建议保留。



记录完成情况的检查项


检查配置状态记录是否合格,可按字段完整性、状态与变更单一致性、基线与快照可追溯性三方面逐项判断。以下清单可用于自查或评审,每项给出可核验的判断标准。


检查维度 检查项 合格标准 阻断项
字段完整性 对象字段是否齐全 标识、名称、类型、责任人四项均有值 标识缺失或重复
版本与状态字段是否齐全 版本号、当前状态、状态生效时间、状态变更人均有值 状态无生效时间
变更与证据字段是否齐全 变更单号、变更原因、审批人、验证结论、证据位置均有值 变更无审批人或无验证结论
状态与变更单一致性 记录状态与变更单状态是否一致 两边状态相同,时间顺序合理 记录显示已批准而变更单仍为待审批
变更人与审批人是否分离 发起与审批由不同角色完成 同一人既发起又审批
基线与快照可追溯 基线快照能否还原发布组合 通过快照标识可列出当时全部配置项及版本 快照缺失或与基线清单不符
历史条目是否可查且未被覆盖 任意历史版本可检索、可导出 旧记录被改写或删除

检查中发现阻断项时,先整改再进入下一基线:字段缺失的补齐并注明补录时间;状态与变更单不一致的,以变更单为准修正记录并保留修正说明;快照缺失的,依据归档材料重建快照并标注重建来源。非阻断项如影响范围未填,可在下一次变更时补全,不阻断基线发布。


记录合格与否最终看能否支撑回溯:任取一条基线,能沿记录查到每个配置项的版本、状态、变更依据和核验证据,这份配置状态记录即达到可追溯要求。



常见问题


内部迭代型项目字段可以精简到什么程度?


可按受控级别调整必填范围。合规要求高、交付审计频繁的项目宜全字段必填;内部迭代型项目可精简证据类字段,例如影响范围、部分证据描述。对象、版本、状态、变更单号四项建议始终保留,这四项缺失会让记录无法回答“谁在何时依据什么把什么改成了什么”。精简后仍要保证每次变更新增一条记录,历史条目不被覆盖。


变更单被驳回或撤回时,配置状态记录怎么处理?


驳回或撤回同样是一次状态变化,建议新增一条记录,状态写为“变更驳回”或“变更撤回”,关联原变更单号,填写审批人、结论和时间,原记录保持不动。这样回溯时能看到一次变更请求的完整走向,而不是只留下最终通过的版本。若变更单后续重新提交,以新单号或新版本记录,避免同一单号对应多个互相矛盾的状态。


基线发布后才发现记录字段缺失,还能补吗?


可以补录,但要保留补录痕迹。做法是补齐缺失字段并注明补录时间和补录人,不直接改写原条目内容;若涉及快照缺失,依据归档材料重建快照并标注重建来源。补录属于整改动作,检查时应把补录说明一并纳入核验,避免补录掩盖真实的状态不一致问题。


配置状态记录和需求变更记录如何衔接?


两者通过变更单号衔接。需求版本的具体变更流程归需求变更与版本管理,配置状态记录只保留与受控配置项相关的变更单号、变更原因、审批人和生效时间,指向需求侧记录即可,不重复维护需求变更的完整过程。这样既保持追溯链条完整,也避免同一变更在两处各记一套、口径不一致。


用研发管理工具承载记录时,字段设计还要自己做吗?


需要。工具提供的是承载对象和关联关系,字段分组、必填规则、状态取值和审批流转仍要团队按自身受控级别定义。以 ONES ALM 方案为例,其围绕需求、基线、版本和变更建立统一管理对象,支撑过程状态追踪和交付结果回溯,可作为记录载体;具体字段与流转规则需在方案基础上自行配置,并在选型阶段核实实际部署中的功能范围。