docs(changelog-v2): 房务房型 bedType 翻中文 + 配房详情补 roomTypeName (#4527 #4528)

changelogs-v2/2026-06/33_4527_房务房型bedType翻中文+配房详情补roomTypeName-修改接口-管理后台.md

@@ -0,0 +1,31 @@
+# 房务房型展示口径统一——候选房型 bedType 后端翻中文 + 配房详情补 roomTypeName
+
+> 端类型：管理后台（房务管家 / 配房）
+> 变更类型：修改接口（响应值/字段，**前端需配合**，非破坏性）
+> 涉及接口：
+> - `GET /v3/admin/hotel-candidates`（配房"选择酒店"候选列表）
+> - `GET /admin/house/orders/{orderId}`（房务订单详情聚合）
+> 关联工单：#4527 #4528（PR #4530，已合并部署测试服并实测）
+
+## 背景
+房务 E2E 测试发现房型展示两处口径问题，后端已修：① 候选房型 `bedType` 透传 resource 英文 code（TWIN_BED/KING_BED）未翻中文，与已翻的"大床"中英混用；② 房务配房详情卡片只有房型类目（room_category→"标准间"），缺真实房型名，与定制师侧"精品标间"不一致。
+
+---
+
+## 一、`GET /v3/admin/hotel-candidates` — `candidates[].roomTypes[].bedType` 改返中文
+
+- 后端已统一把 `bedType` 字典 code 翻成中文 label 返回：`TWIN_BED→双床`、`KING_BED→大床`、`DOUBLE_BED→双人床`、`SINGLE_BED→单人床`、`TATAMI→榻榻米`、`KANG→火炕`。
+- **前端改动：bedType 直接展示后端返回值即可，请勿再在前端做 code→中文 的二次翻译/映射**（以后端返回为准），避免双重翻译或映射缺项导致英文残留。
+- 降级说明：字典异常或 resource 存了非标准 code（如个别房型 `bed_type=KING` 而非 `KING_BED`）时，后端降级原样返回该值，前端按原样展示即可（此类属 resource 数据问题，另行治理）。
+
+## 二、`GET /admin/house/orders/{orderId}` — `currentAssignments[]` 新增 `roomTypeName`
+
+- 房务订单详情每条已配房（currentAssignment）**新增字段 `roomTypeName`**（真实房型名，与定制师侧、需求口径一致，如"精品标间"/"主题标间"）。
+- **前端改动：配房卡片房型优先显示 `roomTypeName`；为 null 时回退显示 `roomCategoryLabel`（房型类目）。**
+- 降级说明：resource 取数异常/缺失时 `roomTypeName` 为 null（不阻断详情），故前端必须保留回退逻辑。
+
+---
+
+## 实测确认（测试服）
+- 候选接口 `bedType`：精品标间→双床、大床房→大床、蒙古包→双人床等已返中文 ✓
+- 详情 `currentAssignments[].roomTypeName`：DAY1 精品标间 / DAY2 标准间 / DAY3 主题标间，与定制师侧一致 ✓