From 8af58c6c2640c65c0f0e3ad3233e28149550d4a7 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 9 Aug 2026 10:58:14 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E6=88=BF=E5=9E=8B=20BIG=5FB?= =?UTF-8?q?ED=20=E5=AD=97=E5=85=B8=E8=A1=A5=E4=B8=AD=E6=96=87=E5=85=A8?= =?UTF-8?q?=E9=93=BE=E8=B7=AF=E6=98=BE=E7=A4=BA=E5=A4=A7=E5=BA=8A=E6=88=BF?= =?UTF-8?q?=EF=BC=88#5730=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...典补中文全链路显示大床房-修改接口-管理后台.md | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 changelogs-v2/2026-08/09_5730_房型BIG_BED字典补中文全链路显示大床房-修改接口-管理后台.md diff --git a/changelogs-v2/2026-08/09_5730_房型BIG_BED字典补中文全链路显示大床房-修改接口-管理后台.md b/changelogs-v2/2026-08/09_5730_房型BIG_BED字典补中文全链路显示大床房-修改接口-管理后台.md new file mode 100644 index 0000000..0652fca --- /dev/null +++ b/changelogs-v2/2026-08/09_5730_房型BIG_BED字典补中文全链路显示大床房-修改接口-管理后台.md @@ -0,0 +1,60 @@ +--- +schema: "hl-changelog/v2" +ticket: "5730" +title: "房型 BIG_BED 字典补中文（住宿安排/行程/配房全链路显示「大床房」）" +consumer: "admin" +author: "wx(GIT)" +change_type: "修改接口" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "not_required" +frontend_owner: "" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "后端完成：PR #5731 已合并 dev-v3 并部署 TEST（hl-user-service）。room_category 字典补充 BIG_BED→大床房（migration V20260809_001），行程/住宿安排/配房等所有展示处（roomCategoryLabel 字典动态映射）自动命中中文；实证 BIG_BED 订单详情 20 处 roomCategoryLabel 全部为「大床房」。无 API 契约变化，前端无需改动。" +updated_at: "2026-08-09" +base: "dev-v3" +generated: "2026-08-09T11:00:00+08:00" +--- + +# 房型 BIG_BED 字典补中文（住宿安排/行程/配房全链路显示「大床房」） + +> 后端完成：PR [#5731](https://git.1814.love:8443/wx/HL/pulls/5731) 已合并 dev-v3 并部署 TEST，网关实证通过。 + +## 关联 / 联系人 + +### 链接 + +- **Issue**: [#5730](https://git.1814.love:8443/wx/HL/issues/5730) +- **PR**: [#5731](https://git.1814.love:8443/wx/HL/pulls/5731) +- **Merge commit**: [0d6654e35](https://git.1814.love:8443/wx/HL/commit/0d6654e35) + +### 联系人 + +- **后端负责人**: @wx + +## 背景 + +运营实测：住宿安排房型显示英文「BIG BED1」，应显示「大床房」。根因：`order_settlement_hotel.room_type` 存量存英文枚举 `BIG_BED`，但房型分类字典 `room_category` 缺 BIG_BED 条目（TEST 原仅 11 项），行程/住宿安排/配房等展示处的 `roomCategoryLabel` 字典翻译（code→label，未命中降级回 code）映射不到中文。 + +## 变更内容 + +`hl-user-service` 新增字典迁移 `V20260809_001`：`room_category` 补充 `BIG_BED → 大床房`（dict_data_id=5001000000000003210，sort_order=11 追加，不扰动既有排序）。配房表存的是 code 非 label、展示处均为字典动态映射，补字典后全链路自动生效，无需回填快照。与 #5630（写入侧校验房型分类必须在字典内）方向一致——BIG_BED 从此为合法字典 code。 + +## 行为变化 + +| 场景 | 变更前 | 变更后 | +|------|--------|--------| +| 住宿安排/行程/配房展示 BIG_BED 房型 | 显示英文 code「BIG BED」 | 显示中文「大床房」 | +| 其余房型（STANDARD/SINGLE/TWIN/QUEEN/DELUXE/KING/SUITE/FAMILY/YURT/SPECIAL/PARENT_CHILD） | 中文 label | 不变 | + +## 验证证据 + +- **网关实证（TEST，ROOM_MANAGER）**：`GET /admin/house/orders/2086260844957487105`（BIG_BED 订单，order_settlement_hotel 20 行 BIG_BED）→ **200，20 处 roomCategoryLabel 全部=「大床房」**。 +- **字典完整性**：room_category ACTIVE 12 项（既有 11 项保留 + BIG_BED）。 +- **测试**：新增 `RoomCategoryBigBedDictionaryMigrationTest` 3/3；hl-user-service verify **3530 tests 全绿**（含既有字典迁移测试）；hl-resource-service `RoomTypeCategoryValidationTest` 8/8（#5630 校验回归）。 + +## 前端交接 + +无接口契约变化（字段、结构、错误码均不变，仅字典 label 数据补齐），前端无需改动。