# 实训室管理与结构化布局接口说明 布局不再使用 `layoutDescription` 文本,而是使用整数字段 `layoutRows` 和 `layoutColumns`。`seatCount` 由服务端按两者乘积计算,请求可以不传;如果传入, 必须与乘积一致。 ## 新增或编辑布局 3行4列实训室请求示例: ```json { "name": "第一实训室", "location": "A101", "allDay": true, "layoutRows": 3, "layoutColumns": 4, "managerName": "张老师", "managerPhone": "010-12345678 转 8001" } ``` 列表、详情和新增成功响应会返回: ```json { "seatCount": 12, "layoutRows": 3, "layoutColumns": 4, "managerName": "张老师", "managerPhone": "010-12345678 转 8001" } ``` ## 新增、编辑管理员与联系电话 - 新增:`POST /training/room/admin`。 - 编辑:`PUT /training/room/admin`,提交完整表单并带上实训室 `id`。 - 编辑回显:`GET /training/room/admin/{id}`;管理员端、学员端列表也返回相同联系人字段。 前端新增和编辑表单均使用两个普通文本框(`input type="text"`): | 标签 | 绑定字段 | 最大长度 | 说明 | | --- | --- | --- | --- | | 管理员 | `managerName` | 100 | 直接输入姓名,不需要选择系统用户 | | 联系电话 | `managerPhone` | 50 | 按字符串提交,支持手机号、座机、国际区号及分机 | 两项沿用原管理员非必填规则;服务端去除首尾空白,空值保存为空字符串。 编辑提交空字符串、`null` 或省略字段均会清空对应值,因此前端须将详情中的两个字段 绑定到表单后一起提交。旧数据尚无联系人时,文本框以空字符串回显。 接口不再使用 `managerId`,联系电话不再从系统用户资料读取。 ## 查询机位状态 管理端: `GET /training/room/admin/{roomId}/seats?bookingDate=2026-08-31&slotCode=1` 管理端接口用于查看实验室布局和预约状态,可查询已经开始或已经结束的日期、时段, 不会执行学员端的可预约时间限制。 学员端: `GET /training/room/student/{roomId}/seats?bookingDate=2026-08-31&slotCode=1` 学员端接口同样用于查看实验室布局和机位状态。只要实训室处于运行中,即使所选时段 已经开始或结束也会正常返回;日期范围、开放时间和时段是否开始仅在提交创建预约时校验。 机位位置由服务端返回,前端不再解析布局文本: ```json { "data": [ { "id": "seat-1", "seatNo": 1, "rowNo": 1, "columnNo": 1, "status": "free", "bookingId": null }, { "id": "seat-2", "seatNo": 2, "rowNo": 1, "columnNo": 2, "status": "booked", "bookingId": "booking-1" } ] } ``` 机位状态: - `free`:该日期和时段可预约。 - `booked`:已预约、尚未开始。 - `using`:正在使用。 停用机位不会出现在可用性响应中。 ## 数据库迁移 部署新版本前执行 `sql/training_room_layout.sql`。脚本会将可识别的旧布局文本转为 行列数,然后删除 `layout_description` 字段。 联系人字段变更需在部署应用前执行 `sql/training_room_contact.sql`。 脚本新增 `manager_name`、`manager_phone` 并从原有效用户账号回填历史联系人;重复执行 不会覆盖已录入或已清空的文本。历史 `manager_id` 列保留,但新版应用不再读写。