hzdyjs/docs/开发文档/API/学生学籍异动与换班级API.md

学生学籍异动与换班级API

模块说明

本文档用于说明学生学籍异动（退学、休学、复学、毕业）与换班级相关接口，重点包含“复学并换班级”事务化组合接口。

• 基础路径：/studentMsg/studentStatusChange
• 关联模块：/studentMsg/studentClassChange

1. 批量新增学籍异动

• 请求方式：POST
• 请求路径：/studentMsg/studentStatusChange/batch
• 功能描述：批量提交学籍异动记录（适用于退学、休学、毕业、普通复学）

2. 复学并换班级（事务化组合接口）

• 请求方式：POST
• 请求路径：/studentMsg/studentStatusChange/resume-with-class-change
• 功能描述：一次提交同时写入
  • 学籍异动表 1 条（changeType=FU_XUE）
  • 换班级表 1 条（新学院/新专业/新班级）
• 事务说明：任一写入失败则整体回滚，避免“只复学未换班”或“只换班未复学”的数据不一致

请求参数

参数名	类型	必填	说明
studentId	Long	是	学生ID
studentNo	String	是	学号
studentName	String	否	学生姓名
originalCollegeId	Long	否	原学院ID
originalCollegeName	String	否	原学院名称
originalMajorId	Long	否	原专业ID
originalMajorName	String	否	原专业名称
originalClassId	Long	否	原班级ID
originalClassName	String	否	原班级名称
newCollegeId	Long	是	新学院ID
newCollegeName	String	否	新学院名称
newMajorId	Long	是	新专业ID
newMajorName	String	否	新专业名称
newClassId	Long	是	新班级ID
newClassName	String	否	新班级名称
effectiveDate	Date	是	生效日期（复学与换班级共用）
reason	String	是	原因（复学原因，同时写入换班级原因）
operatorId	Long	否	经办人ID
operatorName	String	否	经办人姓名

请求示例

{
  "studentId": 197001010001,
  "studentNo": "20240001",
  "studentName": "张三",
  "originalCollegeId": 201,
  "originalCollegeName": "信息工程学院",
  "originalMajorId": 301,
  "originalMajorName": "软件技术",
  "originalClassId": 401,
  "originalClassName": "软技2401",
  "newCollegeId": 202,
  "newCollegeName": "智能制造学院",
  "newMajorId": 302,
  "newMajorName": "机电一体化技术",
  "newClassId": 402,
  "newClassName": "机电2402",
  "effectiveDate": "2026-03-13",
  "reason": "学生复学并调整到新班级",
  "operatorId": 100,
  "operatorName": "管理员"
}

响应说明

• 成功响应：R<Void>，code=200
• 失败响应：R<Void>，code!=200，并返回错误信息

3. 学生信息页批量换班级（前端）

• 入口：学生信息页「换班级」按钮（权限 studentMsg:class:change）
• 行为：勾选 1～N 名学生，共用同一目标学院/专业/班级/生效时间/原因
• 实现：前端串行多次调用 POST /studentMsg/studentClassChange，每人一条记录，status=0
• 后端：无新接口；班级实际变更仍由后台脚本 学生换班级/process_student_class_change_fixed.sh 处理
• 边界：已在目标班级的学生跳过并计入失败明细；部分失败不回滚已成功记录

更新记录

日期	更新内容	更新人
2026-09-15	补充学生信息页批量换班级说明	Cursor
2026-03-13	新增“复学并换班级”事务化组合接口文档	Cursor