diff --git a/changelogs-v2/2026-06/23_4313_订单详情调整快照候选暴露真实房型roomTypeId_管理后台.md b/changelogs-v2/2026-06/23_4313_订单详情调整快照候选暴露真实房型roomTypeId_管理后台.md new file mode 100644 index 0000000..2c686d4 --- /dev/null +++ b/changelogs-v2/2026-06/23_4313_订单详情调整快照候选暴露真实房型roomTypeId_管理后台.md @@ -0,0 +1,31 @@ +# 定制师侧订单详情/调整快照:配房需求候选酒店暴露真实房型 roomTypeId/roomTypeName(已上线测试服·可对接) + +> 变更类型:✅ 修改接口(新增字段,已部署测试服并 API 验证,可对接) +> 端类型:管理后台(定制师侧·订单详情行程 / 调整「酒店安排」快照) +> 日期:2026-06-23 | 工单:#4204(P2) | PR:#4313 | 服务:hl-order-service-v3 +> 关联:承接同日 #4305(房务侧 P3,房务详情已暴露同字段)。这是**定制师侧**对称回显。 + +--- + +## 背景 +#4204 把配房需求房型从「段级抽象 roomCategory」下沉到「每家候选酒店各自的真实房型 roomTypeId」。P1(#4209) 已写库、P3(#4305) 房务侧已读出,本期(P2)**定制师侧**订单详情/调整快照也读出真实房型。 + +## 新增字段(两个接口、候选酒店维度) +1. `GET /v3/admin/order/{id}/itinerary` → 行程「配房需求」每天的候选酒店 `RequirementHotelVO` +2. `GET /v3/admin/order/{id}/adjustment/snapshot` → 「酒店安排」每天每段 `HotelSegmentVO` + +两处的候选/酒店项各**新增**: + +| 字段 | 类型 | 说明 | +|---|---|---| +| `roomTypeId` | String(雪花,可空) | 该候选酒店的**真实房型 ID** | +| `roomTypeName` | String(可空) | 该候选酒店的**真实房型名称** | + +**前端渲染**:展示候选酒店时,用 `roomTypeName`(真实房型)替代/优先于段级 `roomCategory`(抽象大类)。二者可能不同——例:同为段级「普通标间」,香格里拉真实房型=「普通标间」、嘉世豪真实房型=「标准间」。`roomTypeId/roomTypeName` 为 null(旧单未录真实房型)时回退展示 `roomCategory`。 + +## 实测(测试服 order 2068234602970828802) +- itinerary:香格里拉 `roomTypeName=普通标间`、嘉世豪 `roomTypeName=标准间`(真实房型,与段级大类不同)。 +- adjustment/snapshot:同样暴露 `roomTypeId/roomTypeName`(source=MANUAL)。 + +## 待前端(#4204 P5,mmg) +定制师**提交需求面板**改「先选酒店→选该酒店真实房型」录入 `roomTypeId` 后,新单真实房型贯穿展示(后端读写两侧已就绪)。