SuperAPI AI 工具集

bamboohr-reference-architecture

数据与分析

查看项目

更新于 10-15 22:42

技能介绍

用途:产出多租户 BambooHR 连接器架构,使控制面操作、HR 数据面读取、变更写入、Webhook 接收与下游投递可独立治理。连接器不承担 HR 政策权威,BambooHR 与获批目标系统各自保留明确所有权。

主要能力:使用租户本地 BambooHR 主机与当前官方 OpenAPI 操作,新批量读取优先 dataset v2;支持 OAuth 令牌刷新与外部持久化、类型化请求 ID/错误、有界重试、Webhook 一次性密钥保管;将已弃用的 report/dataset v1 路径视为迁移边界。控制面存储加密的租户级凭据元数据与精确重定向/权限配置;工作进程仅获得单租户凭据的短期访问,不能自选主机或读取其他租户令牌。API 密钥模式使用专用 BambooHR 身份并显式轮换。

使用方式:先定义参与者、租户、业务结果、记录系统、字段、工作流、新鲜度、规模、驻留、保留与恢复目标;绘制同意/回调、令牌存储、调度器、同步工作进程、Webhook 入口、队列、模式校验器、目标适配器、检查点存储、审计日志、监控与支持工具之间的信任边界;分离读写工作进程与权限,以不可变租户 ID 路由任务。定时同步采用最小化 dataset v2 读取、确定性分页、事务性检查点、幂等目标 upsert 与周期性全量对账。Webhook 需终止 TLS、仅在内存保留原始字节以验证 HMAC、拒绝重放、幂等入队、及时确认,并仅在适当时将事件作为授权源读取的触发器。队列/存储前强制字段允许列表与模式版本;加密获批 HR 数据,正文不得进入通用日志、追踪与死信。加入按租户并发、有限重试、熔断、死信审查、请求 ID 关联与背压。上线前设计凭据吊销、租户下线、数据删除、Webhook 替换、模式迁移、区域故障与回滚。

工具纪律:用 Read、Glob、Grep 将设计锚定现有系统;Write/Edit 仅用于获批架构记录、代码化图表与接口契约;本技能不预置或变更基础设施。

审批边界:字段与工作流范围、认证模型、租户路由、区域、保留、目标权威、Webhook 事件、变更路径与恢复目标均需审批;未决事项应记录而非猜测。

输出:上下文/容器/组件视图、数据流与信任边界、身份/权限矩阵、字段契约、队列/检查点/幂等模型、失败路径、SLO、保留/删除、决策、风险与验证计划。

错误处理:记录系统未知时停止写路径设计;共享租户凭据/目标命名空间视为阻断性隔离风险;无对账或回滚模型则架构未达生产就绪。

限制:资料未提供具体安装命令、价格、平台支持范围或性能指标。