上线检查清单

在为生产设施启用合作伙伴集成之前，请使用此检查清单。

Partner Console 设置

• 您的合作伙伴资料已填写完整。
• 您的徽标 URL、网站、类别和说明准确无误。
• 已配置您的数据关联方式：Direct Link 或 Linking Identifier。
• 已至少使用一个真实设施测试设施关联。
• 正在使用正确的密钥类型：
  • Dryrun：用于非破坏性的写入测试。
  • Read-only：用于安全地使用数据。
  • Live：仅在您准备好影响生产数据时使用。

身份验证和密钥管理

• 密钥仅存储在服务器端。
• 密钥未嵌入客户端应用程序、移动应用、公共代码库或支持工单中。
• 已测试密钥轮换和吊销。
• 您的团队清楚每个环境使用的是哪个密钥。

数据验证

• 您调用的每个端点的必填字段均已提供。
• 设施标识符与您配置的关联方式相符。
• 来自您系统的 ID 稳定，不会在多次同步之间发生变化。
• 大规模导入已按文档所述的限制拆分为批次。
• 可以识别并重新发送失败的批次项目。

端点测试

上线前，请测试您的集成所依赖的每个端点：

• 可以读取组织和设施。
• 可以保存和更新会员。
• 会员计划、访问区域和访问时间可正确同步。
• 签到被接受，并可关联回您的系统。
• 报告快照使用预期的报告周期和指标。
• 在适用情况下，已在真实硬件上测试门/闸机控制器流程。

Access Time Window 准备情况

如果集成提供 Access Time Windows：

• 绝对时间窗口和每周时间窗口示例均通过生产方认证检查清单。
• 纪元时间为不带引号的整数 Unix 秒；已测试精确的 [from, to) 边界。
• 已验证 UTC 默认值、集成的自定义 IANA 时区以及相关的夏令时切换。
• 使用一个持久的、单调递增的会员/源修订序列来协调增量更新、对账和重试。
• 运营人员了解省略、完全替换、幂等、冲突、过时以及显式 [] 的行为。
• 每个 scope_key（包括 default）都有经批准的 Performance Hub 映射；已测试未知密钥会按拒绝处理（fail closed）。
• 已配置集成的预期刷新频率、最大源数据时效、源数据过时时的行为以及警报。
• 已证明上游获取失败时不会发出空快照或部分快照。
• 暂存序列的收敛、取消/撤销以及实体门的开始/结束边界均达到商定的目标。
• 已验证常规规则和永久授权可作为后备途径，并且时间窗口无法绕过用户停用、blockAllAccess、维护或地理围栏。

门禁控制准备情况

对于门禁控制集成：

• 您的系统在调用 Performance Hub 之前作出访问决策。
• 集成能够处理 device_offline、maintenance_mode_active 和 unlock_confirmation_timeout。
• 运营人员了解超时表示解锁未得到确认。
• 您的日志会存储返回的 event_id 和 command_id。
• 您为设施员工准备了手动后备流程。

错误处理和重试

• 400、401、403、404、409 和 422 响应会呈现给运营人员或支持团队，而不是盲目重试。
• 429、500、502、503 和 504 响应使用带退避的有限重试逻辑。
• 重复失败会在您的系统中触发警报。
• 集成绝不会静默丢弃失败的记录。

可观测性

• 您的日志包含端点、时间戳、设施标识符、源记录 ID、请求结果和响应正文。
• 您的支持团队可以按会员 ID、设施 ID、签到 ID 或解锁事件 ID 进行搜索。
• 您有办法重放或对账失败的同步。

生产上线

• Performance Hub 已确认您的生产访问权限。
• 至少有一个生产设施已启用您的集成。
• 您的生产密钥处于有效状态。
• 您的运营联系人和技术联系人信息是最新的。
• 您已为客户记录支持流程。

完成这些检查后，您配置的集成将出现在 Performance Hub 核心平台内的 Performance Hub 合作伙伴目录中。