检查点一：权限模型一致性验证——模型文档、实际配置、差异记录

适用场景

本检查点适用于以下场景：

• 新系统上线验收：确认权限设计文档中的模型与生产环境实际配置一致。
• 权限架构变更后回归：验证变更是否完整落地，未被遗漏或误改。
• 合规审计与第三方评估：提供模型与配置一致的客观记录。
• 跨团队交付节点：在B2B客户对接、系统集成验收时，确保权限模型无歧义。

前置条件

1. 已审批的《权限模型设计文档》（含角色树、权限矩阵、数据隔离规则）。
2. 拥有可查询生产环境权限配置的管理员账号或API访问凭证。
3. 差异记录工具就绪（例如：对比脚本、自动化差异检测平台或手动核对模板）。
4. 确认模型文档为最新版本，且版本号与验收基线一致。

操作步骤

1. 加载模型文档基线：从配置管理库中获取当前验收版本的权限模型文档，标记为 MODEL_v2.1。
2. 导出实际权限配置：在目标环境中执行全量权限导出命令，生成 ACTUAL_20250501.json。
3. 结构化对比：按角色、资源、操作三个维度进行逐项比对，可使用以下模板进行差异记录：

| 对比维度   | 模型文档值       | 实际配置值       | 差异标识 |
|------------|------------------|------------------|----------|
| 角色:admin | 资源:report      | 资源:report,sys  | 多出 sys |
| 角色:editor| 操作:read,write  | 操作:read        | 缺少write|

4. 标记差异类型：分为“多余配置”、“缺失配置”、“值不一致”、“结构不一致”，写入差异记录表。
5. 根因分析：对每条差异判断是文档过时、配置误操作、还是未经变更流程的临时调整。
6. 生成一致性验证报告：包含对比结果、差异列表、风险等级、处置建议。

输入输出物

责任边界

• 权限架构师：提供模型文档基线，确认差异根因，决定是否修订模型。
• 运维/平台管理员：执行实际配置导出，配合执行临时性配置修复。
• QA验证工程师：执行结构化对比，填写差异记录表，生成一致性报告。
• 变更控制委员会（CCB）：对等级为“严重”的差异进行仲裁，审批处置方案。

记录材料

1. 差异记录表：包含每条差异的ID、对比维度、模型值、实际值、差异类型、风险等级、发现人、发现时间。
2. 比对脚本或工具日志：若使用自动化工具，保留执行日志与配置快照。
3. 一致性验证会议纪要：记录异常项讨论结果与处置决议。

异常处理

验收标准

• 所有差异项均已记录，且每条差异项均有处置结论（确认一致、修改配置、更新文档）。
• 不存在“严重”等级的未处置差异（例如：重要角色权限缺失或越权）。
• 一致性验证报告已通过权限架构师、QA验证工程师双方签字确认。
• 模型文档版本号与实际配置导出版本的时间戳差值不超过 7 天（合规窗口期）。