# API OpenMagic Integration Matrix

## 1. 系统总表

| 组件 | 角色 | 是否核心 | 说明 |
|------|------|----------|------|
| `openmagic.ai` | 品牌/内容/SEO 主站 | 是 | WordPress 保留，负责拉新与导流 |
| `api.openmagic.ai` | 产品/交易/API 站 | 是 | 用户注册、定价、文档、控制台、API 入口 |
| `One API` | 网关内核 | 是 | 提供渠道、模型、Token、日志、额度能力 |
| `oneapi_core` | One API 数据库 | 是 | 不混业务自定义字段 |
| `api_openmagic_biz` | 业务数据库 | 是 | 订单、套餐、邀请、活动、企业线索 |
| 自有支付通道 | 支付基础设施 | 是 | 创建订单、发起支付、回调入账 |
| AI 客服系统 | 咨询承接 | 是 | 全站挂载，按品牌分流 |
| `chat.openmagic.ai` | 免费聊天体验 | 否 | 附赠体验，不作为主卖点 |
| `url.cr` / App 广告图 | 现有分发渠道 | 否 | 后续可作为活动导流位 |

---

## 2. 主站与 API 站关系

| 来源 | 去向 | 目标 |
|------|------|------|
| `openmagic.ai` 首页 | `api.openmagic.ai` | 把品牌流量导向交易站 |
| `openmagic.ai` 文章页 | `api.openmagic.ai/pricing` / `docs` / `register` | 把内容流量导向转化页 |
| `api.openmagic.ai` | `openmagic.ai` | 仅少量回链品牌与内容，不反客为主 |

原则：

- `openmagic.ai` 拉新
- `api.openmagic.ai` 成交

---

## 3. API 站与 One API 关系

| 功能 | 所属 |
|------|------|
| 上游配置 | One API |
| 模型映射 | One API |
| Token 管理内核 | One API |
| 请求转发 | One API |
| 日志与基础用量 | One API |
| 定价页 | API 站前台 |
| 订单与支付 | 业务系统 |
| 套餐与订阅 | 业务系统 |
| 企业合作 | 业务系统 |
| 邀请返利 | 业务系统 |

原则：

- One API 做“内核”
- 业务系统做“商业层”

---

## 4. 数据库关系

### `oneapi_core`

存：

- 用户内核数据
- 渠道
- 模型
- 用量
- token

### `api_openmagic_biz`

存：

- 用户扩展
- 订单
- 支付
- 套餐
- 订阅
- 邀请
- 活动
- 企业线索

### 同步关系

| 事件 | 处理 |
|------|------|
| 用户注册 | 创建 One API 用户 + 写业务资料 |
| 充值成功 | 业务库记账 + 同步 One API 额度 |
| 月卡开通 | 业务库写订阅 + 发放额度 |
| 邀请奖励 | 业务库记奖励 + 同步 One API 余额/额度 |

---

## 5. 支付集成关系

| 步骤 | 系统 |
|------|------|
| 创建订单 | 业务系统 |
| 发起支付 | 自有支付通道 |
| 支付回调 | 业务系统 |
| 更新订单状态 | 业务库 |
| 发放余额/额度 | 业务库 + One API |

关键要求：

- 防重复回调
- 异常回调可追踪
- 发放与订单状态保持一致

---

## 6. 咨询系统集成关系

| 页面 | 挂载咨询入口 |
|------|--------------|
| `openmagic.ai` 首页 | 是 |
| `openmagic.ai` 文章页 | 是 |
| `api.openmagic.ai` 首页 | 是 |
| `api.openmagic.ai/pricing` | 是 |
| `api.openmagic.ai/enterprise` | 是 |
| 控制台 | 可选 |

承接方式：

- 按“OpenMagic 中转站”品牌接入
- 后台由现有 AI 客服系统承接

---

## 7. 免费聊天集成关系

| 来源页面 | 行为 |
|----------|------|
| `openmagic.ai` 首页 | 次级入口跳转体验 |
| `api.openmagic.ai` 首页 | 次级入口跳转体验 |
| 控制台空态页 | 可辅助引导体验 |

原则：

- 只做体验增强
- 不做首页主卖点

---

## 8. 现有渠道集成关系

| 渠道 | 用法 |
|------|------|
| `openmagic.ai` SEO 内容 | 长期自然流量 |
| `url.cr` / App 广告图 | 活动曝光、试用推广、老用户导流 |
| 现有品牌渠道 | 可并入中转站导流 |

原则：

- 渠道可以复用
- 核心承接仍在 `api.openmagic.ai`

---

## 9. 当前落地建议

先做以下集成，不跳步：

1. `openmagic.ai` -> `api.openmagic.ai` 导流
2. `api.openmagic.ai` -> One API 内核
3. `api.openmagic.ai` -> 业务库
4. `api.openmagic.ai` -> 支付
5. `api.openmagic.ai` -> AI 客服系统
6. `api.openmagic.ai` -> 免费聊天入口

后做：

7. `url.cr` / App 广告图 -> 活动页
8. 邀请/活动归因 -> 发奖闭环