用途
Procore 可恢复数据迁移（Procore Resumable Data Migration）用于把 Procore 记录迁移当作一个有序、可观测、可回滚的程序来执行，而不是简单的批量请求循环。它要求使用有文档依据的资源契约、稳定的外部身份、受支持的同步操作，以及独立的文件工作流，同时保留租户和项目边界。
主要能力
- 资源盘点与映射：按公司、项目、资源、状态和依赖关系统计记录与文件数量，映射必填字段、编码、用户、位置、权限、时间戳和外部标识符。
- 稳定身份设计：仅在资源支持时使用有文档依据的 origin_id 或等价标识，定义源到 Procore 的映射、冲突处理和可重放安全的唯一性规则。
- 依赖排序：先创建前置的公司和项目数据，再创建依赖记录；遵循有文档依据的 API 调用顺序，并将不支持的资源隔离出来单独处置。
- 可恢复执行：处理有界批次，遵循速率响应头，在验证提交后设置检查点，仅对受支持资源使用同步操作；文件通过其独立的有文档依据的上传与关联流程传输。
- 持续对账：按批次比较数量、关键字段、关系、文件校验和、失败、重复项和状态哈希；隔离问题记录而不阻塞整个迁移。
- 切换与结算：执行最终增量捕获，必要时冻结写入，验证一致性，切换消费方，观察运行情况，并在约定的结算窗口关闭前保留回滚能力。
使用方式
前置条件包括：源与目标负责人、数据分类、保留策略和法律批准；资源清单、数据量、依赖图、字段映射和不支持功能列表；DMSA 或用户权限映射、速率预算、检查点存储和回滚边界。
迁移调用使用 OAuth 2.0 Bearer 令牌，针对已批准的用户或 DMSA，并明确公司和项目范围。迁移不得仅为简化依赖处理而获取宽泛权限。
工具使用纪律：使用 Read 和 Grep 检查映射、契约、检查点和核对证据；仅对已批准的迁移适配器、清单、隔离记录、测试或回执使用 Write 或 Edit；绝不将源数据放入源代码管理。
输出包括：资源映射、依赖顺序和不支持功能的处置；批次检查点、身份映射和失败隔离；一致性、切换、回滚和结算回执。返回已迁移和失败计数、检查点、差异摘要、文件验证、权限边界和下一步安全操作。
适用场景
适用于需要将 Procore 数据从源系统迁移到目标环境，且要求可恢复、可对账、可回滚的场景。示例：一次回填先创建前置项目元数据，再处理 RFI；仅在支持稳定外部身份的资源上分配该身份；通过有文档依据的文件流程上传附件；仅在数量和关系对账通过后才推进每个检查点。
限制
- 仅在资源支持时才能使用 origin_id 或等价稳定标识。
- 同步操作仅适用于受支持资源；不支持同步的资源需使用其有文档依据的端点并制定明确的幂等计划，或将其排除。
- 文件传输必须走独立的有文档依据的上传与关联流程。
- 迁移不得为简化依赖处理而获取宽泛权限。
- 源数据不得放入源代码管理。
- 错误处理：来源标识符冲突时隔离记录并解决映射归属，不得盲目覆盖；资源缺少同步支持时使用其有文档依据的端点并制定具体幂等计划或排除；批次一致性失败时停止推进检查点并核对最小差异集；速率预算下降时根据响应头暂停并从最后验证的检查点恢复。
资源
第一方来源说明、使用同步操作、API 调用顺序、直接文件上传。