# API OpenMagic Docs

本目录用于沉淀 `api.openmagic.ai` 项目的半成品蓝图、讨论结论、执行顺序和后续设计文档。

当前已确认的大方向：

- 项目定位：`api.openmagic.ai` 是 Token/API 中转站的产品站、交易站、开发者站、控制台入口。
- 网关内核：使用 `One API`，避免 `New API` 的 AGPL/署名约束。
- 数据库：采用双库结构。
  - `oneapi_core`
  - `api_openmagic_biz`
- 支付：不依赖开源模板自带支付，接入现有自有支付渠道。
- 咨询：复用现有 AI 客服系统，全站挂载咨询入口，按“OpenMagic 中转站”品牌承接。
- 免费聊天：低权重复用 `chat.openmagic.ai` 的 AI 聊天能力，作为附赠体验，不作为主卖点。
- 主站协同：`openmagic.ai` 保留 WordPress 内容和文章流量能力，首页改造成品牌与分流入口。

## 文档列表

- `site-architecture.md`
  - 站群分工
  - 主站/API 站职责边界
  - 页面结构
  - 功能模块
  - 数据库分层
- `implementation-roadmap.md`
  - 第一阶段到第三阶段的执行顺序
  - 每阶段交付物
  - 依赖关系
- `pricing-and-growth.md`
  - 定价原则
  - 中文市场参考
  - 拉新、转化、邀请、渠道使用策略
- `page-blueprints.md`
  - 首页、定价页、文档页、控制台页模块草图
- `database-outline.md`
  - 双库结构与业务表初版清单
- `testing-and-qa.md`
  - 自测原则
  - 功能验收顺序
  - 上线前验证要求
- `build-checklist.md`
  - 从蓝图到落地的具体施工清单
- `integration-matrix.md`
  - 各站点、系统、数据库、支付、咨询之间的集成关系
- `runtime-operations.md`
  - Docker / One API / Nginx / 后端接口 / mock 支付链路的运行和验收命令

## 当前共识

- `openmagic.ai` 不废弃。
- `openmagic.ai` 保留 WordPress、文章、SEO、原有静态/文章 URL。
- `openmagic.ai` 首页可重做，不需要沿用旧模板风格。
- `api.openmagic.ai` 不承担内容农场职责，专注转化、控制台、文档和 API。
- 页面风格目标不是“听起来专业”，而是“看起来能吸引人并促进转化”。
- 白灰色只是参考，不是硬约束；最终以转化效果、品牌感和整体吸引力为准。
- 所有功能必须由开发侧自行验证通过后，才能视为可交付。
- 测试阶段优先去掉不必要的登录门槛，先把功能跑通、测透，再补回认证和权限控制。

## 当前建议实施顺序

1. 固化信息架构和集成边界
2. 完成页面模块设计
3. 完成数据库与业务流设计
4. 部署 One API 和双库
5. 搭建 `api.openmagic.ai` 前台与控制台壳层
6. 改造 `openmagic.ai` 首页和文章导流位
7. 接入支付、咨询、免费聊天、邀请体系
8. 全链路自测通过后再补权限与上线细节

## 后续补充规则

- 新的结构性结论，优先写回本目录。
- 长周期有价值的完整讨论，在用户明确要求后整理进 `AUV_work/conversation_history/`。