Platform operations (admin)

以下設定在 超級管理員面板，平台級生效（所有工作區共用），需平台超管帳號。

1. 平台 AI 憑據

路徑：/admin/ai-billing → 平台 AI 憑據。這是平台託管模式下所有 AI 功能（自動回覆、RAG 檢索、爬站/文件訓練、Playground、設定助手）共用的 key。

• 填 OpenAI API Key（涵蓋 chat gpt-4o-mini + embedding text-embedding-3-small）；Anthropic key 選填。
• 可選：OpenAI 相容 Base URL、預設 chat 模型、embedding 模型。
• 按 儲存 即執行階段生效、免重啟；按 測試連通性 確認 key 可連上服務商。

金鑰於資料庫 AES 加密、絕不下發瀏覽器。取值順序 DB 優先、環境變數兜底，可直接在面板輪換金鑰。

2. 事務郵件（SMTP / Resend）

路徑：/admin/email。選 SMTP 或 Resend，填憑據、設寄件人，再用 傳送測試郵件 驗證。範例（ZeptoMail）：

• 伺服器 smtp.zeptomail.com，連接埠 587（STARTTLS）或 465（SSL）
• 使用者 emailapikey，密碼 = 服務商 API key；寄件人 = 已驗證網域下的地址

配一套 provider 即涵蓋全部郵件：改密碼驗證碼、團隊邀請、聯絡表單工單、催繳郵件、測試郵件。優先級 DB → 環境變數 → 不寄信。

3. 支付、退款與催繳

路徑：/admin/payments。渠道開關（Stripe 支付寶/微信/加密貨幣、易支付、USDT）、訂單列表、手動確認、已支付 Stripe 訂單的 退款 按鈕。退款只在工作區無有效週期訂閱時才降級。

Stripe Webhook 事件（7 個全訂閱）

端點 /api/v1/stripe/webhook 須訂閱：checkout.session.completed、checkout.session.async_payment_succeeded、payment_intent.succeeded（支付寶直付）、customer.subscription.updated/deleted、invoice.payment_failed、charge.refunded。

催繳（續費失敗）

續費失敗不會立即停服：進入 PAST_DUE 寬限+催繳郵件，靠 Stripe 智慧重試；最終放棄才降級。重試成功自動清除。