# 实训室结构化布局接口说明 布局不再使用 `layoutDescription` 文本,而是使用整数字段 `layoutRows` 和 `layoutColumns`。`seatCount` 由服务端按两者乘积计算,请求可以不传;如果传入, 必须与乘积一致。 ## 新增或编辑布局 3行4列实训室请求示例: ```json { "name": "第一实训室", "location": "A101", "allDay": true, "layoutRows": 3, "layoutColumns": 4 } ``` 列表、详情和新增成功响应会返回: ```json { "seatCount": 12, "layoutRows": 3, "layoutColumns": 4 } ``` ## 查询机位状态 管理端: `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` 字段。