用途：为 HubSpot 集成实现基于角色的访问控制（RBAC），利用 OAuth 作用域、多个不同权限的私有应用以及应用层授权来隔离访问级别。
主要能力：按角色划分作用域模型，例如只读、读写、管理员、同步、Webhook 等私有应用；多令牌客户端工厂，按角色缓存并返回对应 HubSpot 客户端；应用层权限中间件，按用户角色校验对联系人、交易、公司等对象的读、写、删除权限；面向公共应用的多门户 OAuth 2.0 凭证管理与令牌刷新；记录所有 HubSpot 操作的审计日志，并对可疑删除失败告警。
使用方式：先创建不同权限的私有应用并配置对应作用域，将各角色令牌放入环境变量；用 getClientForRole 按角色获取客户端；在 Express 路由上用 requirePermission 中间件做权限校验；多门户场景用 MultiPortalManager 管理凭证与刷新；通过 auditHubSpotAction 写入审计库。
适用场景：需要按团队或角色限制 HubSpot 数据访问的企业集成、仪表盘与报表、CRM 操作、数据同步任务、事件处理以及多门户公共应用。
限制：团队级权限需要 HubSpot 企业版订阅；需理解 HubSpot OAuth 作用域并预先配置多个私有应用或 OAuth 应用；令牌刷新失败可能因客户端密钥变更；异步审计写入失败可能造成审计缺口，需增加重试。