# 管理员端课程管理接口 接口统一使用 `/class/subject/admin` 前缀,所有请求都必须携带 `Authorization`。服务端从 JWT解析当前用户,并校验 `phone_role.role_name=管理员`,不接受客户端提交管理员用户ID。 部署前依次执行: 1. `src/main/resources/sql/class_management.sql` 2. `src/main/resources/sql/course_management.sql` 第二个脚本将 `class_subject.subject_hour` 调整为 `decimal(5,1)`,补充创建/更新时间和班级、 教师日期索引。两个脚本都可重复执行。 ## 1. 班级导航树 `GET /class/subject/admin/tree?keyword=污水` 返回 `OCCUPATION → YEAR → LEVEL → CLASS` 四层节点,结构与班级管理树一致。班级叶节点的 `classId` 用于后续课程查询和新增请求。 ## 2. 表单选项 `GET /class/subject/admin/options` 返回有效授课教师和固定课程类型:`理论`、`实训`、`考核`。教师选项的 `value` 是用户ID, `label` 是姓名,`extra` 是手机号;保存时必须提交ID,不能提交教师姓名。 ## 3. 查询班级课程表 `GET /class/subject/admin/classes/{classId}` 可选参数:`startDate=2026-09-01&endDate=2026-09-30`。返回班级名称、工种、年度、等级、 培训起止日期、学期展示值 `termName`、学员人数、课程数量、总课时和课程数组。`termName` 按开班月份生成(1~6月为春季、7~12月为秋季)。每节课程示例: ```json { "id": 1001, "classId": 10, "date": "2026-09-08", "week": "周二", "subjectTimes": 2, "timeFrames": ["09:00-10:20", "10:40-12:00"], "subjectHour": 2.0, "subjectName": "水污染知识", "teacherId": "1900000000000000001", "teacherName": "王建国", "location": "A栋302", "type": "理论", "remark": null } ``` ## 4. 批量新增课程 `POST /class/subject/admin/batch` ```json { "classId": 10, "courses": [ { "date": "2026-09-08", "subjectTimes": 2, "timeFrames": ["09:00-10:20", "10:40-12:00"], "subjectHour": 2.0, "subjectName": "水污染知识", "teacherId": "1900000000000000001", "location": "A栋302", "type": "理论", "remark": "第一章" } ] } ``` - 单次至少1节、最多100节。 - 课程日期必须位于班级培训起止日期内;星期由服务端根据日期生成。 - 课次为1~40;课时为0.5~16并以0.5递增。 - 每节课程允许1~8个时段,格式为 `HH:mm-HH:mm`;同时兼容原型中的 `~`、`—`、`–`。 - 课程名称最多100字,地点最多255字,备注最多1000字。 - 同一班级或同一教师的课程时段不能重叠;首尾相接的时段不算冲突。 - 批量保存使用事务,任意一行失败都会整体回滚。错误消息带“第N节课程”行号。 成功后返回该班级刷新后的完整课程表。 ## 5. 编辑课程 `PUT /class/subject/admin/{courseId}` 请求体为批量新增中 `courses` 数组的单个元素,不接收 `classId`。编辑后返回该节课程。 课程一旦产生签到记录/签到场次、关联请假或评价任务,就禁止直接修改,以防业务数据与排课 信息不一致。 ## 6. 删除课程 `DELETE /class/subject/admin/{courseId}` 仅允许删除尚未产生签到、请假或评价数据的课程,成功返回 `true`。 ## 7. 导出课程表 `GET /class/subject/admin/classes/{classId}/export` 支持与列表相同的 `startDate`、`endDate` 参数,返回带UTF-8 BOM的CSV文件,可直接使用Excel 打开。导出内容使用服务端实时查询结果,不信任客户端拼装的数据。