3.9 KiB
3.9 KiB
schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated
| schema | ticket | title | consumer | author | change_type | backend_status | gateway_status | frontend_status | frontend_owner | frontend_ref | target_release | verified_at | status_note | updated_at | base | generated |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | 5730 | 房型 BIG_BED 字典补中文(住宿安排/行程/配房全链路显示「大床房」) | admin | wx(GIT) | 修改接口 | deployed | verified | implemented | mmg | 3ec1a933 | 后端完成:PR #5731 已合并 dev-v3 并部署 TEST(hl-user-service)。room_category 字典补充 BIG_BED→大床房(migration V20260809_001),行程/住宿安排/配房等所有展示处(roomCategoryLabel 字典动态映射)自动命中中文;实证 BIG_BED 订单详情 20 处 roomCategoryLabel 全部为「大床房」。无 API 契约变化,前端无需改动。 | 2026-08-09 | dev-v3 | 2026-08-09T11:00:00+08:00 |
房型 BIG_BED 字典补中文(住宿安排/行程/配房全链路显示「大床房」)
后端完成:PR #5731 已合并 dev-v3 并部署 TEST,网关实证通过。
关联 / 联系人
链接
联系人
- 后端负责人: @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)。
- 测试:新增
RoomCategoryBigBedDictionaryMigrationTest3/3;hl-user-service verify 3530 tests 全绿(含既有字典迁移测试);hl-resource-serviceRoomTypeCategoryValidationTest8/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 全绿。