📖
加载中...
📖
加载中...
Backend For Frontend · Next.js 16
中国古诗词 API 统一网关服务。聚合海量诗词数据，提供 AI 智能赏析， 所有客户端（Flutter / Web / 小程序）的唯一后端入口。
聚合近 40 万首唐诗、宋词、元曲，涵盖五言绝句、七言律诗等丰富体裁。
基于 DeepSeek 大模型，提供深度诗词赏析、翻译和智能问答。
Redis 缓存热点数据，首页聚合 300s 刷新，诗词详情秒级响应。
BFF 架构 — Flutter / Web / 小程序统一入口，客户端零业务逻辑。
JWT 认证、收藏同步、阅读历史，所有数据持久化到 PostgreSQL。
Docker 多阶段构建 + PM2 集群，Ubuntu 24.04 + Node.js 22 生产级部署。
| 方法 | 端点 | 说明 | 认证 |
|---|---|---|---|
| GET | /api/v1/home | 首页聚合 — 推荐诗词 + 作者 + 统计 | — |
| GET | /api/v1/discover | 发现页 — 近期诗词 + 朝代 + 体裁 | — |
| GET | /api/v1/poems | 诗词列表 — 分页、按朝代/体裁/作者筛选 | — |
| GET | /api/v1/poems/random | 随机诗词 — 支持按作者/体裁/朝代/单字过滤 | — |
| GET | /api/v1/poems/:id | 诗词详情 | — |
| GET | /api/v1/authors | 作者列表 | — |
| GET | /api/v1/authors/:id | 作者详情 | — |
| GET | /api/v1/search | 全文搜索 — 标题/内容/作者分类检索 | — |
| GET | /api/v1/categories | 分类 — 朝代 + 体裁聚合 | — |
| GET | /api/v1/recommend | 为你推荐 | — |
| GET | /api/v1/quote | 每日一句 | — |
| GET | /api/v1/config | 客户端配置 | — |
| POST | /api/v1/ai/analyse | AI 诗词赏析 | 🔒 JWT |
| POST | /api/v1/ai/ask | AI 诗词问答 | 🔒 JWT |
| POST | /api/v1/ai/translate | AI 诗词翻译 | 🔒 JWT |
| POST | /api/v1/user/register | 用户注册 | — |
| POST | /api/v1/user/login | 用户登录 | — |
| GET | /api/v1/user/profile | 获取个人信息 | 🔒 JWT |
| PUT | /api/v1/user/profile | 更新个人信息 | 🔒 JWT |
| GET | /api/v1/favorites | 收藏列表 | 🔒 JWT |
| POST | /api/v1/favorites | 添加收藏 | 🔒 JWT |
| DELETE | /api/v1/favorites/:id | 取消收藏 | 🔒 JWT |
| GET | /api/v1/history | 阅读历史 | 🔒 JWT |
| POST | /api/v1/history | 记录阅读 | 🔒 JWT |
Flutter App / Web / 小程序
│
HTTPS REST API
│
Poetry Gateway ← 本项目 (8080)
│
┌────────────────┼────────────────┐
│ │ │
▼ ▼ ▼
Chinese Poetry API AI Service User Service
(1279/Docker) (DeepSeek) (PostgreSQL)
│
诗词数据库(40万首) Redis Cache