提交

docs/开发文档/API/API文档总览.md

@@ -100,6 +100,7 @@
 
 | 日期 | 版本 | 更新内容 | 更新人 |
 |------|------|---------|-------|
+| 2026-03-13 | 1.7 | 新增学生学籍异动与换班级API文档，补充复学+换班级事务化组合接口 | Cursor |
 | 2025-12-26 | 1.6 | 新增专业信息管理API，支持树形菜单+列表的专业管理 | Cursor |
 | 2025-12-26 | 1.5 | 新增二级学院管理API，支持二级学院的增删改查 | Cursor |
 | 2025-01-03 | 1.1 | 社团管理API更新：删除副社长信息卡片，role_type字段改为字符串类型 | 系统管理员 |
@@ -168,6 +169,7 @@
 |---------|------|------|----------|
 | [学生信息收集批次管理API](./学生信息收集批次管理API.md) | 学生信息收集批次班级权限管理 | ✅ 完成 | 2025-01-27 |
 | [学生信息批次收集API](./学生信息批次收集API.md) | 学生信息批次收集管理（新增） | ✅ 完成 | 2025-01-27 |
+| [学生学籍异动与换班级API](./学生学籍异动与换班级API.md) | 学籍异动与换班级（含复学+换班级事务接口） | ✅ 完成 | 2026-03-13 |
 | [班级信息管理API](./班级信息管理API.md) | 班级基础信息增删改查 | ✅ 完成 | 2025-01-27 |
 | [二级学院管理API](./二级学院管理API.md) | 二级学院组织信息管理 | ✅ 完成 | 2025-12-26 |
 | [专业信息管理API](./专业信息管理API.md) | 专业信息管理（树形菜单+列表） | ✅ 完成 | 2025-12-26 |

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

@@ -0,0 +1,84 @@
+# 学生学籍异动与换班级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 | 否 | 经办人姓名 |
+
+### 请求示例
+
+```json
+{
+  "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`，并返回错误信息
+
+## 更新记录
+
+| 日期 | 更新内容 | 更新人 |
+|---|---|---|
+| 2026-03-13 | 新增“复学并换班级”事务化组合接口文档 | Cursor |