From e7cc66b833393429fdbae0e1fa93a7f3e44fc62b Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 24 Jun 2026 18:20:57 +0800
Subject: [PATCH] =?UTF-8?q?=E9=85=8D=E6=88=BF=E9=80=89=E9=85=92=E5=BA=97?=
 =?UTF-8?q?=E5=BC=B9=E7=AA=97=E5=BE=85=E8=A1=A5=E9=80=89=E6=88=BF=E5=9E=8B?=
 =?UTF-8?q?+=E6=88=BF=E9=97=B4=E6=95=B0=EF=BC=88=E5=90=8E=E7=AB=AF=20roomT?=
 =?UTF-8?q?ypes=20=E5=B7=B2=E5=B0=B1=E7=BB=AA,=E5=89=8D=E7=AB=AF=E5=8A=A0?=
 =?UTF-8?q?=20UI=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...‰é…’店弹窗需补房型选择与房间数输入_管ç�†å�Žå�°.md | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 changelogs-v2/2026-06/24_�房选酒店弹窗需补房型选择与房间数输入_管���.md

diff --git a/changelogs-v2/2026-06/24_�房选酒店弹窗需补房型选择与房间数输入_管���.md b/changelogs-v2/2026-06/24_�房选酒店弹窗需补房型选择与房间数输入_管���.md
new file mode 100644
index 0000000..701a01b
--- /dev/null
+++ b/changelogs-v2/2026-06/24_�房选酒店弹窗需补房型选择与房间数输入_管���.md
@@ -0,0 +1,35 @@
+# �房「选择酒店�弹窗需补「选房型 + 填房间数�（�端 roomTypes 已就绪,�端加 UI；�端无改动）
+
+> �更类型：📖 �端待办（�端数� / 契约已�备,本篇为对接说明）
+> 端类型：管���（�房·「选择酒店�弹窗）
+> 日期：2026-06-24 ｜ �务：hl-order-service-v3 ｜ 接�：`GET /v3/admin/hotel-candidates`
+
+---
+
+## ⚠� 关键说明（�端功能缺失,�端无需改）
+- **现象**：�房「选择酒店�弹窗当��能勾选酒店,�能选房型��能填房间数。
+- **定�**：**�端已备好数�**——`hotel-candidates` �个候选酒店已返回完整 `roomTypes`（房型选项数组）;�交�房需求 VO 也支� `roomTypeId` + `roomCount`。**缺的是�端弹窗的房型下拉 + 房间数输入控件**。
+
+## 1. 候选房型选项（已返回,�端�此生�房型下拉）
+`GET /v3/admin/hotel-candidates` → `data.candidates[].roomTypes[]`（`RoomTypeOption`）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `roomTypeId` | String（雪花） | 房型 ID（�交�房需求时回传） |
+| `name` | String | 房型�称（如「精�标间�「豪�大床房�） |
+| `roomCategory` | String | 房型分类（字典 room_category：TWIN/KING/...） |
+| `bedType` | String | 床型 |
+| `maxOccupancy` | Integer | 最大入�人数 |
+| `available` / `stock` | Integer | 今日�用房数 / 总库存 |
+| `protocolPrice` / `basePrice` | String | �议价 / 标价 |
+| `inventoryStatus` | String | AVAILABLE / FULL / CLOSED |
+
+## 2. �端动作
+- 弹窗�个候选酒店行,**�作区加**：
+  1. **房型下拉**：用该酒店的 `candidate.roomTypes` 生�（展示 `name`,�附�议价 / �用房;`inventoryStatus≠AVAILABLE` 的房型置�或标记）。
+  2. **房间数输入框**：整数,默认 1。
+- 选定酒店 + 房型 + 房间数�回填�房需求候选,**�交时带回**：候选 `roomTypeId`（选中房型）+ 段 `roomCount`（房间数）。
+- �交契约��房需求�交 VO `HotelRequirementReqVO`：`days[].segments[].roomCount`（房间数）+ `segments[].candidates[].roomTypeId` / `roomTypeName`（房型）。
+
+## 3. 说明
+�端在工� #4204 已把房型下沉到候选级�`hotel-candidates` 暴露 `roomTypes`,本期「默认�按城市�（#4363）也已让候选跨城列全。房型选择与房间数填写纯属�端弹窗交互补全,�端无改动。