--- schema: "hl-changelog/v2" ticket: "5730" title: "房型 BIG_BED 字典补中文(住宿安排/行程/配房全链路显示「大床房」)" consumer: "admin" author: "wx(GIT)" change_type: "修改接口" backend_status: "deployed" gateway_status: "verified" frontend_status: "implemented" frontend_owner: "mmg" frontend_ref: "3ec1a933" 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 数据补齐),前端无需改动。 ## 前端实证确认(2026-08-09 mmg,hl-admin@3ec1a933) 主路径无需改动(后端 `roomCategoryLabel` 字典动态映射正常返回「大床房」,后端实证 20 处全中)。但前端实证发现一处可加固点,已补: - **实证**:grep 全 `src/` 零 BIG_BED 硬编码;展示走 `roomCategoryLabel || roomCategoryLabel(code)`——后端 label 优先,本地兜底表降级。本地兜底表 `ROOM_CATEGORY_LABEL`(`orderDetailAdapter.js`)缺 BIG_BED,仅当后端 label 缺失的降级场景会回落英文 code。 - **补固**:本地兜底表补 `BIG_BED: '大床房'`(与 QUEEN 同显),覆盖后端 label 缺失的降级路径。单行、低风险。 - 验证:orderDetailAdapter + v3Adapter 83/83 通过;checkpoint 全绿。