DataOps-platform/docs/runbooks/P2_WP12_THIRD_DOMAIN_REPLICATION_GUIDE.md

P2-WP12 第三业务域复制实施指南

1. 适用范围

本指南用于在不复制设备域或物料域服务的前提下，将 P2-WP12 实施包复用到第三业务域。 复制操作应在独立目录和隔离环境完成，不得直接覆盖已验收的第二业务域包。

2. 准备门禁

开始前必须取得：业务域范围与 Owner、Data Steward 和 UAT 用户；经批准的只读数据源、 字段字典、主键与增量游标；正式术语/代码集/指标；质量阈值、整改时限和 SLO；数据产品 合同及 Agent 允许的 API/MCP、动作和证据要求。秘密只保存于企业密钥系统，不写实施包。

3. 复制步骤

1. 复制 docs/phase2/p2-wp12-spare-parts-package/ 到新的领域目录，修改包编码和领域编码；
2. 用领域模板初始化对象类型、责任角色、术语/代码集、规则、指标和任务配置；
3. 生成最小脱敏快照与严格单调的增量样本，声明主键、必填列、操作字段和游标字段；
4. 通过通用接口建立目录、语义、责任、质量、整改、可观测、数据产品和 Agent 证据；
5. 为每个阶段填写 passed 收据、通用 API 引用、证据引用和可验证指标；
6. 更新 Manifest 文件摘要，记录相对当前基线的通用扩展和设备专用代码改动；
7. 执行领域复制验证器，两次输出必须字节一致，增量重放必须为 0 变更；
8. 在企业隔离 PostgreSQL 和批准的数据源上执行定向集成及端到端 UAT；
9. 归档验收报告、缺陷清单、回滚证据和签认结果，由阶段验收负责人批准。

4. 验证命令

.venv/bin/python scripts/validate_domain_replication.py \
  --package-dir <第三业务域实施包目录> \
  --output <隔离输出目录>/acceptance-report.json

验证报告只允许包含计数、游标、摘要和规范化证据引用。若输出出现源数据值、令牌、密码、 连接串或其他秘密，应立即停止验收、隔离产物并重新执行脱敏与密钥处置。

5. 平台化缺口处理

• 能用模板或配置表达的差异，留在领域实施包；
• 确需通用扩展时，先定义跨领域契约和失败关闭规则，再修改平台核心；
• 若需要调用或修改设备/物料专用服务，应登记为平台化缺口，不能隐藏在领域代码中；
• 任何通用扩展都必须补充独立测试、发布副本同步、迁移/回滚说明和现有领域兼容验证；
• 不得为了让报告通过而伪造企业负责人、真实来源、告警回执或用户验收。

6. 完成标准

十个阶段全部通过、设备专用核心改动为 0、相同增量重放为 0 变更、数据产品合同与合格证 证据完整、Agent 只读/建议场景受授权且跨域拒绝，并由企业真实责任人完成 UAT 后，第三 业务域复制才可标记为业务验收完成。仅通过本地样本时，成熟度应记录为“工程完成，待企业 数据与业务验收”。