用途：为 HubSpot CRM 集成提供生产可用的分层架构参考，适合设计新的 HubSpot 集成、审查项目结构或快速搭建可维护的集成代码基座。
主要能力：按基础设施层、服务层、API 层与后台任务分层。基础设施层提供 @hubspot/api-client 单例封装、HubSpot 专属类型、错误分类、响应缓存与关联类型常量；服务层封装联系人、交易、公司及同步的业务逻辑；API 层提供 REST 端点与 Webhook 接收，并含请求认证与 HubSpot 签名校验；jobs 目录承载定时同步与异步事件处理。还给出配置化的重试与缓存 TTL、批量大小与并发策略，以及错误处理对照表。
使用方式：需 TypeScript 5+ 项目并已安装 @hubspot/api-client v13+，理解分层架构模式。按资料中的目录结构组织代码，客户端通过 getHubSpotClient() 获取单例，accessToken 取自环境变量 HUBSPOT_ACCESS_TOKEN，重试次数 numberOfApiCallRetries: 3。联系人 upsert 先按 email 搜索再创建或更新，并用 associations.v4.basicApi.create 建立关联；交易创建前缓存 pipeline 列表，通过标签匹配 pipeline 与 stage。测试中需在 teardown 调用 resetHubSpotClient() 隔离共享客户端状态。
适用场景：需要类型安全、可缓存、可重试并支持 Webhook 的 HubSpot CRM 集成系统。
限制：资料未提供具体定价、平台部署细节、性能指标及多环境配置步骤，仅指向 hubspot-multi-env-setup 作为后续参考；缓存失效需在 Webhook 事件中手动处理，避免数据陈旧。