Quellcode durchsuchen

docs: 同步批量换班级 API 说明与设计状态

Co-authored-by: Cursor <cursoragent@cursor.com>
zlwu vor 1 Monat
Ursprung
Commit
08fbb49e89

+ 1 - 1
docs/superpowers/specs/2026-09-15-batch-student-class-change-design.md

@@ -1,7 +1,7 @@
 # 批量学生换班级 — 设计说明
 
 **日期**: 2026-09-15  
-**状态**: 已确认  
+**状态**: 已实现  
 **范围**: 学生信息页「换班级」支持多人批量提交  
 **方案**: A — 前端循环调用现有单条接口
 

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

@@ -77,8 +77,17 @@
 - 成功响应:`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 |