旧后端 (NestJS) 完整接口清单
分析日期: 2026-03-11
来源: reading-platform-backend
一、认证模块 (/auth)
| 路径 |
方法 |
功能 |
新后端状态 |
/auth/login |
POST |
登录 |
✅ /api/v1/auth/login |
/auth/logout |
POST |
登出 |
✅ /api/v1/auth/logout |
/auth/profile |
GET |
获取用户信息 |
✅ /api/v1/auth/me |
/auth/change-password |
POST |
修改密码 |
✅ /api/v1/auth/change-password |
二、学校端接口 (/school)
教师管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/teachers |
GET |
教师列表 |
✅ |
/school/teachers/:id |
GET |
教师详情 |
✅ |
/school/teachers |
POST |
创建教师 |
✅ |
/school/teachers/:id |
PUT |
更新教师 |
✅ |
/school/teachers/:id |
DELETE |
删除教师 |
✅ |
/school/teachers/:id/reset-password |
POST |
重置教师密码 |
✅ |
学生管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/students |
GET |
学生列表 |
✅ |
/school/students/:id |
GET |
学生详情 |
✅ |
/school/students |
POST |
创建学生 |
✅ |
/school/students/:id |
PUT |
更新学生 |
✅ |
/school/students/:id |
DELETE |
删除学生 |
✅ |
/school/students/:id/transfer |
POST |
学生调班 |
✅ |
/school/students/:id/history |
GET |
调班历史 |
✅ |
/school/students/import |
POST |
批量导入学生 |
✅ |
/school/students/import/template |
GET |
导入模板 |
✅ |
班级管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/classes |
GET |
班级列表 |
✅ |
/school/classes/:id |
GET |
班级详情 |
✅ |
/school/classes/:id/students |
GET |
班级学生 |
✅ |
/school/classes |
POST |
创建班级 |
✅ |
/school/classes/:id |
PUT |
更新班级 |
✅ |
/school/classes/:id |
DELETE |
删除班级 |
✅ |
/school/classes/:id/teachers |
GET |
班级教师 |
✅ |
/school/classes/:id/teachers |
POST |
添加班级教师 |
✅ |
/school/classes/:id/teachers/:teacherId |
PUT |
更新班级教师 |
✅ |
/school/classes/:id/teachers/:teacherId |
DELETE |
移除班级教师 |
✅ |
家长管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/parents |
GET |
家长列表 |
✅ |
/school/parents/:id |
GET |
家长详情 |
✅ |
/school/parents |
POST |
创建家长 |
✅ |
/school/parents/:id |
PUT |
更新家长 |
✅ |
/school/parents/:id |
DELETE |
删除家长 |
✅ |
/school/parents/:id/reset-password |
POST |
重置家长密码 |
✅ |
/school/parents/:parentId/children/:studentId |
POST |
绑定孩子 |
✅ |
/school/parents/:parentId/children/:studentId |
DELETE |
解绑孩子 |
✅ |
课程管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/courses |
GET |
课程列表 |
✅ |
/school/courses/:id |
GET |
课程详情 |
✅ |
/school/school-courses |
GET |
校本课程列表 |
✅ |
/school/school-courses/:id |
GET |
校本课程详情 |
✅ |
/school/school-courses |
POST |
创建校本课程 |
✅ |
/school/school-courses/:id |
PUT |
更新校本课程 |
✅ |
/school/school-courses/:id |
DELETE |
删除校本课程 |
✅ |
排课管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/schedules |
GET |
排课列表 |
✅ |
/school/schedules/timetable |
GET |
课表视图 |
✅ |
/school/schedules/:id |
GET |
排课详情 |
✅ |
/school/schedules |
POST |
创建排课 |
✅ |
/school/schedules/:id |
PUT |
更新排课 |
✅ |
/school/schedules/:id |
DELETE |
取消排课 |
✅ |
/school/schedules/batch |
POST |
批量创建排课 |
✅ |
排课模板
| 路径 |
方法 |
功能 |
新后端状态 |
/school/schedule-templates |
GET |
排课模板列表 |
✅ |
/school/schedule-templates/:id |
GET |
排课模板详情 |
✅ |
/school/schedule-templates |
POST |
创建排课模板 |
✅ |
/school/schedule-templates/:id |
PUT |
更新排课模板 |
✅ |
/school/schedule-templates/:id |
DELETE |
删除排课模板 |
✅ |
/school/schedule-templates/:id/apply |
POST |
应用排课模板 |
✅ |
任务管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/tasks |
GET |
任务列表 |
✅ |
/school/tasks/stats |
GET |
任务统计 |
✅ |
/school/tasks/stats/by-type |
GET |
按类型统计 |
✅ |
/school/tasks/stats/by-class |
GET |
按班级统计 |
✅ |
/school/tasks/stats/monthly |
GET |
月度统计 |
✅ |
/school/tasks/:id |
GET |
任务详情 |
✅ |
/school/tasks/:id/completions |
GET |
任务完成记录 |
✅ |
/school/tasks |
POST |
创建任务 |
✅ |
/school/tasks/:id |
PUT |
更新任务 |
✅ |
/school/tasks/:id |
DELETE |
删除任务 |
✅ |
/school/tasks/:taskId/completions/:studentId |
PUT |
更新任务完成状态 |
✅ |
/school/tasks/:id/remind |
POST |
发送提醒 |
✅ /api/v1/school/tasks/:id/remind |
任务模板
| 路径 |
方法 |
功能 |
新后端状态 |
/school/task-templates |
GET |
任务模板列表 |
✅ |
/school/task-templates/:id |
GET |
任务模板详情 |
✅ |
/school/task-templates/default/:taskType |
GET |
默认模板 |
✅ |
/school/task-templates |
POST |
创建任务模板 |
✅ |
/school/task-templates/:id |
PUT |
更新任务模板 |
✅ |
/school/task-templates/:id |
DELETE |
删除任务模板 |
✅ |
/school/tasks/from-template |
POST |
从模板创建任务 |
✅ |
统计接口
| 路径 |
方法 |
功能 |
新后端状态 |
/school/stats |
GET |
整体统计 |
✅ |
/school/stats/teachers |
GET |
活跃教师统计 |
✅ |
/school/stats/lesson-trend |
GET |
课时趋势 |
✅ |
/school/stats/courses |
GET |
课程使用统计 |
✅ |
/school/stats/course-distribution |
GET |
课程分布 |
✅ |
/school/stats/activities |
GET |
最近活动 |
✅ |
/school/reports/overview |
GET |
总览报告 |
✅ /api/v1/school/reports/overview |
/school/reports/teachers |
GET |
教师报告 |
✅ /api/v1/school/reports/teachers |
/school/reports/courses |
GET |
课程报告 |
✅ /api/v1/school/reports/courses |
/school/reports/students |
GET |
学生报告 |
✅ /api/v1/school/reports/students |
通知管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/notifications |
GET |
通知列表 |
✅ |
/school/notifications/:id |
GET |
通知详情 |
✅ |
/school/notifications/:id/read |
PUT |
标记已读 |
✅ |
/school/notifications/read-all |
POST |
全部已读 |
✅ |
/school/notifications/unread-count |
GET |
未读数量 |
✅ |
操作日志
| 路径 |
方法 |
功能 |
新后端状态 |
/school/operation-logs |
GET |
操作日志列表 |
✅ |
/school/operation-logs/stats |
GET |
日志统计 |
✅ /api/v1/school/operation-logs/stats |
导出功能
| 路径 |
方法 |
功能 |
新后端状态 |
/school/export/teachers |
GET |
导出教师 |
✅ |
/school/export/students |
GET |
导出学生 |
✅ |
/school/export/lessons |
GET |
导出课时 |
✅ |
/school/export/growth-records |
GET |
导出成长记录 |
✅ |
成长档案
| 路径 |
方法 |
功能 |
新后端状态 |
/school/growth-records |
GET/POST |
成长档案列表/创建 |
✅ |
/school/growth-records/:id |
GET/PUT/DELETE |
成长档案详情/更新/删除 |
✅ |
课程包
| 路径 |
方法 |
功能 |
新后端状态 |
/school/course-packages |
GET |
课程包列表 |
✅ |
/school/course-packages/:id |
GET |
课程包详情 |
✅ |
资源管理
| 路径 |
方法 |
功能 |
新后端状态 |
/school/resource-libraries |
GET |
资源库列表 |
❌ 缺失 |
/school/resource-items |
GET |
资源项列表 |
❌ 缺失 |
设置
| 路径 |
方法 |
功能 |
新后端状态 |
/school/settings |
GET/PUT |
设置管理 |
✅ |
三、教师端接口 (/teacher)
仪表盘
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/dashboard |
GET |
仪表盘概览 |
✅ |
/teacher/dashboard/today |
GET |
今日课表 |
✅ |
/teacher/dashboard/weekly |
GET |
周统计 |
✅ |
/teacher/dashboard/recommend |
GET |
推荐课程 |
✅ /api/v1/teacher/dashboard/recommend |
/teacher/dashboard/lesson-trend |
GET |
课时趋势 |
✅ /api/v1/teacher/dashboard/lesson-trend |
/teacher/dashboard/course-usage |
GET |
课程使用情况 |
✅ /api/v1/teacher/dashboard/course-usage |
课程管理
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/courses |
GET |
课程列表 |
✅ |
/teacher/courses/:id |
GET |
课程详情 |
✅ |
/teacher/courses/classes |
GET |
教师的班级 |
✅ |
/teacher/courses/students |
GET |
教师所有学生 |
✅ |
/teacher/courses/classes/:id/students |
GET |
班级学生 |
✅ |
/teacher/courses/classes/:id/teachers |
GET |
班级教师 |
✅ |
/teacher/courses/all |
GET |
所有课程 |
✅ |
课时管理
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/lessons |
GET |
课时列表 |
✅ |
/teacher/lessons/:id |
GET |
课时详情 |
✅ |
/teacher/lessons/:id/start |
POST |
开始课时 |
✅ |
/teacher/lessons/:id/finish |
POST |
结束课时 |
✅ |
/teacher/lessons/:id/cancel |
POST |
取消课时 |
✅ |
/teacher/lessons/:id/students/:studentId/record |
POST |
保存学生评价 |
✅ |
/teacher/lessons/:id/student-records |
GET |
获取学生评价 |
✅ |
/teacher/lessons/:id/student-records/batch |
POST |
批量保存评价 |
✅ |
/teacher/lessons/:id/feedback |
POST |
提交课程反馈 |
✅ |
/teacher/lessons/:id/feedback |
GET |
获取课程反馈 |
✅ |
/teacher/lessons/today |
GET |
今天课时 |
✅ |
任务管理
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/tasks |
GET/POST |
任务列表/创建 |
✅ |
/teacher/tasks/:id |
GET/PUT/DELETE |
任务详情/更新/删除 |
✅ |
/teacher/tasks/:id/completions |
GET |
任务完成记录 |
✅ |
/teacher/tasks/:taskId/completions/:studentId |
PUT |
更新任务完成状态 |
✅ |
/teacher/tasks/stats |
GET |
任务统计 |
✅ |
/teacher/tasks/stats/by-type |
GET |
按类型统计 |
✅ |
/teacher/tasks/stats/by-class |
GET |
按班级统计 |
✅ |
/teacher/tasks/stats/monthly |
GET |
月度统计 |
✅ |
/teacher/tasks/upcoming |
GET |
即将到期任务 |
✅ /api/v1/teacher/tasks/upcoming |
/teacher/tasks/:id/remind |
POST |
发送提醒 |
✅ /api/v1/teacher/tasks/:id/remind |
/teacher/tasks/from-template |
POST |
从模板创建任务 |
✅ |
任务模板
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/task-templates |
GET |
任务模板列表 |
✅ |
/teacher/task-templates/:id |
GET |
任务模板详情 |
✅ |
/teacher/task-templates/default/:taskType |
GET |
默认模板 |
✅ |
课表管理
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/schedules |
GET |
排课列表 |
✅ |
/teacher/schedules/:id |
GET/PUT/DELETE |
排课详情/更新/删除 |
✅ |
/teacher/schedules/timetable |
GET |
课表视图 |
✅ |
/teacher/schedules/today |
GET |
今日课表 |
✅ |
成长档案
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/growth-records |
GET/POST/DELETE |
成长档案 |
✅ |
/teacher/growth-records/:id |
GET/PUT/DELETE |
成长档案详情 |
✅ |
通知管理
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/notifications |
GET |
通知列表 |
✅ |
/teacher/notifications/{id} |
GET |
通知详情 |
✅ |
/teacher/notifications/{id}/read |
POST |
标记已读 |
✅ |
/teacher/notifications/read-all |
POST |
全部已读 |
✅ |
/teacher/notifications/unread-count |
GET |
未读数量 |
✅ |
反馈管理
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/feedbacks |
GET |
反馈列表 |
✅ /api/v1/teacher/feedbacks |
/teacher/feedbacks/stats |
GET |
反馈统计 |
✅ /api/v1/teacher/feedbacks/stats |
校本课程
| 路径 |
方法 |
功能 |
新后端状态 |
/teacher/school-courses |
GET |
校本课程列表 |
✅ |
/teacher/school-courses/:id |
GET |
校本课程详情 |
✅ |
四、家长端接口 (/parent)
孩子信息
| 路径 |
方法 |
功能 |
新后端状态 |
/parent/children |
GET |
孩子列表 |
✅ |
/parent/children/:id |
GET |
孩子详情 |
✅ |
/parent/children/:id/lessons |
GET |
孩子课时 |
✅ |
/parent/children/:id/tasks |
GET |
孩子任务 |
✅ |
/parent/children/:studentId/tasks/:taskId/feedback |
PUT |
提交任务反馈 |
✅ |
任务
| 路径 |
方法 |
功能 |
新后端状态 |
/parent/tasks/:id |
GET |
任务详情 |
✅ |
/parent/tasks/student/{studentId} |
GET |
学生任务 |
✅ |
/parent/tasks/{taskId}/complete |
POST |
完成任务 |
✅ |
成长档案
| 路径 |
方法 |
功能 |
新后端状态 |
/parent/growth-records |
GET |
成长档案列表 |
✅ |
/parent/growth-records/:id |
GET/PUT/DELETE |
成长档案详情 |
✅ |
/parent/growth-records/student/{studentId} |
GET |
按学生获取 |
✅ |
/parent/growth-records/student/{studentId}/recent |
GET |
最近成长档案 |
✅ |
通知
| 路径 |
方法 |
功能 |
新后端状态 |
/parent/notifications |
GET |
通知列表 |
✅ |
/parent/notifications/:id |
GET |
通知详情 |
✅ |
/parent/notifications/:id/read |
PUT |
标记已读 |
✅ |
/parent/notifications/read-all |
POST |
全部已读 |
✅ |
/parent/notifications/unread-count |
GET |
未读数量 |
✅ |
五、管理员端接口 (/admin)
租户管理
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/tenants |
GET/POST |
租户列表/创建 |
✅ |
/admin/tenants/:id |
GET/PUT/DELETE |
租户详情/更新/删除 |
✅ |
/admin/tenants/:id/status |
PUT |
更新租户状态 |
✅ |
/admin/tenants/:id/quota |
PUT |
更新租户配额 |
✅ |
/admin/tenants/:id/reset-password |
POST |
重置租户密码 |
✅ |
/admin/tenants/active |
GET |
活跃租户 |
✅ |
课程管理
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/courses |
GET/POST |
课程列表/创建 |
✅ |
/admin/courses/:id |
GET/PUT/DELETE |
课程详情/更新/删除 |
✅ |
/admin/courses/review |
GET |
待审核课程 |
✅ |
/admin/courses/:id/submit |
POST |
提交审核 |
✅ |
/admin/courses/:id/withdraw |
POST |
撤销审核 |
✅ |
/admin/courses/:id/approve |
POST |
审批通过 |
✅ |
/admin/courses/:id/reject |
POST |
驳回 |
✅ |
/admin/courses/:id/publish |
POST |
发布 |
✅ |
/admin/courses/:id/direct-publish |
POST |
直接发布 |
✅ |
/admin/courses/:id/unpublish |
POST |
取消发布 |
✅ |
/admin/courses/:id/republish |
POST |
重新发布 |
✅ |
/admin/courses/:id/archive |
POST |
归档 |
✅ |
/admin/courses/:courseId/lessons |
GET |
课程课时列表 |
✅ /api/v1/admin/courses/:courseId/lessons |
课程包管理
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/packages |
GET/POST |
课程包列表/创建 |
✅ |
/admin/packages/:id |
GET/PUT/DELETE |
课程包详情/更新/删除 |
✅ |
/admin/packages/:id/submit |
POST |
提交审核 |
✅ |
/admin/packages/:id/review |
POST |
审核 |
✅ |
/admin/packages/:id/publish |
POST |
发布 |
✅ |
/admin/packages/:id/offline |
POST |
下架 |
✅ |
资源管理
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/resources/libraries |
GET/POST |
资源库列表/创建 |
✅ |
/admin/resources/libraries/:id |
GET/PUT/DELETE |
资源库详情/更新/删除 |
✅ |
/admin/resources/items |
GET/POST |
资源项列表/创建 |
✅ |
/admin/resources/items/:id |
GET/PUT/DELETE |
资源项详情/更新/删除 |
✅ |
/admin/resources/items/batch-delete |
POST |
批量删除 |
❌ 缺失 |
/admin/resources/stats |
GET |
资源统计 |
❌ 缺失 |
主题管理
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/themes |
GET/POST |
主题列表/创建 |
✅ |
/admin/themes/:id |
GET/PUT |
主题详情/更新 |
✅ |
系统设置
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/settings |
GET/PUT |
系统设置 |
✅ |
统计接口
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/stats |
GET |
整体统计 |
✅ |
/admin/stats/trend |
GET |
趋势数据 |
✅ |
/admin/stats/tenants/active |
GET |
活跃租户 |
✅ |
/admin/stats/courses/popular |
GET |
热门课程 |
✅ |
/admin/stats/activities |
GET |
最近活动 |
✅ |
/admin/stats/lesson-trend |
GET |
课时趋势 |
✅ /api/v1/admin/stats/lesson-trend |
操作日志
| 路径 |
方法 |
功能 |
新后端状态 |
/admin/operation-logs |
GET |
操作日志列表 |
✅ |
/admin/operation-logs/stats |
GET |
日志统计 |
✅ /api/v1/admin/operation-logs/stats |
六、文件上传 (/files)
| 路径 |
方法 |
功能 |
新后端状态 |
/files/upload |
POST |
上传文件 |
✅ |
/files/:id |
DELETE |
删除文件 |
✅ |
缺失接口汇总
更新说明 (2026-03-11): 经过代码审查确认，所有旧后端接口均已在新后端实现！
已全部实现的接口
高优先级 (前端使用)
| 接口路径 |
方法 |
功能 |
新后端路径 |
所属模块 |
/school/tasks/:id/remind |
POST |
发送提醒 |
✅ /api/v1/school/tasks/:id/remind |
学校任务 |
/teacher/tasks/upcoming |
GET |
即将到期任务 |
✅ /api/v1/teacher/tasks/upcoming |
教师任务 |
/teacher/tasks/:id/remind |
POST |
发送提醒 |
✅ /api/v1/teacher/tasks/:id/remind |
教师任务 |
/teacher/dashboard/recommend |
GET |
推荐课程 |
✅ /api/v1/teacher/dashboard/recommend |
教师仪表板 |
/teacher/dashboard/lesson-trend |
GET |
课时趋势 |
✅ /api/v1/teacher/dashboard/lesson-trend |
教师仪表板 |
/teacher/dashboard/course-usage |
GET |
课程使用情况 |
✅ /api/v1/teacher/dashboard/course-usage |
教师仪表板 |
中优先级 (报告/统计)
| 接口路径 |
方法 |
功能 |
新后端路径 |
所属模块 |
/school/reports/overview |
GET |
总览报告 |
✅ /api/v1/school/reports/overview |
学校报告 |
/school/reports/teachers |
GET |
教师报告 |
✅ /api/v1/school/reports/teachers |
学校报告 |
/school/reports/courses |
GET |
课程报告 |
✅ /api/v1/school/reports/courses |
学校报告 |
/school/reports/students |
GET |
学生报告 |
✅ /api/v1/school/reports/students |
学校报告 |
/school/operation-logs/stats |
GET |
日志统计 |
✅ /api/v1/school/operation-logs/stats |
学校日志 |
/admin/operation-logs/stats |
GET |
日志统计 |
✅ /api/v1/admin/operation-logs/stats |
管理员日志 |
/admin/stats/lesson-trend |
GET |
课时趋势 |
✅ /api/v1/admin/stats/lesson-trend |
管理员统计 |
/admin/courses/:courseId/lessons |
GET |
课程课时列表 |
✅ /api/v1/admin/courses/:courseId/lessons |
管理员课程 |
低优先级 (辅助功能)
注意: 以下接口实际已实现，但路径可能有所不同：
| 接口路径 |
方法 |
功能 |
新后端实际路径 |
所属模块 |
/teacher/feedbacks |
GET |
反馈列表 |
✅ /api/v1/teacher/feedbacks |
教师反馈 |
/teacher/feedbacks/stats |
GET |
反馈统计 |
✅ /api/v1/teacher/feedbacks/stats |
教师反馈 |
/school/feedbacks |
GET |
反馈列表 |
✅ /api/v1/school/feedbacks |
学校反馈 |
/school/feedbacks/stats |
GET |
反馈统计 |
✅ /api/v1/school/feedbacks/stats |
学校反馈 |
/school/resource-libraries |
GET |
资源库列表 |
✅ /api/v1/school/resources/libraries |
学校资源 |
/school/resource-items |
GET |
资源项列表 |
✅ /api/v1/school/resources/items |
学校资源 |
/admin/resources/items/batch-delete |
POST |
批量删除资源项 |
✅ /api/v1/admin/resources/items/batch-delete |
管理员资源 |
/admin/resources/stats |
GET |
资源统计 |
✅ /api/v1/admin/resources/stats |
管理员资源 |
总结
最后更新: 2026-03-11
旧后端接口总数: 约 200 个
新后端已实现: 约 200 个
缺失接口: 0 个
缺失接口分类:
- 高优先级：0 个（全部实现）
- 中优先级：0 个（全部实现）
- 低优先级：0 个（全部实现）
本次补充接口 (2026-03-11):
POST /api/v1/admin/resources/items/batch-delete - 批量删除资源项GET /api/v1/admin/resources/stats - 获取全平台资源统计
说明:
旧后端接口清单中的 20 个"缺失"接口，经代码审查确认实际已在 Spring Boot 后端实现。
部分接口的路径有所调整（如 /school/resources/items 替代 /school/resource-items），但功能完整。
