用途:本技能用于设计一个受治理的 Procore 数据连接器架构,将身份、租户路由、摄取、水合、对账、写入审批和审计证据相互分离。核心前提是:Procore Webhook 只提升数据新鲜度,REST 仍是数据来源,因此架构必须容忍重复、延迟、通知丢失和部分写入。
主要能力与设计步骤:
- 划定信任边界,识别令牌服务、入口、队列、工作进程、状态存储、出站适配器、审计接收端和操作界面,并把公司、项目上下文作为不可变任务属性携带。
- 分离适配器契约,将端点版本、请求模式、分页、速率元数据和错误都封装在资源适配器内,不要虚构一个全局统一的 Procore API 版本。
- 设计双通道摄取:Webhook 通知进入持久队列以保证新鲜度,通过 REST 水合当前资源,并周期性执行基于游标的对账以保证完整性。
- 使处理幂等:去重事件,使用来源标识或受支持的同步动作,维护检查点,重试前先对账含糊的写入结果。
- 治理写入:校验范围、渲染预览、按需审批、仅执行一次、写后读取并输出脱敏回执,读写工作进程权限可分离。
- 验证失败行为:测试令牌过期、租户路由丢失、重复与丢弃事件、速率耗尽、提供商中断、毒记录、回滚以及从检查点重放。
认证:令牌服务为指定用户或 DMSA 边界获取 OAuth 2.0 凭据,仅在分发时注入 Bearer 令牌;每个任务保留明确的公司与项目路由且不记录令牌。
输出物:信任边界与数据流设计、端点/队列/检查点/对账/权限契约、失败与回滚、重放及可观测性方案,并返回决策、被拒备选、假设、负责人和可度量验收标准。
限制:资料为架构设计指导,未提供具体代码、安装命令、收费信息或具体平台版本;实际实现细节需结合自身环境与非公开资料确认。