hl-api-changelog/changelogs-v2/2026-08/09_5730_房型BIG_BED字典补中文全链路显示大床房-修改接口-管理后台.md
Mimingguang 5349d91d27
一些检查失败了
changelog-filename-gate / validate (push) Failing after 1s
docs(changelog): 5730 前端兜底表补 BIG_BED,implemented 3ec1a933
2026-08-09 11:13:30 +08:00

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 并部署 TESThl-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_001room_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_MANAGERGET /admin/house/orders/2086260844957487105BIG_BED 订单,order_settlement_hotel 20 行 BIG_BED200,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_LABELorderDetailAdapter.js)缺 BIG_BED,仅当后端 label 缺失的降级场景会回落英文 code。
  • 补固:本地兜底表补 BIG_BED: '大床房'(与 QUEEN 同显),覆盖后端 label 缺失的降级路径。单行、低风险。
  • 验证orderDetailAdapter + v3Adapter 83/83 通过;checkpoint 全绿。