功能简介

课程增免修及补选面向学生发起、教师与学院逐级审核的教学事务办理：学生在线提交补选 / 增修 / 删除课程 / 免修四类申请并上传任课教师签字材料，申请按学院配置的流程依次流转到任课教师 → 学院（教学管理员） → 学院分管领导审核，每个环节可通过或退回，最终成为「已通过」。学生侧能查看本人申请、撤销待处理申请、对退回件改后重提；教师侧处理派发给本人的待办；学院侧在审批列表查询、统计、导出、审批与删除；管理员可在「流程设计」按学院开关各环节。这是少数面向学生的业务模块（与监考不同）。

入口与权限

菜单「课程增免修及补选」在账号具备 can_access_course_changes 且当前学院已开通「课程增免修」模块时显示，各子项按角色显隐：

• 申请列表 课程增免修及补选 → 申请列表（/course_changes，所有可访问角色可见）。这是统一入口，会按角色重定向：教师跳「教师待办」、学院/审批角色跳「审批列表」、学生留在本人申请列表。
• 教师待办 → 教师待办（/teacher/course_changes，具备 can_course_change_teacher_action 即学院 teacher 角色者可见）。
• 审批列表 → 审批列表（/admin/course_changes，具备 can_manage_course_changes 的教学管理员 / 学院分管领导 / 教务处对应科室 / 学院系统管理员 / 超管可见）。
• 流程设计 → 流程设计（/workflow_design?module_key=course_change，学院系统管理员 / 超管 / 教务处教学办类管理员可见）。

可用角色：学生（student，提交申请）、授课教师（teacher，教师审核）、教学管理员（teaching_office_admin / 学院 admin，学院审核）、学院分管领导（leader，领导审核）、教务处对应科室角色、超级管理员。前提是当前学院已开通本模块。学生量化口径上只有学生能新建/编辑/撤销/删除申请；is_admin/is_super_admin 不被视为 student。

操作步骤（分角色）

学生：提交申请

1. 进入「申请列表」→「新建申请」（/course_changes/new）。
2. 选择申请类型（补选 / 增修 / 删除课程 / 免修）与学期（默认按当前日期生成 YYYY-YYYY-1/2，8 月起算上学期）。仅当该类型当前处于学院开放窗口（流程设计里对应 *_enabled 开关为开）时才可提交，否则提示「不在申请窗口期」。
3. 核对系统带出的个人信息（姓名、一卡通号、班级、学院、电话来自注册档案；缺姓名或一卡通号会被拦截）。
4. 填写课程明细。不同类型必填字段不同：

• 补选 supplement：课程名、上课时间、任课教师意见、教师签字；并必须上传任课教师意见和签字附件。
• 删除课程 delete：课程名、上课时间、教学班、任课教师意见、教师签字；同样必须上传签字附件。
• 增修 add：课程名、上课时间、任课教师、教学班。
• 免修 exempt：课程名、学分、总成绩、原任课教师。

1. 填写申请理由（提交时必填）；可选开课学院、上传 pdf/office/图片附件。
2. 点「提交」正式提交，或「保存草稿」暂存（草稿不校验完整性）。一次只能提交一门课程，多门请分别提交。
3. 提交时若已存在「同一学期 + 同一事项 + 同一课程 + 处于待处理（pending_*）」的申请，会被拦截去查看已有那条，防重复提交。
4. 回「申请列表」查看状态与处理进度。

学生列表页按钮口径（与状态强相关）：

• 编辑：仅「草稿 / 已撤销 / 已退回」可编辑（退回件改后可重新提交）。
• 删除：仅「草稿 / 已撤销」可删除（连同附件物理文件清理）。
• 撤销：仅处于 pending_*（待处理中）且下一流程尚未处理过的申请可撤销；撤销后状态变「已撤销」，可再次编辑提交。一旦教师/学院/领导已对其执行过通过或退回，则不能再撤销。

教师：审核派发给本人的申请（教师审核模式 B）

仅当学院启用「教师审核」且模式为 B 时，申请提交后会落到 pending_teacher 并按任课教师姓名派单给具体教师。

1. 进入「教师待办」，仅列出派发给本人且处于「待教师审核」的申请（按 CourseChangeTeacherAssignee 派单，或明细里 teacher_user_id/teacher_card_id 命中本人）。
2. 打开某条，核对学生信息、课程明细与附件。
3. 选「通过」→ 状态进入「待学院审核」（pending_clerk）；或「退回」→ 状态变「已退回」，退回必须填写审批意见；通过时意见留空默认记为「同意」。

