🏮 多模态AI古诗教学平台 API 文档
📋 项目状态: 后端API开发完成,前端开发中...
🔗 API基础URL: http://localhost:5000/api
🔑 认证方式: JWT Token (Bearer Token)
🔐 用户认证
POST /auth/register - 用户注册
POST /auth/login - 用户登录
GET /auth/profile - 获取用户信息
PUT /auth/profile - 更新用户信息
📚 古诗管理
GET /poems - 获取古诗列表
GET /poems/{id} - 获取单首古诗详情
POST /poems/{id}/start-learning - 开始学习古诗
GET /poems/recommend - 获取推荐古诗
🤖 AI问答
POST /ai/word-analysis - 字词解析
POST /ai/background-explanation - 背景介绍
POST /ai/artistic-analysis - 意境赏析
POST /ai/general-question - 一般问答
📝 练习系统
GET /exercises/poem/{id} - 获取古诗练习题
POST /exercises/generate/{id} - 生成练习题
POST /exercises/submit - 提交答案
GET /exercises/statistics - 练习统计
📊 学习记录
GET /learning/records - 获取学习记录
GET /learning/statistics - 学习统计
GET /learning/progress-report - 学习报告
📈 仪表板
GET /dashboard/overview - 概览数据
GET /dashboard/learning-trends - 学习趋势
GET /dashboard/recommendations - 个性化推荐
GET /dashboard/achievements - 学习成就
🚀 快速开始:
1. 运行 pip install -r requirements.txt 安装依赖
2. 运行 python init_db.py 初始化数据库
3. 运行 python app.py 启动后端服务
4. 访问 http://localhost:5000/api/health 检查服务状态