69 行
3.9 KiB
Markdown
69 行
3.9 KiB
Markdown
---
|
||
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 全绿。
|