From 70f9e64dcbe66af842695607223324c61ce562b2 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 22 Jun 2026 14:56:03 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#4220=20=E9=85=8D=E6=88=BF?=
 =?UTF-8?q?=E9=9C=80=E6=B1=82=E5=9B=9E=E6=98=BE=E4=BF=AE=E5=A4=8D=20?=
 =?UTF-8?q?=E2=80=94=20=E6=AE=B5=C3=97=E5=80=99=E9=80=89=E7=BB=93=E6=9E=84?=
 =?UTF-8?q?+=E6=99=9A=E6=95=B0dayNumber+=E5=80=99=E9=80=89=E2=89=A0?=
 =?UTF-8?q?=E5=88=86=E4=BD=8F(=E5=90=8E=E7=AB=AF=E5=B7=B2=E4=BF=AE+?=
 =?UTF-8?q?=E5=89=8D=E7=AB=AF=E5=BE=85=E6=94=B9)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¤�_段×候选结构+晚数+候选vs分ä½�_管ç�†å�Žå�°+å‰�端BUG.md | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 changelogs-v2/2026-06/22_4220_�房需求回显修�_段×候选结构+晚数+候选vs分�_管���+�端BUG.md

diff --git a/changelogs-v2/2026-06/22_4220_�房需求回显修�_段×候选结构+晚数+候选vs分�_管���+�端BUG.md b/changelogs-v2/2026-06/22_4220_�房需求回显修�_段×候选结构+晚数+候选vs分�_管���+�端BUG.md
new file mode 100644
index 0000000..c2f86c3
--- /dev/null
+++ b/changelogs-v2/2026-06/22_4220_�房需求回显修�_段×候选结构+晚数+候选vs分�_管���+�端BUG.md
@@ -0,0 +1,54 @@
+# ��端已修 + �端待改·管���】�房需求回显修�：段×候选结构 + 晚数 + 候选≠分� (#4220)
+
+> **�端 PR**: #4220（已� dev-v3 + 已部署测试� + API 实测通过） | **�务**: hl-order-service-v3 | **更新**: 2026-06-22
+> **�端负责人**: @mmg —— 本文��「�端待改�是回显 bug，需�端��改渲染。
+
+## 1. 背景（�端�馈的回显 bug）
+
+3 天 2 晚的订�，�房回显出现两类错误：
+- **订�详情「�宿安排�**：2 晚的行程显示�「第 1-2 晚 / 第 3-4 晚�（共 4 晚）。
+- **抢�池「�房行程�**：�一段里房控择一的 2 个候选酒店，被标�「�晚分� 1/2�2/2�。
+
+排查（直查测试库 + 调真实 API）定论：**需求数�本身正确**（2 天��天 1 段��段 2 候选）。根因有二——�端缺数� + �端渲染�径错。
+
+**核心语义（务必对�）**：一晚的用房 = `segments[]`（分�段，**多段�是�晚分�，房数相加**）；一个 segment 内 = `candidates[]`（**房控择一的候选，房数/预算��加**）。**候选 ≠ 分�**。本例�天�有 1 段�段内 2 候选 → 是「2 个候选择一�，�是「2 晚�也�是「2 个分��。
+
+## 2. �端已修（#4220，数�现已就绪）
+
+两个真实�端缺陷已修�并部署：
+
+| # | 缺陷 | 修� |
+|---|------|------|
+| A | 候选 `hotelId` �为 `null`（JSON 里 hotelId 是字符串，�端旧解��认数字跳过了）→ 点�高亮/跳转酒店失效 | 统一解� String/Number，hotelId 现正确返回 |
+| B | 订�详情 `/itinerary` 的 `requirement.days[]` �有�平 `hotels[]`�无 `hotelName`�无 `segments` → �端无法区分候选/分��无法展示完整语� | 新增 `days[].segments[]`（段×候选）+ `hotels[].hotelName`，对�房务侧 |
+
+**实测确认**（`GET /v3/admin/order/{id}/itinerary` 已返回）：
+- `days[].hotels[].hotelId` / `hotelName` � null；
+- 新增 `days[].segments[]`：�段� `roomCategory`/`roomCategoryLabel`/`roomCount`/`budget`/`remark` + `candidates[]`（`hotelId`/`hotelName`/`remark`）。
+- 房务侧 `GET /admin/house/orders/{id}` 的 `requirement.current.days[]` 本就有 `segments[]`（�结构），hotelId 现也修�。
+
+## 3. �端待改（回显修�）
+
+### 3.1 订�详情「�宿安排�（行程安排 Tab，� `/v3/admin/order/{id}/itinerary`）
+
+- **晚数标签用 `days[].dayNumber`**（第 1 晚 / 第 2 晚）。**严�把�一天的多个 `hotels[]`/候选�目当�多晚累加** —— 这正是「2 晚显示�第 1-2 / 3-4 晚�的根因（day1 的 2 个候选被当�第 1�2 晚，day2 的 2 候选被当第 3�4 晚）。
+- **改用新增的 `days[].segments[]` 渲染**：一个 segment 一行（房型 × `roomCount` 间 × `budget` 预算/晚），段内 `candidates[]` 作为「候选酒店（择一）�列表展示（带 `hotelName`）。仅当�天 `segments.length > 1` �是真·�晚分�（房数相加）。
+- **完整结构化语�**（解决「语��全�）：�晚 = 房型(`roomCategoryLabel` 优先，�级 `roomCategory`) + `roomCount` 间 + `budget` 预算/晚 + 候选酒店�（`candidates[].hotelName`）；整�级 = `specialTags`（诉求）+ `remark`（备注）。
+- 旧 `hotels[]` �平字段�端**加性�留**（�破�现有渲染），但建议�移到 `segments[]`。
+- **「已回��徽章**：仅当 `assignments[]` �空�显示。当�需求 `status=PENDING`�`assignments=[]` 时�显示「已回��属误导，应改为按实�存在性判定。
+
+### 3.2 抢�池 / 房务详情「�房行程�（� `/admin/house/orders/{id}` → `requirement.current.days[]`）
+
+- **抢�池预览（未抢�）�显示需求酒店�**，�显示行程：`dayNumber` / `stayDate` / `city` / 房型 / 间数 / 预算��（按�馈「�显示行程就行�）。
+- 若需展示候选：用 `days[].segments[].candidates[]`，标「**候选 X/N（房控择一）**�，**��标「�晚分� X/N�**。「�晚分���适用于 `segments.length > 1` 的场景（�一晚�多家�房数相加）。
+
+## 4. 影� / 兼容
+
+- �端纯加性（新增 `segments`/`hotelName`，�留 `hotels`），�破�现有�端；hotelId 由� null �为真值（修�，�破�）。
+- �端改完�回显应为：本例 = 第 1 晚（普通标间×1，¥380，候选：香格里拉/嘉世豪择一）�第 2 晚（俄�标准房×1，¥280，候选：瓦西里民宿/香格里拉择一）。
+
+## 5. 关�
+
+- **�端 PR**: [#4220](https://git.1814.love:8443/wx/HL/pulls/4220)（�端�馈驱动，无关� Issue）
+- **�端负责人**: @wx ｜ **�端**: @mmg
+- 备注：「内部留言显示定制师需求�一项涉�站内信/�天系统（当� deferred 等新原型），未纳入本次，由 wx �定。