From b658d8671d435a5294e26e67632fc73896d8ef1c Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 23 Jun 2026 16:39:33 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E8=AF=A6=E6=83=85=E9=80=90=E6=97=A5=E5=9F=8E=E5=B8=82=E6=94=B9?=
 =?UTF-8?q?=E5=8C=BA=E5=8E=BF+=E5=80=99=E9=80=89=E7=9C=9F=E5=AE=9E?=
 =?UTF-8?q?=E6=88=BF=E5=9E=8BroomTypeId(#4300/#4305)+=E8=81=8A=E5=A4=A9?=
 =?UTF-8?q?=E5=8F=91=E9=80=81=E4=BA=BA=E4=BC=81=E5=BE=AE=E5=90=8D(#4309)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...€�日城市改区县+候选真实房型roomTypeId_管ç�†å�Žå�°.md | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 changelogs-v2/2026-06/23_4300_4305_房务订�详情�日城市改区县+候选真实房型roomTypeId_管���.md

diff --git a/changelogs-v2/2026-06/23_4300_4305_房务订�详情�日城市改区县+候选真实房型roomTypeId_管���.md b/changelogs-v2/2026-06/23_4300_4305_房务订�详情�日城市改区县+候选真实房型roomTypeId_管���.md
new file mode 100644
index 0000000..e8d1c38
--- /dev/null
+++ b/changelogs-v2/2026-06/23_4300_4305_房务订�详情�日城市改区县+候选真实房型roomTypeId_管���.md
@@ -0,0 +1,46 @@
+# 房务订�详情：�日城市改显区县（跨区县拆分）+ �房需求候选酒店暴露真实房型 roomTypeId（已上线测试�·�对接）
+
+> �更类型：✅ 修改接�（字段语义�更 + 新增字段，已部署测试�并 API 验�，�对接）
+> 端类型：管���（房务订�详情「�房行程 / 定制师需求�DAY �片）
+> 日期：2026-06-23 ｜ 工�：#4297�#4204(P3) ｜ PR：#4300�#4305 ｜ �务：hl-order-service-v3
+> 接�：`GET /admin/house/orders/{orderId}` → `data.requirement.current.days[]`（�历�版本 `recentHistory[].snapshot.days[]`）
+
+---
+
+## 背景
+1. 之� DAY �片的「城市�显示**市级**（呼伦�尔市）。wx �求改显**区县**（海拉尔区），且**�一天多家候选酒店分属��区县时，全部拆分展示**。
+2. wx �求�房需求**按酒店分类�一个酒店一个房型**——候选酒店应�带**自己的真实房型**（#4204 epic 的房控侧读� P3）。
+
+## 1. `days[].city` 语义�更：市级 → 区县（�多值）
+`requirement.current.days[].city`（字段�**��**）�值由市级改为**区县级**，�该天**全部候选酒店**的资�区县去�：
+- �区县：`"海拉尔区"`
+- **多区县**（候选跨区县）：用顿� `�` 拼接，如 `"满洲里市�海拉尔区"`�`"�尔�纳市�满洲里市"`
+- 区县�解��到时兜底市级，**��为空**。
+
+**�端注�**：该字段现在**�能是多个区县拼接的字符串**，按整串原样展示��，**勿�设�值/勿按固定宽度截断**。无需改数�结构，仅展示语义。
+
+## 2. 候选/酒店新增真实房型字段（#4204 P3，additive）
+`days[].hotels[]`（�酒店平铺）与 `days[].segments[].candidates[]`（�段候选）�**新增 3 字段**：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `roomTypeId` | String（雪花，�空） | 该候选酒店的**真实房型 ID**（指� resource 域具体房型） |
+| `roomTypeName` | String（�空） | 该候选酒店的**真实房型�称**（如「豪�大床房�），定制师�交时所选 |
+| `protocolPrice` | 数值（�空） | 该候选的�议价快照 |
+
+**�端「按酒店分类�渲染**：以 `hotels[]` 为主体�家展示，�家显示**它自己的** `roomTypeName`（而�段级抽象 `roomCategory`）。段级 `roomCategory/roomCount/budget` ��留（兼容�分�分组用）。
+
+**数���性**：`roomTypeId/roomTypeName` 仅当定制师�交需求时**录入了�家酒店的真实房型**�有值；历�/旧�缺数�时为 `null`（�端回退展示段级 `roomCategory` ��）。
+
+## 3. 待�端��（#4204 P5，mmg）
+�让候选酒店都带上真实房型，定制师**�交�房需求的��**需改为「**先选候选酒店 → �从该酒店真实房型里选**�，把所选 `roomTypeId` �候选�交（�端写入侧 P1 已就绪）。本��端读侧（P3）已备好，该��改造完��真实房型�贯穿展示。
+
+---
+
+## 附：�天��人�（#4309，纯�端，�端无需改）
+内部留言/�天��人�解�（hl-user-service `resolveName`）改为「**绑�微 → �微�，未绑 → 用户�**�三级�径（�地已登记 P2）。`senderName` 字段**��**，为��时快照（改��影�历�），**对新�消�生效**，历�消���原快照。�端无需任何改动。
+
+## 验�（测试� order `2068234602970828802` 实测）
+- `days[0].city = "满洲里市�海拉尔区"`�`days[1].city = "�尔�纳市�满洲里市"`（多区县拆分生效）。
+- `days[].hotels[].roomTypeId/roomTypeName` 已暴露（如 `普通标间`/`俄�标准房` + 真实 roomTypeId）。
+- order-v3 全��测 + ArchTest 门�全绿；�实例滚动部署�康。