From 08fbb49e896d6f897e491d1eafc1ca6d9bf1324e Mon Sep 17 00:00:00 2001 From: zlwu <704541015@qq.com> Date: Tue, 15 Sep 2026 16:58:56 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E6=89=B9=E9=87=8F?= =?UTF-8?q?=E6=8D=A2=E7=8F=AD=E7=BA=A7=20API=20=E8=AF=B4=E6=98=8E=E4=B8=8E?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E7=8A=B6=E6=80=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .../2026-09-15-batch-student-class-change-design.md | 2 +- docs/开发文档/API/学生学籍异动与换班级API.md | 9 +++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/superpowers/specs/2026-09-15-batch-student-class-change-design.md b/docs/superpowers/specs/2026-09-15-batch-student-class-change-design.md index 8677b77f..216d431d 100644 --- a/docs/superpowers/specs/2026-09-15-batch-student-class-change-design.md +++ b/docs/superpowers/specs/2026-09-15-batch-student-class-change-design.md @@ -1,7 +1,7 @@ # 批量学生换班级 — 设计说明 **日期**: 2026-09-15 -**状态**: 已确认 +**状态**: 已实现 **范围**: 学生信息页「换班级」支持多人批量提交 **方案**: A — 前端循环调用现有单条接口 diff --git a/docs/开发文档/API/学生学籍异动与换班级API.md b/docs/开发文档/API/学生学籍异动与换班级API.md index 949e0ba6..86d60930 100644 --- a/docs/开发文档/API/学生学籍异动与换班级API.md +++ b/docs/开发文档/API/学生学籍异动与换班级API.md @@ -77,8 +77,17 @@ - 成功响应：`R`，`code=200` - 失败响应：`R`，`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 |