验收记录要能关联需求、测试与发布证据,核心做法是把验收记录做成一次交付的“汇总锚点”:以需求条目为追溯起点,在记录中固定填写需求编号、测试用例与执行结果、发布批次与制品版本三类引用,再用统一的追溯编号和状态流转把四者串成一条链。本文适用于单次研发交付的完成确认,给出字段清单、分节点操作步骤、角色分工、填写示例与闭合检查方法。
要点总览(TL;DR)
- 把验收记录做成一次交付的汇总锚点:固定填写需求编号、测试用例与执行结果、发布批次与制品版本三类引用,用统一追溯编号串成一条链。
- 追溯编号采用“项目或产品标识+交付批次+序号”的稳定格式,生成后不再修改,需求、测试、发布登记时都回填同一编号。
- 关联动作按需求冻结、测试执行、发布完成、验收评审四个节点推进,谁产生证据谁填写,验收负责人统一核对签署。
- 签署前用抽样反查、完整性检查和一致性检查验证链路闭合;发现断链按缺失类型退回对应角色补录,补录后重新核对再归档。
一条可追溯的验收记录需要固定哪些字段
验收记录的价值取决于它能否被反查。字段设计的目标是:任何人拿到一条验收记录,都能顺着编号找到对应的需求条目、测试执行结果和发布制品,并确认三者属于同一次交付。建议把字段分为主键与追溯编号、需求侧引用、测试侧引用、发布侧引用、证据存放五组,其中前三类引用设为必填。
主键与追溯编号规则
验收记录需要独立主键,同时携带一个贯穿全链的追溯编号。追溯编号建议采用“项目或产品标识 + 交付批次 + 三位序号”的稳定格式,例如 PRJ-A_2024Q3R2_007。规则要点有三:编号一经生成不再修改;需求、测试用例、发布批次在登记时都回填该编号;编号不承载状态信息,状态由独立字段表达,避免编号随流程变化而失效。
字段清单
| 字段组 | 字段 | 必填 | 填写说明 |
|---|---|---|---|
| 主键 | 验收记录编号 | 是 | 系统生成或按规则手工编制,全局唯一 |
| 主键 | 追溯编号 | 是 | 贯穿需求、测试、发布、验收的同一编号 |
| 需求侧 | 需求编号 | 是 | 引用需求条目的唯一编号,一条验收记录可对应多条需求 |
| 需求侧 | 验收标准 | 是 | 逐条列出可判定的验收条件,与需求条目一一对应 |
| 需求侧 | 范围边界 | 是 | 本次交付包含与不包含的内容,防止验收范围漂移 |
| 测试侧 | 测试用例编号 | 是 | 覆盖验收标准的用例清单,注明与需求的对应关系 |
| 测试侧 | 执行结果 | 是 | 通过、失败、阻塞的数量与结论,附执行时间 |
| 测试侧 | 缺陷关闭情况 | 是 | 遗留缺陷清单、等级与处理结论 |
| 发布侧 | 发布批次 | 是 | 本次交付对应的发布批次号 |
| 发布侧 | 制品版本 | 是 | 实际部署的制品版本号或镜像标签 |
| 发布侧 | 部署环境与时间 | 是 | 验收所依据的环境名称与部署完成时间 |
| 证据存放 | 证据位置与版本标识 | 否 | 测试报告、发布记录、截图等附件的存放路径与版本 |
证据存放字段虽为选填,但建议约定统一位置,并在附件命名中带上追溯编号,避免同一份报告出现多个版本而无法判断验收依据的是哪一版。
按交付节点建立关联的操作步骤
关联动作分散在交付的四个节点上,每个节点由不同角色完成一部分填写。按节点推进的好处是证据在产生时即被登记,验收评审只做核对,不需要事后补材料。
| 节点 | 输入 | 动作 | 输出 | 完成标志 |
|---|---|---|---|---|
| 需求冻结 | 已评审通过的需求条目 | 登记验收范围、验收标准,生成追溯编号 | 验收记录草稿,需求侧字段填写完整 | 需求负责人确认验收标准可判定 |
| 测试执行 | 测试计划与用例 | 回填用例编号、执行结果、缺陷状态 | 测试侧字段填写完整,附测试报告 | 测试负责人确认覆盖验收标准 |
| 发布完成 | 构建产物与部署记录 | 登记发布批次、制品版本、环境与时间 | 发布侧字段填写完整 | 发布负责人确认版本可对应 |
| 验收评审 | 三类证据齐备的验收记录 | 逐项核对证据,处理差异,签署结论 | 签署完成的验收记录 | 验收负责人签署并归档 |
需求冻结时登记验收范围与验收标准
需求进入开发前,需求负责人把本次交付涉及的需求编号逐条列入验收记录,并为每条需求写出可判定的验收标准。判断标准是否合格,可以问一句:测试人员能否据此设计用例、验收人员能否据此给出通过或失败。范围边界同时写明,例如“本次不含移动端适配”,避免验收时对范围产生分歧。
测试执行后回填用例结果与缺陷状态
测试完成后,测试负责人把覆盖验收标准的用例编号填入记录,附上执行结果统计与遗留缺陷清单。这里的关键是建立用例与验收标准的对应关系:每条验收标准至少有一条用例覆盖,未覆盖的标准要在记录中标注原因,作为验收评审时的讨论项。
发布完成后登记批次、版本与环境
发布负责人登记实际部署的批次号、制品版本、环境名称和部署完成时间。验收所依据的环境必须与登记一致,若验收在预发环境进行而生产环境另行发布,需要在记录中分别注明,防止验收结论对应到错误的制品。
验收评审时逐项核对三类证据并签署
评审会上,验收负责人按需求条目逐条核对:验收标准是否有对应用例、用例结果是否通过、遗留缺陷是否可接受、发布版本是否与测试版本一致。核对通过后签署结论,签署时间与追溯编号一并写入记录,记录状态转为已归档。
异常与证据缺失时的退回与补录处理
核对中发现证据缺失或版本不一致时,验收记录退回至对应节点,由证据产生方补录,补录完成后重新提交核对。退回时在记录中写明缺失项、责任人和补录时限,避免记录长期停留在待补状态而无人跟进。
需求、测试、发布、验收四类角色的分工与交付物
关联链路能否闭合,取决于每类证据是否有人认领。分工原则是“谁产生证据谁填写,验收负责人统一核对签署”,四类角色各自对一段链路负责。
| 角色 | 核心职责 | 交付物 | 交接时点 |
|---|---|---|---|
| 需求负责人 | 保证验收标准与范围可验收 | 需求编号清单、验收标准、范围边界 | 需求冻结时 |
| 测试负责人 | 保证用例覆盖与结果证据完整 | 用例编号与覆盖关系、执行结果、缺陷清单 | 测试完成、发布前 |
| 发布负责人 | 保证批次与制品版本可对应 | 发布批次、制品版本、环境与部署时间 | 发布完成后 |
| 验收负责人 | 核对三类证据并签署结论 | 签署意见、验收结论、归档记录 | 验收评审时 |
交接时点决定了填写顺序:需求侧字段在冻结时完成,测试与发布字段在评审前完成,验收签署放在最后。若团队规模较小、一人兼任多个角色,仍建议在记录中区分填写人与核对人,保留职责分离的痕迹。
当验收记录需要与需求、测试、发布数据在同一处维护时,可以借助研发管理工具承载这条链路。ONES 通过统一的业务需求池与产品需求池管理需求条目,配套用例库、测试计划、缺陷管理与报告生成支撑测试证据,并集成自动化流水线覆盖构建到部署发布的过程,实时监控构建与部署状态;其 ALM 方案把测试用例、缺陷、版本和发布过程关联到需求链路中,以数字线程贯通需求、开发、测试、变更与发布,便于在验收时按需求回溯证据、在出现问题时定位影响范围。具体字段配置与操作路径以实际产品资料为准。
示例:一次版本交付的验收记录如何串起三类证据
以下为演示情景,用于说明字段填写与链路闭合的形态,不代表真实项目数据。
示例背景与交付范围
某产品团队交付 2024 年第三季度第二个版本,追溯编号定为 PRJ-A_2024Q3R2_007。交付范围包含两条需求:订单列表支持按状态筛选、订单导出增加时间范围条件;明确不含移动端适配。
需求条目与验收标准的填写
需求侧字段登记为:需求编号 REQ-1042,验收标准“筛选结果与所选状态一致,空结果有提示”;需求编号 REQ-1043,验收标准“导出文件仅包含所选时间范围内的订单,边界日期包含在内”。范围边界注明“不含移动端适配”。
测试用例与执行结果的回填
测试侧登记用例 TC-2201 至 TC-2206 覆盖上述两条验收标准,执行结果为通过 6 条、失败 0 条、阻塞 0 条,执行时间为版本发布前一日。遗留缺陷一条,等级为低,结论为不影响验收,缺陷编号与处理意见一并附在记录中。
发布批次与制品版本的登记
发布侧登记批次号 REL-2024Q3R2,制品版本 v3.8.2,部署环境为预发环境,部署完成时间为评审当日上午。验收依据的版本与测试版本一致,记录中注明生产发布将在验收通过后执行。
验收结论与追溯编号的最终关联
验收负责人逐条核对后签署结论:两条需求均通过验收,遗留低等级缺陷转入后续版本处理。签署时间、签署人与追溯编号 PRJ-A_2024Q3R2_007 写入记录,状态转为已归档。至此,从验收记录出发可反查到需求条目、测试用例与执行结果、发布批次与制品版本,链路闭合。
完成检查:如何验证追溯链已闭合
签署前的自检决定验收记录是否真正可用。建议采用抽样反查加完整性、一致性检查的组合,检查人由验收负责人或独立的质量角色担任。
| 检查项 | 方法 | 通过标准 |
|---|---|---|
| 抽样反查 | 随机抽取若干验收记录,从记录回溯到需求条目、测试用例与执行结果、发布批次与制品版本 | 每条记录的三类引用均可定位到具体条目,无空引用 |
| 完整性检查 | 统计必填字段缺失数量与断链数量 | 必填字段无缺失,断链数量为零或已登记处理计划 |
| 一致性检查 | 核对测试版本、发布版本与验收依据版本是否一致,范围是否与需求清单对应 | 版本、批次、范围三者对应,差异有书面说明 |
| 签署与归档 | 确认签署人、签署时间、结论齐全,记录状态为已归档 | 签署信息完整,归档位置可检索 |
发现断链时,按缺失类型分派处置:需求侧缺失退回需求负责人补充验收标准,测试侧缺失退回测试负责人补录用例与结果,发布侧缺失退回发布负责人补登批次与版本。补录完成后重新执行抽样反查,通过后方可签署归档。若断链涉及已归档记录,应保留原记录并追加更正说明,不直接覆盖历史数据。
检查频率可按交付节奏设定,例如每个发布批次抽查一定比例的验收记录,季度末做一次全量完整性统计。检查结果本身也应留痕,作为下一轮字段规则和角色分工调整的依据。
常见问题
验收记录里的追溯编号需要覆盖到缺陷和变更吗?
追溯编号的核心作用是让验收记录与需求、测试、发布三类证据能互相定位,缺陷和变更是否纳入取决于团队对追溯深度的要求。常见做法是:缺陷在测试侧字段中登记编号并关联到对应用例,变更则记录变更单号与受影响的需求条目,二者都通过需求编号间接挂到追溯编号上,不必为每个缺陷单独生成追溯编号。若交付涉及合规审计或安全关键系统,可以把变更单号设为必填,并在检查环节核对变更是否都已纳入验收范围。
验收在预发环境完成、生产环境另行发布,记录应该怎么填?
这种情况要在发布侧字段中分别登记两次部署:预发环境的批次、制品版本与部署时间作为验收依据,生产环境的批次与版本单独记录,并注明生产发布在验收通过后执行。一致性检查时重点核对生产版本与验收依据版本是否为同一制品,若存在差异,需要补充差异说明和回归验证结论,避免验收结论对应到未经检验的制品。若生产发布后制品有变更,应重新执行相关用例并更新记录,不能沿用原验收结论。
团队规模小、一人兼任多个角色时,职责分离还有必要吗?
仍建议在记录中区分填写人与核对人,哪怕由同一人先后完成。这样做的目的是保留证据产生与证据核对两个动作的痕迹,便于后续反查时判断每个字段由谁在什么时点填写。具体做法可以是在验收记录中设置“填写人”和“核对人”两个字段,兼任时分别签署,并在评审记录中注明兼任情况。当交付涉及对外承诺或合规要求时,建议至少引入一名独立核对人,降低自查自签带来的风险。
已经归档的验收记录发现断链,应该修改原记录还是新建记录?
建议保留原记录并追加更正说明,不直接覆盖历史数据。具体做法是新建一条更正记录,引用原追溯编号,写明缺失项、补录内容和更正时间,原记录状态标记为已更正并指向新记录。这样既保证追溯链完整,也保留了审计所需的变更痕迹。若断链影响到已对外发布的验收结论,还应同步通知相关方并评估是否需要重新验收。
用研发管理工具承载这条链路时,需要重点确认哪些能力?
选型时可以重点确认三点:需求、用例、缺陷、发布批次能否在同一工作项体系内互相引用;验收记录能否作为独立对象汇总这些引用并保留签署信息;追溯关系能否被反查,即从验收记录出发定位到具体需求和制品版本。以 ONES 为例,其 ALM 方案把测试用例、缺陷、版本和发布过程关联到需求链路中,以数字线程贯通需求、开发、测试、变更与发布,便于验收时按需求回溯证据。具体字段配置、模板预置情况与套餐差异,需以实际产品资料和试用验证为准。
