# 旧后端 (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 | 发送提醒 | ❌ 缺失 |

### 任务模板

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/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 | 总览报告 | ❌ 缺失 |
| `/school/reports/teachers` | GET | 教师报告 | ❌ 缺失 |
| `/school/reports/courses` | GET | 课程报告 | ❌ 缺失 |
| `/school/reports/students` | GET | 学生报告 | ❌ 缺失 |

### 通知管理

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/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 | 日志统计 | ❌ 缺失 |

### 导出功能

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/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 | 推荐课程 | ❌ 缺失 |
| `/teacher/dashboard/lesson-trend` | GET | 课时趋势 | ❌ 缺失 |
| `/teacher/dashboard/course-usage` | GET | 课程使用情况 | ❌ 缺失 |

### 课程管理

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/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 | 即将到期任务 | ❌ 缺失 |
| `/teacher/tasks/:id/remind` | POST | 发送提醒 | ❌ 缺失 |
| `/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 | 反馈列表 | ❌ 缺失 |
| `/teacher/feedbacks/stats` | GET | 反馈统计 | ❌ 缺失 |

### 校本课程

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/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 | 课程课时列表 | ❌ 缺失 |

### 课程包管理

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/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 | 课时趋势 | ❌ 缺失 |

### 操作日志

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/admin/operation-logs` | GET | 操作日志列表 | ✅ |
| `/admin/operation-logs/stats` | GET | 日志统计 | ❌ 缺失 |

---

## 六、文件上传 (/files)

| 路径 | 方法 | 功能 | 新后端状态 |
|------|------|------|----------|
| `/files/upload` | POST | 上传文件 | ✅ |
| `/files/:id` | DELETE | 删除文件 | ✅ |

---

## 缺失接口汇总

### 高优先级 (前端可能使用)

| 接口路径 | 方法 | 功能 | 所属模块 |
|---------|------|------|---------|
| `/school/tasks/:id/remind` | POST | 发送提醒 | 学校任务 |
| `/teacher/tasks/upcoming` | GET | 即将到期任务 | 教师任务 |
| `/teacher/tasks/:id/remind` | POST | 发送提醒 | 教师任务 |
| `/teacher/dashboard/recommend` | GET | 推荐课程 | 教师仪表板 |
| `/teacher/dashboard/lesson-trend` | GET | 课时趋势 | 教师仪表板 |
| `/teacher/dashboard/course-usage` | GET | 课程使用情况 | 教师仪表板 |

### 中优先级 (报告/统计)

| 接口路径 | 方法 | 功能 | 所属模块 |
|---------|------|------|---------|
| `/school/reports/overview` | GET | 总览报告 | 学校报告 |
| `/school/reports/teachers` | GET | 教师报告 | 学校报告 |
| `/school/reports/courses` | GET | 课程报告 | 学校报告 |
| `/school/reports/students` | GET | 学生报告 | 学校报告 |
| `/school/operation-logs/stats` | GET | 日志统计 | 学校日志 |
| `/admin/operation-logs/stats` | GET | 日志统计 | 管理员日志 |
| `/admin/stats/lesson-trend` | GET | 课时趋势 | 管理员统计 |
| `/admin/courses/:courseId/lessons` | GET | 课程课时列表 | 管理员课程 |

### 低优先级 (辅助功能)

| 接口路径 | 方法 | 功能 | 所属模块 |
|---------|------|------|---------|
| `/teacher/feedbacks` | GET | 反馈列表 | 教师反馈 |
| `/teacher/feedbacks/stats` | GET | 反馈统计 | 教师反馈 |
| `/school/feedbacks` | GET | 反馈列表 | 学校反馈 |
| `/school/feedbacks/stats` | GET | 反馈统计 | 学校反馈 |
| `/school/resource-libraries` | GET | 资源库列表 | 学校资源 |
| `/school/resource-items` | GET | 资源项列表 | 学校资源 |
| `/admin/resources/items/batch-delete` | POST | 批量删除资源项 | 管理员资源 |
| `/admin/resources/stats` | GET | 资源统计 | 管理员资源 |

---

## 总结

**旧后端接口总数**: 约 200 个
**新后端已实现**: 约 180 个
**缺失接口**: 约 20 个

**缺失接口分类**:
- 高优先级：6 个
- 中优先级：8 个
- 低优先级：8 个

**建议实施顺序**:
1. 先补充高优先级接口（发送提醒、即将到期任务、仪表板增强）
2. 再补充中优先级接口（报告、统计）
3. 最后补充低优先级接口（反馈、资源）
