文档接口：修订并冻结API Contract V1.0.2

docs/api-v2/02_module_a_base_resource_api.md

@@ -137,7 +137,11 @@
 ### 4.1 教室管理 (Classroom)
 - `GET /train/classroom/list` 【P0】【确认】(分页查询教室，排课选普通教室必用)
 - `GET /train/classroom/{classRoomId}` 【P0】【确认】(获取教室详情及绑定班牌)
-- `POST /train/classroom` 【P0】【确认】(新增教室：`roomName`, `roomLocation`, `capacity`, `roomStatus`)
+  - **响应数据：** `ClassroomDetailVO` (教室状态 `roomStatus` 语义为：0 正在使用, 1 可用空闲, 2 其他)
+  - **1:N 关联语义：** 一个 Classroom 可关联 0..N 个 ElectronicBoard（依据 Database V2，`train_electronic_board.bind_classroom_id` 没有 UNIQUE 约束）。严禁将关联关系弱化为 1:1，禁止在契约中定义 `electronicBoard`、`primaryBoard` 或 `preferredBoard`，严禁“取第一条班牌作为默认班牌”。
+  - **空值处理：** 当教室无绑定班牌时，`boards` 属性必须返回空列表 `[]`，不得返回 `null`。
+  - **端点边界：** 不新增独立子资源接口（如 `/classroom/{id}/boards`），班牌轻量摘要信息作为教室详情响应（`ClassroomDetailVO.boards`）内嵌返回。
+- `POST /train/classroom` 【P0】【确认】(新增教室：`roomName`, `roomLocation`, `capacity`, `roomStatus` [0正在使用 1可用空闲 2其他])
 - `PUT /train/classroom/{classRoomId}` 【P1】【确认】(修改教室)
 
 ### 4.2 实训场地管理 (Training Site)