配置状态记录要能回答四个问题:受控对象是什么、当前处于哪个版本和状态、状态由谁在何时依据什么变更产生、变更后如何核验。围绕这四点,记录至少保留配置项标识与名称、所属基线与版本号、当前状态、变更单号与原因、变更人与审批人、生效时间、验证或评审证据、存放位置与访问权限。下面按“对象—版本—状态—变更—证据”五组给出字段清单、记录步骤、角色分工、填写示例和检查项,可直接用于建表或完善现有记录模板。
要点总览(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 方案为例,其围绕需求、基线、版本和变更建立统一管理对象,支撑过程状态追踪和交付结果回溯,可作为记录载体;具体字段与流转规则需在方案基础上自行配置,并在选型阶段核实实际部署中的功能范围。
