docs(changelog-v2): 定制师侧订单详情/调整快照候选暴露真实房型 roomTypeId(#4204 P2,PR#4313)

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` 后，新单真实房型贯穿展示（后端读写两侧已就绪）。