提交

docs/开发文档/API/宿舍房间管理API.md

@@ -11,6 +11,7 @@
 - [4. 宿舍床位管理](#4-宿舍床位管理)
   - [4.1 获取房间床位详细信息列表](#41-获取房间床位详细信息列表)
   - [4.2 获取宿舍楼床位详细信息列表](#42-获取宿舍楼床位详细信息列表)
+  - [4.3 批量收回宿舍床位](#43-批量收回宿舍床位)
 
 ## 1. 宿舍楼树形结构
 
@@ -678,4 +679,42 @@ async function loadBedDetailsByBuilding(buildingId) {
 1. **宿舍管理**：管理员查看房间或宿舍楼的床位分配情况
 2. **学生信息核查**：快速查看入住学生的基本信息
 3. **统计分析**：进行床位利用率、学院分布等数据分析
-4. **报表生成**：生成宿舍入住情况报表 
+4. **报表生成**：生成宿舍入住情况报表 
+
+### 4.3 批量收回宿舍床位
+
+#### 接口说明
+将选中的床位从当前分配状态恢复为空闲状态，并记录退宿时间等信息。
+
+#### 请求方式
+```
+POST /dormBedStudent/dormBedStudent/batchRecall
+```
+
+#### 权限要求
+```
+dormBedStudent:dormBedStudent:edit
+```
+
+#### 请求参数
+| 参数名 | 类型 | 必须 | 说明 |
+|--------|------|------|------|
+| bedIds | Long[] | 是 | 要收回的床位ID列表 |
+
+示例：
+```json
+{ "bedIds": [1001, 1002, 1003] }
+```
+
+#### 处理逻辑
+- 更新 `xg_dorm_bed_student`：按 `bed_id`、`status=0`、`deleted=0` 命中记录，设置 `status=1(已退宿)`、`checkout_time=当前时间`、`update_time=当前时间`、`update_by=当前用户`。
+- 更新 `xg_dorm_bed`：按 `id in bedIds` 且 `deleted=0`，设置 `bed_status=0(空闲)`、`update_time=当前时间`、`update_by=当前用户`。
+- 更新 `xg_student_msg`：根据上述分配记录中的 `student_id` 汇总（过滤空），且 `deleted=0`，设置 `student_status=1`，并将 `ext_field1`、`dormitory_room`、`dormitory_building` 置空，同时更新 `update_time`、`update_by`。
+
+#### 返回结果
+```json
+{
+  "code": 200,
+  "msg": "操作成功"
+}
+```