519 lines
22 KiB
Markdown
519 lines
22 KiB
Markdown
# 旧后端 (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`），但功能完整。
|
||
|
||
--- |