# 后端 API 评估与改造计划

## 现有 API 与新前端映射

### ✅ 可直接复用

| 前端功能 | 后端 API | 改造量 |
|---------|---------|--------|
| 微信登录 | `POST /api/auth/login` | ✅ 零改动 |
| H5 注册/登录 | `POST /api/auth/user/register` / `POST /api/auth/user/login` | ✅ 零改动 |
| 获取用户信息 | `GET /api/auth/me` | ✅ 零改动 |
| 知识列表（按维度） | `GET /api/knowledge?dim=1&category=concept` | ✅ 零改动，改数据即可 |
| 知识详情 | `GET /api/knowledge/:id` | ✅ 零改动 |
| 收藏/取消收藏 | `POST /api/knowledge/:id/collect` / `DELETE /api/knowledge/collect/:id` | ✅ 零改动 |
| AI 问答 | `POST /api/ai-chat/ask` | ⚠️ 改 system prompt（从几何→AI） |
| 问答配额 | `GET /api/ai-chat/quota` | ✅ 零改动 |
| 分享获得次数 | `POST /api/ai-chat/share-gain` | ✅ 零改动 |
| 创建订单 | `POST /api/payment/create-order` | ✅ 零改动 |
| 商品列表 | `GET /api/payment/products` | ✅ 改商品数据 |
| 提交反馈 | `POST /api/feedback` | ✅ 零改动 |
| 上传作品 | `POST /api/gallery` | ⚠️ 改为 AI 作品展示 |
| 作品列表 | `GET /api/gallery` | ✅ 零改动 |

### ⚠️ 需改造

| API | 改动内容 | 工作量 |
|-----|---------|--------|
| `POST /api/ai-chat/ask` | `getSystemPromptByDimension()` 函数 — 从几何 prompt 改为 AI 主题 prompt | 改 1 个函数 |
| `GET /api/user/progress` | 原为几何探索进度，改为 AI 学习进度 | 前端改字段名即可 |
| `POST /api/user/progress` | 同上 | 前端改字段名即可 |

### ❌ 移除或降级

| API | 处理方式 |
|-----|---------|
| `GET /api/pinyin/*` （4 个路由） | 前端不调用即可，后端保留兼容 |
| `GET /api/bgm` | 可作为可选功能保留（背景白噪音） |
| `GET /api/share` | 保留，用于分享激励 |

## 需要新增的 API

| 新 API | 说明 | 工作量 |
|--------|------|--------|
| `GET /api/trends` | AI 趋势资讯列表（接入 Hermes cron 的新闻数据） | 新建 model + route，1天 |
| `GET /api/tools` | AI 工具导航列表 | 简单 CRUD，小时级 |

## 改造总结

**后端改造成本极低，95% 的 API 可以直接用。**
- 主要改 1 个函数（AI Chat system prompt）
- 新增 1-2 个接口（趋势、工具）
- 其余全部零改动

## 数据库改造
- 无需改 schema
- Knowledge 表已有 `dim`, `category`, `sections`, `tags`, `isPremium` 等字段
- 只需填充 AI 内容数据
- AIChatQuota 表可以直接用（原 5 次免费 → 改为 10 次免费）