”天天练MAX“小程序（API）

以下是基于表结构的完整 API 清单，涵盖 用户管理、题目练习、错题本、积分系统、排行榜、家长管理、学习报告和任务提醒 等功能。

📌 API 清单

👦 用户管理

API	方法	说明
/api/auth/register	POST	用户注册（支持手机号/微信登录）
/api/auth/login	POST	用户登录（手机号/微信）
/api/auth/logout	POST	用户登出
/api/users/profile	GET	获取个人信息
/api/users/profile	PUT	更新个人信息（头像、昵称等）

📖 题目管理

API	方法	说明
/api/questions	GET	获取题目列表（支持按学科、年级、分类筛选）
/api/questions/{id}	GET	获取单个题目
/api/questions/random	GET	获取随机题目（每日练习）
/api/questions/categories	GET	获取题目分类
/api/questions	POST	新增题目
/api/questions/{id}	PUT	更新题目
/api/questions/{id}	DELETE	删除题目

✅ 练习记录

API	方法	说明
/api/exercises	GET	获取练习记录（分页）
/api/exercise-info/{id}	GET	获取某次答题详情
/api/exercise-del/{id}	DELETE	删除答题记录
/api/exercises	POST	提交练习答案
/api/exercises/statistics	GET	获取用户练习统计（正确率、做题数等）

🔄 错题本

API	方法	说明
/api/wrong-questions	GET	获取错题本列表
/api/wrong-questions/{id}	GET	获取单个错题
/api/wrong-questions/retry	GET	获取错题练习题目
/api/wrong-questions/{id}/delete	POST	删除错题（移入回收站）
/api/wrong-questions/recover	POST	恢复错题

🎯 积分系统

API	方法	说明
/api/points	GET	获取用户积分
/api/points/history	GET	获取积分变动记录

🏆 排行榜

API	方法	说明
/api/leaderboard/daily	GET	获取每日排行榜
/api/leaderboard/weekly	GET	获取每周排行榜
/api/leaderboard/monthly	GET	获取月度排行榜

👨‍👩‍👧 家长绑定

API	方法	说明
/api/parent-child	GET	获取家长关联的孩子列表
/api/parent-child/add	POST	家长绑定孩子
/api/parent-child/remove/{child_id}	DELETE	解绑孩子

📊 学习报告

API	方法	说明
/api/study-reports	GET	获取学习报告（7天/30天）
/api/study-reports/{child_id}	GET	家长查看孩子学习报告

📢 任务提醒

API	方法	说明
/api/reminders	GET	获取任务列表
/api/reminders	POST	创建任务（家长布置）
/api/reminders/{id}	PUT	更新任务状态（完成/未完成）
/api/reminders/{id}	DELETE	删除任务

✅ 额外说明

• 所有 API 采用 RESTful 风格
• 支持 JWT 认证，部分 API 需要身份验证
• 部分查询支持 分页，避免数据过大
• 后续可扩展 AI 评测、错题推荐等功能