用途：为 Klaviyo 集成提供生产级参考架构，适用于设计新的 Klaviyo 集成、审查项目结构或排查分层问题。
主要能力：给出四层契约与目录骨架（src/{klaviyo,services,webhooks,jobs,middleware,config,health}），单向调用规则为 API/Webhook 层只调 Service，Service 层调 SDK 与基础设施，Klaviyo SDK 层不向上调用，基础设施层含 Redis 缓存、BullMQ 队列、Prisma 数据库与 OTel 监控。提供 loadConfig() 统一返回环境密钥、速率限制与缓存 TTL；ProfileSyncService 双向 upsert；EventTracker 服务端跟踪 Placed Order 与自定义事件，均通过 withRateLimitRetry 调用。
使用方式：先用 Write 搭建目录树，自底向上填充各层；先做配置层，再做服务层，最后接通数据流（注册→syncToKlaviyo()，购买→trackPurchase()，入站 profile.updated webhook→WebhookRouter.routeEvent()→本地数据库）。审查时读取 src/ 树并用 Grep 查找跨层导入。
前置条件：TypeScript 项目并安装 klaviyo-api，理解分层架构，具备 Redis 与数据库。
限制与错误处理：循环依赖需保证 Service 调 SDK 而非反向；同步冲突采用带同步时间戳的最后写入优先；队列积压用熔断器与死信队列；类型不匹配需固定 SDK 版本并在 CI 运行 tsc --noEmit。多环境配置见同包 klaviyo-multi-env-setup 技能。具体代码与完整目录树见 architecture.md 与 implementation.md。