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（Azure/代理）、默认 chat 模型、embedding 模型。
• 点 保存 即运行时生效、无需重启；点 测试连通性 确认 key 能连上服务商。

密钥在数据库 AES 加密、绝不下发到浏览器。取值顺序为DB 优先、环境变量兜底，因此可直接在面板轮换 key，无需改服务器。

2. 事务邮件（SMTP / Resend）

路径：/admin/email。选 SMTP 或 Resend，填凭据、设发件人，再用 发送测试邮件 验证。示例（ZeptoMail）：

• 服务器 smtp.zeptomail.com，端口 587（STARTTLS）或 465（SSL）
• 用户名 emailapikey，密码 = 服务商 API key
• 发件人 = 已验证域名下的地址

配一套 provider 即覆盖产品的全部邮件：

• 改密码验证码 —— 设置 → 个人资料
• 团队邀请 —— 设置 → 团队
• 联系表单工单 —— 官网联系我们（reply-to = 访客）
• 催缴邮件 —— 续费扣款失败时发给工作区所有者
• 测试邮件 —— 租户端（设置 → 邮件）与超管测试按钮

优先级 DB 配置 → 环境变量 → 不发信。都没配则静默跳过（不报错）。

3. 支付、退款与催缴

路径：/admin/payments。

• 渠道：开关 Stripe 一次性方式（支付宝/微信/加密货币）、易支付、USDT。信用卡始终是周期订阅。
• 订单：最近订单+状态。USDT/易支付待支付可自动查账或手动确认；已支付的 Stripe 订单出现 退款 按钮。
• 退款：调 Stripe refunds.create，订单置 REFUNDED 并回收套餐——但仅当该工作区没有有效周期订阅时才降级（退一次性单不会误伤信用卡订阅用户）。

Stripe Webhook 事件（7 个全订阅）

端点 https://<你的域名>/api/v1/stripe/webhook 必须订阅：

• checkout.session.completed
• checkout.session.async_payment_succeeded —— 微信/支付宝走 Checkout 的异步结算
• payment_intent.succeeded —— 支付宝直付；漏订阅会「付了钱但套餐不开通」
• customer.subscription.updated / customer.subscription.deleted
• invoice.payment_failed
• charge.refunded —— 退款（面板或 Stripe 后台发起）

催缴（续费失败）

续费失败不会立即停服：工作区进入 PAST_DUE（套餐仍可用），给所有者发催缴邮件， 靠 Stripe 智能重试继续扣款；只有 Stripe 最终放弃（subscription.deleted）才降级到免费版。 重试成功会自动清除 PAST_DUE。