构建广告指挥中心
目标
为 Google Ads 和 Meta Ads 构建一个可靠的广告驾驶舱（cockpit）。需保证数据来源的可追溯性、平台间的差异性、不同组织间的隔离性，以及发送给广告平台的指令操作的安全性。
在构建前对产品进行分类
- 报表类：连接、同步和只读操作。
- 辅助操控类：提供建议、预览，然后由人工确认预算、暂停和恢复等操作。
- SaaS 自助服务类：多用户 OAuth、账户选择、权限管理、计费、合规性和支持。
如果只实现了管理员连接和模拟测试，则不应承诺达到第三级。
从实际上下文开始
在选定技术栈之前，先审查现有仓库和基础设施。收集目标用户、账户数量、更新频率、所需历史数据、转化数据来源、币种、时区、部署环境和合规限制等信息。
根据选定的产品级别来规划解决方案规模。对于面向单一组织的只读内部工具，一个单一组织、简单角色和单体架构就足够了。除非有明确需求，否则不要强加自助式 OAuth、微服务、计费或审批工作流。
加载参考文件
- 始终阅读 architecture-data-sync.md。
- 对于 Google Ads，阅读 google-ads.md。
- 对于 Meta Ads，阅读 meta-ads.md。
- 在任何外部写入或生产部署之前，阅读 production-safety.md。
- 在宣布系统完成之前，应用 acceptance-checklist.md 中的相关部分。
API 版本、权限、审核流程和配额会发生变化。在实现时务必查阅官方文档。
工作流程
- 建立一个能力矩阵：包括平台、读/写、数据源、已验证状态和限制。
- 设计组织、成员、角色、连接、广告账户和审计日志。
- 首先实现只读连接器，并保留原始数据来源。
- 通过幂等任务将数据同步到标准化数据库。展示数据新鲜度、错误、覆盖范围和归因上下文。
- 在一个已结束的期间内，抽取样本数据与 Google 和 Meta 的原生界面进行比对验证。
- 通过确定性规则和计算生成建议。仅使用 LLM 来解释或改写这些建议。
- 逐个添加写入操作，每个操作都必须包含预览、授权、限制、幂等性、审计、远程复核和回滚流程。
- 测试组织间的隔离性、OAuth 过期机制、配额、任务重试逻辑以及缺失指标的处理。
不变原则
- 任何密钥都不得出现在仓库、浏览器、日志、截图、导出文件或提示词中。
- 切勿简单地将 Google 和 Meta 的转化数据相加：必须保留平台、操作、窗口期和归因模型信息。
- 计划性同步不等于实时。
- 未经明确授权和限定范围，绝不允许在生产环境的账户上测试变更操作。
- 对每个能力进行资质标记：
已实现、已沙箱测试、已验证生产可用或部分实现。
预期交付物
提供架构设计及其假设、数据模型、Google 和 Meta 的连接流程、同步策略、权限矩阵、写入操作的保护措施、数据验证测试以及运维手册。清晰区分哪些是已完成的工作，哪些是待验证的内容。