API-first Ads Automation

把导入、上传、同步、ROI 和优化收敛成一个主系统。

Adsboostr 面向联盟营销广告自动化，围绕 Ad Record 作为生命周期主实体，把外部输入、 AI 文案生成、Google Ads 上传、订单与消耗汇总、自动优化动作全部放在一条可审计的主线上。

进入后台查看 API 入口

入口层 API / Task / Web

核心分层 Interfaces / Application / Domain / Infrastructure

后台入口 app.xxx.com

部署模型 website / admin / api / task

Input

外部输入统一收口。

外部系统只走业务 API，不把表格概念写进主系统。
导入进入 Ad Record 主线，不再散落在工具脚本中。
输入源可替换，但系统内部模型不变。

Execution

执行链完整可回放。

文案生成、广告上传、Google Ads 同步、ROI 重算、自动优化均可单独执行。
任务和手工 override 都会回写到统一总表和时间线。
Task 进程负责周期性执行，API 进程负责人工触发。

Observability

运营仍然只看一个总表。

后台首页是完整的投放总表，而不是分散的模块页。
一行对应一个 Ad Record，详情页可看完整时间线。
Google Ads 真实状态与系统控制状态严格分离。

Lifecycle

标准执行流程。

Intake：接收外部整理后的候选广告数据。
Creative：生成文案包与最终追踪链接。
Launch：创建 Google Ads 资源并落库。
Performance：同步 Google Ads 真实状态、消耗与预算。
Profitability：计算 ROI、订单窗口、佣金额。
Optimization：输出推荐动作与实际处理方案。

Deployment

四个部署单元。

cmd/website 对应 xxx.com。
interfaces/web/admin 对应 app.xxx.com。
cmd/api 对应 api.xxx.com。
cmd/task 为独立调度进程。