文件
hl-api-changelog/changelogs-v2/2026-08/09_5730_房型BIG_BED字典补中文全链路显示大床房-修改接口-管理后台.md
T
Mimingguang 87ed9d0a3f
changelog-filename-gate / validate (push) Failing after 2s
chore(changelog): 全量清理 implemented 存量——81 条复核翻 verified + 1 条改判 not_required + #5827 补登 frontend_ref
处置明细(mmg 2026-09-18):
- 68 条机械核验通过批量翻 verified:frontend_ref 均可达且为 v2.1 祖先、
  交付文件 HEAD 均在、关联 spec 批量 58 文件 891 例全绿。
- 11 条带演进史的例外逐条核后翻 verified:3 条交付自删文件(06_5610/
  07_5655/11_5810,删除即交付内容且终态保持);8 条被后续 changelog 预期
  演进(10_5784→#5810、07_5664/08_5592→#5827、07_5665→去槽位化 U1、
  01_5380/05_5356/06_5567/06_5581→settlement 族A扁平化与 mock 清理),
  status_note 均如实记录演进链。
- 05_5552 改判 not_required:frontend_ref 自述前端无需改动,grep 实证
  vehicleFeeAmount.js 直接读后端 calendarPrice/calendarPriceMissing。
- 11_5827 frontend_ref 原空,经核交付即 753503c8(向导 4 步改 3 步提交
  即派定),补登全哈希 753503c87cc635e5646b4368a8ed506746c79cf1。
另:保险域 2 条相邻条目(05_5530/06_5593)同标准复核翻 verified。
2026-07 历史月 45 条按规则不回扫,保持原状。
2026-09-18 15:56:52 +08:00

4.1 KiB
原始文件 Blame 文件历史

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 verified mmg 3ec1a933 2026-09-18 后端完成:PR #5731 已合并 dev-v3 并部署 TEST(hl-user-service)。room_category 字典补充 BIG_BED→大床房(migration V20260809_001),行程/住宿安排/配房等所有展示处(roomCategoryLabel 字典动态映射)自动命中中文;实证 BIG_BED 订单详情 20 处 roomCategoryLabel 全部为「大床房」。无 API 契约变化,前端无需改动。[mmg 2026-09-18 批量复核翻 verified] ref 3ec1a933 可达且为 v2.1 祖先;交付文件 HEAD 均在;关联 spec 批量 891 例全绿。 2026-09-18 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)。
  • 测试:新增 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 全绿。