From 5236c145999b4c60be1061b387f187bed594eaec Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 11 Aug 2026 17:57:10 +0800
Subject: [PATCH] =?UTF-8?q?changelog(#5846):=20=E9=85=8D=E6=88=BF=E5=80=99?=
 =?UTF-8?q?=E9=80=89=E5=AE=9A=E5=88=B6=E5=B8=88=E4=B8=BB=E9=80=89/?=
 =?UTF-8?q?=E5=89=AF=E9=80=89=E6=A0=87=E8=AF=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...…�房候选定制师主选副选-修改接å�£-管ç�†å�Žå�°.md | 78 +++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 changelogs-v2/2026-08/11_5846_�房候选定制师主选副选-修改接�-管���.md

diff --git a/changelogs-v2/2026-08/11_5846_�房候选定制师主选副选-修改接�-管���.md b/changelogs-v2/2026-08/11_5846_�房候选定制师主选副选-修改接�-管���.md
new file mode 100644
index 0000000..af32643
--- /dev/null
+++ b/changelogs-v2/2026-08/11_5846_�房候选定制师主选副选-修改接�-管���.md
@@ -0,0 +1,78 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5846"
+title: "�房候选「定制师推��拆分为主选/副选：新增 consultantChoiceRank + consultantChoiceLabel"
+consumer: "admin"
+change_type: "修改接�"
+author: "wx(GIT)"
+backend_status: "deployed"
+gateway_status: "not_required"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+target_release: ""
+verified_at: "2026-08-11"
+status_note: ""
+updated_at: "2026-08-11"
+base: "dev-v3"
+---
+
+# �房候选：「定制师推��拆分为主选 / 副选（#5846）
+
+> **�务**: hl-order-service-v3
+> **PR**: #5863（已�并 dev-v3 并部署测试�）
+> **日期**: 2026-08-11
+> **背景**: 房务「�置酒店�弹窗里，定制师点�的酒店统一显示「定制师推��，分�出优先级。wx 转述�莱�径：**「一个主选，其他都是副选�**——定制师需求里排第一�的候选是主选，其余全部副选。
+
+---
+
+## �更接�
+
+`GET /v3/admin/hotel-candidates` —— 候选项**新增 2 个字段**：
+
+| 字段 | 类型 | �值 | 说明 |
+|---|---|---|---|
+| `consultantChoiceRank` | `Integer` | `1` / `2` / `null` | 1=主选，2=副选，null=�定制师点�候选 |
+| `consultantChoiceLabel` | `String` | `定制师主选` / `定制师副选` / `null` | �直接渲染的中文标签 |
+
+**既有字段 `isConsultantRecommended` / `recommended` / `recommendSource` 行为完全��**（兼容期�留，�端切�完���议下线）。
+
+### 排���
+
+**主选一定排在副选之�**。�端在排���了专门的收��排，确�标识与顺��会自相矛盾（�会出现「副选排在主选上��）。普通候选的相对�置��影�。
+
+### 判定规则（�端已实现，�端直接用��）
+
+- 主选 = 定制师需求 `days[].segments[].candidates[]` 里**�段的第一个候选**
+- 一晚有多段（�晚�多家）时，**�段�有一个主选**；候选列表是按天�平返回的，�一酒店若既是 A 段主选�是 B 段副选，按**最高优先级**标为主选
+- 查询�数 `preferredHotelId` **�影�**主/副判定（它��与置顶展示），所以房务带���数进�看到的主选�会�
+- 定制师��房数没选酒店的候选（无 `hotelId`）��与标记，两个字段为 `null`
+
+---
+
+## �端��
+
+把候选行的「定制师推��标签改为按 `consultantChoiceLabel` 渲染：
+
+| `consultantChoiceRank` | 标签 | 建议样� |
+|---|---|---|
+| `1` | 定制师主选 | 强调色（比现「定制师推��更醒目） |
+| `2` | 定制师副选 | 次级色 |
+| `null` | �显示标签 | — |
+
+直接用 `consultantChoiceLabel` 的文案��，�需�自己根� rank 拼中文。弹窗顶部「定制师指定酒店已置顶，��选择其他酒店�的�示语由�端维护，�端未改。
+
+---
+
+## 验���
+
+2026-08-11 测试�（网关 `https://api.test.1814.love:9443`，房务管�员 token），订� 26-7666：
+
+| 天 | 需求 days 里的候选顺� | 候选查询实测 |
+|---|---|---|
+| day1 | 阿尔山�悦 → 阿尔善国际维景 | `[0]` 阿尔山�悦 `rank=1 定制师主选`�`[1]` 阿尔善国际维景 `rank=2 定制师副选` |
+| day2 | �尔�纳豪星 → �尔�纳白桦 | `[0]` �尔�纳豪星 `rank=1 定制师主选`�`[1]` �尔�纳白桦 `rank=2 定制师副选` |
+
+主选�在副选之�，其余 19 家候选 `rank=null` 未误标；标识顺�与定制师�交顺�完全一致。
+
+�测：核心 95 全绿（�新增 `HotelCandidateConsultantChoiceTest` 9 例�`CandidateConsultantChoiceRankTest`），���异验�通过。全� 6515 tests / Failures 0；5 个 Errors 全在 `AdjustmentRecordMapperIT`（Testcontainers 集�测试，与本改动零调用关系），**�跑 5/5 绿**，系本机并行构建的容器资�竞争。