# API OpenMagic Build Checklist

本清单用于把当前蓝图转成切实可执行的落地步骤。

---

## A. 方案冻结

- [ ] 确认 `openmagic.ai` = 品牌/内容/SEO 主站
- [ ] 确认 `api.openmagic.ai` = 产品/交易/开发者/API 站
- [ ] 确认 `One API` = 网关内核
- [ ] 确认双库结构：`oneapi_core` + `api_openmagic_biz`
- [ ] 确认支付走现有自有渠道
- [ ] 确认 AI 客服系统全站接入
- [ ] 确认免费聊天仅作附赠体验

完成标准：

- 所有边界能用一句话说清，不再互相混用

---

## B. 页面信息架构

### `openmagic.ai`

- [ ] 设计新首页结构
- [ ] 设计顶部导航
- [ ] 设计文章页 CTA 模块
- [ ] 设计底部 CTA 模块
- [ ] 设计 AI 资讯分类入口
- [ ] 设计企业合作入口

### `api.openmagic.ai`

- [ ] 设计首页
- [ ] 设计定价页
- [ ] 设计模型页
- [ ] 设计文档页
- [ ] 设计企业页
- [ ] 设计控制台壳层

完成标准：

- 页面层级、导航、CTA 跳转路径全部明确

---

## C. 视觉与品牌

- [ ] 确认脑图 logo 作为统一视觉起点
- [ ] 输出 favicon / square logo / header logo / OG 图需求
- [ ] 确认主色、辅助色、按钮风格
- [ ] 确认首页 Hero 视觉方向
- [ ] 确认“吸引人优先于保守中性”的设计原则

完成标准：

- 可以直接进入页面视觉设计或前端实现

---

## D. 数据库与业务流

- [ ] 建立 `oneapi_core`
- [ ] 建立 `api_openmagic_biz`
- [ ] 明确用户同步关系
- [ ] 明确余额发放方式
- [ ] 明确订阅发放方式
- [ ] 明确订单状态机
- [ ] 明确邀请奖励流
- [ ] 明确活动归因流

完成标准：

- 能画出注册、充值、订阅、邀请、咨询的完整流程

---

## E. One API 部署与配置

- [ ] 部署 One API
- [ ] 连接 `oneapi_core`
- [ ] 建立基础管理员
- [ ] 接入至少一个上游进行联调
- [ ] 配置模型分组
- [ ] 配置倍率/价格规则
- [ ] 配置基础日志与可观测性

完成标准：

- `/v1/*` 已可完成基本转发

---

## F. `api.openmagic.ai` 前台搭建

- [ ] 搭建静态壳层或前端框架
- [ ] 完成首页
- [ ] 完成定价页
- [ ] 完成文档页
- [ ] 完成模型页
- [ ] 完成企业页
- [ ] 预留控制台入口
- [ ] 预留咨询入口
- [ ] 预留免费聊天入口

完成标准：

- 用户从首页可顺畅走到注册/咨询/查看价格

---

## G. 控制台与业务后台

- [ ] 搭建控制台壳层
- [ ] 完成 Key 管理页
- [ ] 完成用量页
- [ ] 完成充值页
- [ ] 完成订单页
- [ ] 完成邀请页
- [ ] 搭建自研后台基础导航

完成标准：

- 用户和运营都能完成核心闭环操作

---

## H. 支付接入

- [ ] 创建订单接口
- [ ] 接入支付发起
- [ ] 接入支付回调
- [ ] 完成余额发放
- [ ] 完成月卡开通
- [ ] 完成失败/重复回调保护

完成标准：

- 测试支付成功后，用户余额或月卡状态正确变化

---

## I. 咨询与免费聊天接入

- [ ] 全站挂载 AI 客服咨询入口
- [ ] 按“OpenMagic 中转站”品牌接入
- [ ] 验证新消息提醒
- [ ] 验证附件上传
- [ ] 挂接免费聊天体验入口
- [ ] 验证免费聊天跳转或嵌入路径

完成标准：

- 用户可在任意关键页发起咨询
- 免费聊天入口正常但不喧宾夺主

---

## J. `openmagic.ai` 改造

- [ ] 保留 WordPress 内容与文章 URL
- [ ] 新建首页模板
- [ ] 替换旧首页叙事为 API 产品导向
- [ ] 在文章页增加 API 站导流模块
- [ ] 隐藏 Google 广告展示
- [ ] 增加 AI 资讯内容分类

完成标准：

- 不丢 SEO 结构
- 首页完成角色切换

---

## K. 邀请与活动

- [ ] 实现邀请链接
- [ ] 实现邀请事件记录
- [ ] 实现首单奖励
- [ ] 预留活动页模板
- [ ] 预留 `url.cr` / App 广告位导流活动页

完成标准：

- 裂变路径可跑通、可归因、可发奖

---

## L. 全链路测试

- [ ] 前台页面逐页验证
- [ ] 控制台逐页验证
- [ ] 支付流程验证
- [ ] 咨询流程验证
- [ ] 免费聊天入口验证
- [ ] API 转发验证
- [ ] 邀请与活动验证
- [ ] 移动端验证
- [ ] 回归测试

完成标准：

- 所有主要流程都由开发侧亲自跑通过

---

## M. 权限与上线收口

- [ ] 把测试阶段临时开放的入口收回
- [ ] 补登录与权限控制
- [ ] 补管理员权限边界
- [ ] 清理测试数据
- [ ] 检查 robots/sitemap/SEO 细节
- [ ] 检查缓存/CDN 策略

完成标准：

- 站点具备公开前的基础安全与运营条件