派单解析：提交时若教师姓名缺失或同一申请内姓名不一致，系统自动降级为学院审核（直接置 pending_clerk，并写一条 teacher 步骤的 skip 日志说明降级原因），不再卡在教师环节。

学院 / 领导：审批列表与逐级审核

1. 进入「审批列表」（/admin/course_changes），按学期、申请类型、状态、学号、姓名、提交日期（单日或区间）筛选；页面给出按状态、按类型的统计汇总。
2. 点单条进入详情（/admin/course_changes/<id>）查看明细、附件、完整审批日志（含操作者真实姓名映射）。
3. 在详情页对当前环节执行通过 / 退回：

• pending_clerk（待学院审核）：教学管理员（can_course_change_clerk_action）通过 → 若启用领导环节则转「待学院领导审核」，否则直接「已通过」。
• pending_dean（待学院领导审核）：分管领导（can_course_change_leader_action）通过 → 「已通过」。
• 任一环节退回 → 「已退回」，必须填意见。

1. 代审入口（需对应开关）：管理员/学院审核人可在审批列表对处于教师/领导环节但本人非该环节的申请走代审，前提是流程设计已开「允许管理员代教师审核 / 代领导审核」。代教师审核会校验被代教师账号确有 teacher 角色并解析其账号；代领导审核需能解析到学院唯一分管领导账号；代审意见自动追加「（代办：xxx）」后缀。越权点代审会弹友好拒绝页而非直接 403。
2. 导出：/admin/course_changes/export 按当前筛选条件导出结果。
3. 删除：审批列表/详情可删除异常申请记录（/admin/course_changes/<id>/delete）。

环节校验严格按状态匹配角色：pending_teacher 只认教师权限、pending_clerk 只认学院审核权限、pending_dean 只认领导权限；非可审批状态（如已通过/已退回/草稿）POST 审批会被拒。

管理员：流程设计（按学院配置链路）

进入「流程设计」选 module_key=course_change 并选学院，可配置（存中央库 workflow_configs.config_json，未配置则保持默认现状）：

• 是否启用教师审核（teacher_enabled）及教师审核模式 A / B（teacher_mode）。模式 B 才会真正生成 pending_teacher 并派单到具体教师；否则申请直接进入学院审核。
• 是否启用分管领导审核（leader_enabled，默认开）。关闭后学院审核通过即「已通过」。
• 是否允许管理员代教师审核 / 代领导审核（allow_admin_proxy_teacher / allow_admin_proxy_dean）。
• 各申请类型开放开关（supplement/add/delete/exempt_enabled）：作为学生端的「申请窗口期」总闸，关闭的类型学生无法提交。

详见 流程设计。

字段与状态口径

申请类型（request_type）

状态（status，来自 course_change_status_label）

审批步骤（step，course_change_step_label）：student 学生提交 / teacher 任课教师 / clerk 学院审核 / dean 学院领导。

审批动作（action，course_change_action_label）：draft 保存草稿 / submit 提交 / revoke 撤销 / approve 通过 / return 退回（旧 reject 并入退回）/ skip 跳过（教师环节降级时记录）。

附件：仅允许 pdf、xls、xlsx、doc、docx、png、jpg、jpeg；补选与删除课程必须上传任课教师签字材料。

常见问题

• 菜单看不到本模块：当前学院未开通「课程增免修」模块，或账号无 student/teacher/教学办/领导等任一对应角色。
• 提交时提示"不在申请窗口期"：该申请类型在本学院流程设计里被关闭（对应 *_enabled 关），联系教学管理员开放。
• 提示已存在待处理申请：同一学期+同一事项+同一课程已有处于 pending_* 的申请，系统防重复，去查看那条即可。
• 提交后没进教师环节：未启用教师审核或为模式 A；或教师姓名缺失/不一致触发自动降级，直接进入学院审核（日志有 skip 说明）。
• 教师待办里看不到某申请：仅展示「待教师审核」且派发给本人的；状态已流转或未派到本人都不显示。
• 学生不能撤销：该申请已被下一环节处理过（教师/学院/领导已通过或退回），或已不在 pending_* 状态。
• 不能编辑/删除：编辑仅限草稿/已撤销/已退回；删除仅限草稿/已撤销。
• 代教师/代领导审核点不动：未在流程设计开对应代审开关，或解析不到被代教师账号（缺 teacher 角色）/学院唯一分管领导账号。
• 退回提交不了：退回必须填写审批意见。

相关页面

• 流程设计 课程增免修各环节（教师审核启停与模式、领导审核、代审开关、申请类型窗口）的按学院配置入口
• 登录与注册 学生注册与个人信息（姓名、一卡通号、班级、学院、电话）是申请表自动带出与提交校验的来源