From ff9310192c13528f2dd151256bb756b2781ec08f Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sat, 27 Jun 2026 21:00:17 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?= =?UTF-8?q?=E6=88=BF=E5=9E=8B=20bedType=20=E7=BF=BB=E4=B8=AD=E6=96=87=20+?= =?UTF-8?q?=20=E9=85=8D=E6=88=BF=E8=AF=A6=E6=83=85=E8=A1=A5=20roomTypeName?= =?UTF-8?q?=20(#4527=20#4528)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...文+配房详情补roomTypeName-修改接口-管理后台.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 changelogs-v2/2026-06/33_4527_房务房型bedType翻中文+配房详情补roomTypeName-修改接口-管理后台.md diff --git a/changelogs-v2/2026-06/33_4527_房务房型bedType翻中文+配房详情补roomTypeName-修改接口-管理后台.md b/changelogs-v2/2026-06/33_4527_房务房型bedType翻中文+配房详情补roomTypeName-修改接口-管理后台.md new file mode 100644 index 0000000..8e6690f --- /dev/null +++ b/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 主题标间，与定制师侧一致 ✓