# API OpenMagic Implementation Roadmap

## 第一阶段：蓝图与底层准备

目标：

- 把方向定死
- 不急于写业务代码
- 先把站群分工、页面结构、数据库和实施顺序确认

工作项：

1. 确认 `openmagic.ai` 与 `api.openmagic.ai` 的职责边界
2. 确认 One API 作为网关内核
3. 确认双库结构
4. 确认支付走自有通道
5. 确认 AI 客服系统接入为全站咨询入口
6. 确认免费聊天只是附赠能力
7. 在 `DOCS/` 形成指导文档

交付物：

- `site-architecture.md`
- `implementation-roadmap.md`
- `pricing-and-growth.md`

---

## 第二阶段：主站与产品站的信息架构

目标：

- 定首页结构
- 定导航结构
- 定 CTA 路径

工作项：

1. 设计 `openmagic.ai` 新首页结构
2. 设计 `api.openmagic.ai` 首页结构
3. 设计 `pricing/docs/models/enterprise/playground` 页面结构
4. 规划全站咨询组件挂载位
5. 规划免费聊天入口放置位
6. 规划文章页导流组件

交付物：

- 页面模块草图
- 导航与 URL 结构草案
- 主站与 API 站的导流规则

---

## 第三阶段：数据库与后台边界

目标：

- 定清楚哪些功能属于 One API，哪些属于自研业务后台

工作项：

1. 建立 `oneapi_core`
2. 建立 `api_openmagic_biz`
3. 设计业务表
4. 设计订单、支付、订阅、邀请、活动、企业客户的数据流
5. 设计 One API 与业务系统的同步方式

交付物：

- 数据表清单
- 字段级草案
- 业务流转图

---

## 第四阶段：UI/品牌设计

目标：

- 做出真正能吸引人的前台

工作项：

1. 基于脑图 logo 设计品牌视觉
2. 统一主色、辅助色、字体、按钮风格
3. 设计首页 Hero 区
4. 设计定价页
5. 设计文档页
6. 设计控制台壳层

原则：

- 不以“白灰色”本身为目标
- 以“吸引人、可转化、有品牌感”为目标
- 不做廉价模板感

交付物：

- 视觉方向稿
- 页面设计稿
- 资源清单

---

## 第五阶段：`openmagic.ai` 改造

目标：

- 不丢失 WordPress 内容能力和原有流量

工作项：

1. 保留文章 URL、分类 URL、标签 URL
2. 新建首页模板
3. 顶部导航改造成 API 导向
4. 文章页加入导流 CTA
5. 暂时隐藏广告
6. 增强 AI 资讯内容分类

交付物：

- 新首页
- 文章页导流组件
- 广告隐藏策略

---

## 第六阶段：`api.openmagic.ai` 产品站搭建

目标：

- 建成可转化的产品站

工作项：

1. 产品首页
2. 定价页
3. 模型与费率页
4. 文档中心
5. 企业合作页
6. 登录/注册页
7. 控制台入口页

交付物：

- 完整产品站前台

---

## 第七阶段：One API 与业务系统接入

目标：

- 网关跑起来
- 支付和用户体系接上

工作项：

1. 部署 One API
2. 接入上游
3. 建立分组、模型、倍率
4. 建立用户和额度同步
5. 接入自有支付
6. 完成订单回调与余额/额度发放

交付物：

- 可用 API 网关
- 可用充值与开通流程

---

## 第八阶段：咨询、试用与增长

目标：

- 建成基础转化闭环

工作项：

1. 接入 AI 客服咨询入口
2. 挂接免费聊天入口
3. 建立邀请返利
4. 建立活动页模板
5. 接入现有渠道导流

交付物：

- 咨询闭环
- 试用闭环
- 拉新闭环

---

## 第九阶段：持续优化

目标：

- 不断提高转化率、留存和客单价

工作项：

1. 观察不同入口的转化效果
2. 调整首页文案和 CTA
3. 调整定价与套餐
4. 迭代内容策略
5. 恢复或重排广告位
6. 增强企业功能

---

## 当前优先级

当前最优先，不要跳步：

1. 继续完善 `DOCS/`
2. 输出页面模块草图
3. 输出数据库初版表清单
4. 再开始做站点和代码