# 请假管理接口 请假人员由登录令牌解析出的用户 `id` 标识。教师端、管理端列表均展示学员完整手机号,不使用学号。请假审批为单级审批:教师或管理员任一方先处理后即生效,另一方不能重复审批。 ## 学员端 - `POST /leave/student/apply`:提交申请;按请假起止时间自动关联学员班级内时间重叠的全部课程。 - `POST /leave/student/attachment`:上传 JPG、PNG 或 PDF 证明材料,单个文件不超过 10MB;返回文件 `id` 后随申请提交。 - `PUT /leave/student/apply`:修改待审批申请,请求体中必须提供申请 `id`,并重新匹配课程。 - `PUT /leave/student/{leaveId}/withdraw`:撤回待审批申请。 - `POST /leave/student/page`:分页查询本人申请。 - `GET /leave/student/{leaveId}`:查看本人申请详情。 提交或修改示例: ```json { "id": "修改时填写,新增时不填", "leaveType": "SICK", "startTime": "2026-08-10 08:00:00", "endTime": "2026-08-10 18:00:00", "reason": "身体不适,需要到医院检查休息", "emergencyContactName": "张某某", "emergencyContactPhone": "13800138000", "attachmentFileIds": [101, 102] } ``` 请假类型为 `SICK`、`PERSONAL`、`OTHER`,请假原因须为10至200个字符;病假必须至少上传一份病历或诊断证明。紧急联系人选填,但姓名和手机号必须同时填写。系统不允许补交:申请开始时间及所有关联课程的计划开始时间都必须晚于当前时间。若关联课程已有 `NORMAL` 或 `LATE` 出勤记录,则拒绝申请。 ## 教师端 - `POST /leave/teacher/page`:分页查询本人授课课程关联的申请,展示完整手机号。 - `GET /leave/teacher/{leaveId}`:查看本人课程关联的申请详情。 - `PUT /leave/teacher/{leaveId}/review`:批准或驳回申请。教师只能审批至少关联一门本人授课课程的申请。 ## 管理端 - `POST /leave/admin/page`:分页查询全部申请,支持状态、类型、姓名/手机号和时间范围筛选。 - `GET /leave/admin/{leaveId}`:查看申请详情。 - `PUT /leave/admin/{leaveId}/review`:批准或驳回申请。 审批请求示例: ```json { "status": "APPROVED", "approvalOpinion": "同意" } ``` 审批结果只接受 `APPROVED` 或 `REJECTED`。批准前会再次检查关联课程是否已有正常或迟到签到;通过后,所有关联课程出勤状态写为 `LEAVE`。请假计入缺勤口径:出勤率分母包含请假,分子只包含正常和迟到。 本期不提供补交申请,也不提供 Excel 导出接口。