用途:让 BambooHR 集成的本地开发与测试脱离生产 HR 数据和网络依赖,用基于官方 schema 设计的合成夹具替代真实录制数据。
主要能力:在适配器后放置传输接口,实现带显式脚本响应和请求断言的假传输;创建合成员工与 HR 对象,覆盖在职/离职/未来状态、缺失字段、分页、空结果和 schema 漂移;补充 401、403、409、412、413、422、429、503、504、598、超时、脱敏、请求 ID 和变更结果不明确等场景;提供仅运行离线单元/契约测试的 watch 命令;Webhook 开发可在本地生成载荷、用合成密钥验证原始字节 HMAC 并测试重放与幂等。
使用方式:先检查运行时、包管理器、测试框架、本地配置和现有适配器;默认本地配置使用明显的非机密占位符和假传输;实时测试租户配置单独存放、被版本控制忽略、从批准的密钥库加载,且不被普通测试或 watch 命令激活。集成测试需显式 profile 和审批门。
限制:不得安装包或访问 BambooHR;添加依赖、存储实时凭据、调用租户、捕获流量或添加源自客户数据的夹具均需审批;脱敏不自动使生产载荷可复用;测试若尝试网络访问应失败并指出未 mock 的操作;夹具若像真实 HR 数据须移除并替换为合成值;假传输偏离固定 OpenAPI 时须经审查的契约差异更新。
输出:传输边界、场景清单、夹具来源、命令、无网络证明、认证/重试/分页/Webhook 覆盖、测试结果及保持禁用的可选实时 profile。