用途:实现 BambooHR 中休假、福利与员工文件等敏感二级 HR 工作流,避免把读取与变更混在同一权限边界内。每个域有不同的审批人、留存要求与后果,每次运行只选择一种操作类别。
主要能力:官方 SDK/OpenAPI 提供休假政策、余额、申请与状态操作,公司与员工福利读取,以及公司/员工文件操作。部分操作返回空响应体或纯文本,成功与否须依据文档化状态码与后续读取判断,不能猜测 JSON 结构。
使用方式:先判定请求属于休假、福利还是文件,以及是读取还是变更;记录租户、员工标识、目的、审批人与预期效果。通过授权的列表操作发现 ID,不接受来自其他租户的未限定 ID,也不推断福利、政策、申请或文件标识。读取时只请求所需日期范围、字段与记录,不把文件字节或福利数据写入通用日志。变更前生成前后对比预览与幂等键,校验政策、生效日期、单位、状态流转与员工;执行前由所属 HR 角色审批,审批后重新读取目标以发现期间变化;随后用后续读取验证状态,记录请求 ID 与审计元数据而非原始员工数据。需定义部分失败的补偿方案,未经二次授权不得自动回滚已批准的 HR 操作。
工具纪律:用 Read、Glob、Grep 检查域映射与现有防护;Write/Edit 仅用于已批准的适配器、预览与测试。这些工具不授权对 BambooHR 进行实时读取、下载或变更。
审批边界:任何休假申请/状态变更、余额调整、福利写入、文件上传/下载/删除或权限扩展都需单独审批;不得在聊天记录或 CI 产物中暴露文档内容。
输出:返回域、操作、租户、最小化输入、前后预览、审批身份、响应状态、验证读取、请求 ID、留存处理与回滚/补偿状态。
错误处理:403 报告具体操作与权限边界;409 或 412 在状态/政策冲突时停止并刷新预览;空成功响应体依据文档状态与后续状态判断;文件传输不完整时丢弃不完整文件,在建立幂等前不重试写入。
示例:“显示下周已批准的 PTO”保持为限定时间的读取;“批准此申请并上传医生证明”拆分为两个独立审批的操作,证据与留存控制不同。
限制:资料未提供具体安装命令、价格、平台支持范围或效果数据;使用前应阅读官方证据再选择操作。