# 教师端教案管理接口 所有接口统一使用前缀 `/teaching/plan/teacher`,并从请求头 `Authorization` 解析当前用户。 服务端要求用户具有 `phone_role.role_name=教师`,且不会接收客户端传入的 `teacherId`。 部署前执行 `src/main/resources/sql/teaching_plan.sql` 创建教案主表和附件关联表。 ## 1. 分页查询教案 `POST /teaching/plan/teacher/page` ```json { "pageNum": 1, "pageSize": 10, "keyword": "高处作业", "status": "DRAFT", "startDate": "2026-08-01", "endDate": "2026-08-31" } ``` `status` 支持 `ALL`、`DRAFT`、`PENDING`、`APPROVED`、`REJECTED`。关键字同时匹配教案标题和课程名称, 日期范围包含起止日期。返回项目统一的 `TableDataInfo` 分页结构,每条教案均包含当前有效附件。 ## 2. 新增、详情、编辑和删除 - `POST /teaching/plan/teacher`:新增教案,状态固定为 `DRAFT`。 - `GET /teaching/plan/teacher/{id}`:查询本人教案详情。 - `PUT /teaching/plan/teacher/{id}`:编辑本人草稿。 - `DELETE /teaching/plan/teacher/{id}`:逻辑删除本人草稿及附件关系。 新增或编辑请求示例: ```json { "title": "高处作业安全教案", "courseName": "高处作业安全", "teachingDate": "2026-08-20", "classHours": 2, "teachingObjectives": "掌握高处作业基本安全要求", "teachingContent": "安全防护用品使用和风险识别", "keyPoints": "正确使用安全带", "difficultPoints": "复杂环境风险识别", "teachingMethods": "讲授、演示与案例讨论", "teachingProcess": "导入、讲授、演示、练习和总结", "afterClassSummary": "选填的课后总结" } ``` 标题和课程名称最多 200 个字符;六个教学正文均为必填项且单项最多 20000 个字符;课时必须为正整数。 状态不是 `DRAFT` 时,编辑和删除接口都会拒绝操作。 ## 3. 状态流转 `PUT /teaching/plan/teacher/{id}/status` ```json { "status": "PENDING" } ``` 本期状态由教案所属教师本人维护,不记录审核意见或历史。只允许以下流转: - `DRAFT → PENDING` - `PENDING → APPROVED` - `PENDING → REJECTED` - `REJECTED → DRAFT` `APPROVED` 为终态。驳回教案必须先退回 `DRAFT`,才能继续编辑、删除或管理附件。 ## 4. 附件 - `POST /teaching/plan/teacher/{id}/attachments`:使用 `multipart/form-data`,字段名为 `files`,可在一个请求中上传多个文件。 - `DELETE /teaching/plan/teacher/{id}/attachments/{attachmentId}`:删除单个草稿附件。 - `GET /teaching/plan/teacher/{id}/attachments/{attachmentId}/download`:校验教师、教案和附件关系后下载。 每份教案最多保留 10 个附件,支持 PDF、DOC、DOCX、PPT、PPTX,扩展名不区分大小写,单个附件不得超过 50 MiB。上传和删除附件仅允许在 `DRAFT` 状态执行;下载在任意有效状态均可执行。接口不返回服务器文件路径。