From 9ec621d8ec1b736d7332e961c8a550156aa10d43 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 24 Jun 2026 17:22:16 +0800
Subject: [PATCH] =?UTF-8?q?=E9=85=8D=E6=88=BF=E9=80=89=E6=8B=A9=E9=85=92?=
 =?UTF-8?q?=E5=BA=97=E5=80=99=E9=80=89=E5=88=97=E8=A1=A8:=E5=90=8E?=
 =?UTF-8?q?=E7=AB=AF=E8=BF=94=E5=85=A8=E9=9B=86=E5=B7=B2=E6=8E=92=E5=BA=8F?=
 =?UTF-8?q?,=E5=89=8D=E7=AB=AF=E9=9C=80=E5=85=A8=E9=87=8F=E6=B8=B2?=
 =?UTF-8?q?=E6=9F=93(=E5=89=8D=E7=AB=AF=E6=B8=B2=E6=9F=93=20bug=20?=
 =?UTF-8?q?=E6=BE=84=E6=B8=85)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...’店候选列表å�Žç«¯è¿”全集å‰�端需全é‡�渲染_管ç�†å�Žå�°.md | 29 +++++++++++++++++++
 1 file changed, 29 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..9ed80ae
--- /dev/null
+++ b/changelogs-v2/2026-06/24_�房选择酒店候选列表�端返全集�端需全�渲染_管���.md
@@ -0,0 +1,29 @@
+# �房「选择酒店�候选列表：�端返回全集 + 已排�，�端需全�渲染（接�说明·�端无改动）
+
+> �更类型：📖 接�使用说明（�端无改动；澄清�端渲染缺陷）
+> 端类型：管���（�房·「选择酒店�弹窗）
+> 日期：2026-06-24 ｜ �务：hl-order-service-v3 ｜ 接�：`GET /v3/admin/hotel-candidates`
+
+---
+
+## ⚠� 关键说明（定�为�端渲染 bug）
+- **现象**：�房「选择酒店�弹窗显示「共 N ��,列表��渲染 1 行（�剩池内/带标签那家）,城市内其余酒店没显示。
+- **定�**：**�端无问题**。`GET /v3/admin/hotel-candidates` 实测返回**城市内全部酒店**(测试�订� 2069593503129636865 第 1 晚返 **10 �**),且**已按「定制师点� > 产�池内 > 普通�排好�**(池内的海拉尔海棠排第 1)。
+- **根因**：该接� RespVO **没有 total / 分页字段**,�有 `candidates` 完整数组。�端「共 N ��= `candidates.length`,��端**已收到全部 N �**,��渲染了 1 行（疑似误按 `isPoolMatch / isConsultantRecommended = true` 过滤,把普通酒店�掉）。
+- **�端动作**：**全�顺�渲染 `candidates` 数组,��按标签过滤**。�端已排好�,带标签的天然在最�,普通酒店在�。
+
+## 1. 接�出�（关键字段，本次无�更）
+`GET /v3/admin/hotel-candidates` → `data.candidates[]`（完整数组,无分页,默认上� limit=10,�传 limit 上调,≤50）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `hotelName` | String | 酒店� |
+| `protoPrice` | String(BigDecimal) | �议价 |
+| `matchedRoomTypeLabel` / `matchedRoomTypeAvailable` | String / Integer | 匹�房型 / �用房 |
+| `isPoolMatch` | Boolean | 是�产�池内（�端标签「产�池内�） |
+| `isConsultantRecommended` | Boolean | 是�定制师点�（�端标签「定制师推��） |
+| `tags` | List&lt;String&gt; | ��标签（�原景观 / �早� / 性价比高 等） |
+| `recommendSource` / `score` | String / Double | 推��� / 排�分（�端已�此排�,�端勿�排,按返回顺�渲染��） |
+
+## 2. 测试�实测（order 2069593503129636865 第 1 晚）
+返回 **10 �**：海拉尔海棠（`isPoolMatch=true`,第 1）+ 呼伦�尔香格里拉 / 海拉尔嘉世豪 / �和瓦西里民宿 / �尔�纳白桦 / 满洲里凯旋 / �尔�纳豪星 / 海拉尔首旅京伦 / �尔�纳玖�万豪 / 黑山头弘�剌部 等 9 家城市内酒店。**�端应渲染全部 10 行**,当��显示 1 行�缺陷所在。