4. 清单化验收定义：验收清单的组成要素、清单化验收与自动化测试的关系、清单在流水线中的位置

清单化验收是 GitOps 交付流水线中，将“声明式差异检测”结果与预定义的验收标准进行结构化比对的过程。它不是简单的“通过/不通过”二值判断，而是一套可追溯、可审计、可重复的验收契约。本节将定义验收清单的组成要素，厘清其与自动化测试的边界与协同关系，并明确清单在流水线中的物理位置与执行时机。

4.1 验收清单的组成要素

一份完整的验收清单（Acceptance Checklist）由以下五个核心要素构成，缺一不可：

4.2 清单化验收与自动化测试的关系

清单化验收与自动化测试是互补关系，而非替代关系。两者在交付流水线中承担不同的质量保障职责：

4.3 清单在流水线中的位置

验收清单在 GitOps 发布流水线中位于“差异检测”与“发布审批”之间，是交付前的最后一道自动化质量门。其典型位置如下图所示：

4.4 清单在流水线中的执行流程

验收清单在流水线中的执行遵循以下步骤，确保每个检查项都被正确评估：

1. 加载清单：从 Git 仓库中读取 checklist.yaml 文件，解析所有检查项。
2. 匹配差异：将每个检查项的“差异检测规则”与声明式差异检测结果进行匹配。
3. 评估等级：根据匹配结果和严重等级，生成每个检查项的通过/阻断/警告状态。
4. 生成报告：输出验收清单报告，包含每个检查项的状态、差异详情、建议操作。
5. 决策执行：
   • 所有 blocker 项通过 → 流水线继续，进入发布审批。
   • 存在 blocker 项不通过 → 流水线阻断，输出差异报告。
   • 仅 warning 项不通过 → 流水线继续，但标记为“需人工确认”。

4.5 清单化验收的典型输出示例

以下是一个验收清单执行后的输出示例，展示了每个检查项的评估结果：

# 验收清单执行报告
# 流水线 ID: PL-2025-04-15-001
# 差异检测 Commit: abc123def456

检查项 ID       | 描述                          | 等级      | 状态   | 差异详情
----------------|-------------------------------|-----------|--------|--------------------------
CHK-DEPLOY-001  | Deployment 副本数一致性       | blocker   | ✅ 通过 | 差异数: 0
CHK-DEPLOY-002  | Service 端口映射一致性        | blocker   | ✅ 通过 | 差异数: 0
CHK-CONFIG-001  | ConfigMap 数据完整性          | blocker   | ❌ 阻断 | 差异数: 2 (key: db_url)
CHK-SECRET-001  | Secret 引用有效性             | warning   | ⚠️ 警告 | 差异数: 1 (secret 不存在)
CHK-NETPOL-001  | NetworkPolicy 规则一致性      | info      | ℹ️ 信息 | 差异数: 0

阻断原因: CHK-CONFIG-001 不通过，ConfigMap 数据与期望状态存在差异。
建议操作: 检查 ConfigMap 中 db_url 的配置值，确认是否需要更新期望状态。