建置廣告操作中心
目標
為 Google Ads 和 Meta Ads 建置一個可靠的廣告儀表板。確保資料來源的可追溯性、平台間的差異、組織的隔離性，以及發送給廣告平台的操作安全性。
建置前先分類產品
- 報表：連線、同步與唯讀。
- 輔助操控：提供建議、預覽，然後由人工驗證預算、暫停與恢復。
- 自助 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 的連線流程、同步策略、權限矩陣、寫入保護機制、調節測試以及維運手冊。清楚區分哪些已完成、哪些仍待驗證。