From 28deca3a56b6a12b5c5d911abe01b2b76456388f Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sat, 20 Jun 2026 12:43:23 +0800
Subject: [PATCH] =?UTF-8?q?docs(v2):=20=E6=8F=90=E6=88=BF=E9=9C=80?=
 =?UTF-8?q?=E6=B1=82=E6=AF=8F=E5=AE=B6=E9=85=92=E5=BA=97=E5=A4=87=E6=B3=A8?=
 =?UTF-8?q?+=E5=88=86=E4=BD=8F=E6=98=8E=E7=BB=86=E8=BD=AC=E5=8F=91?=
 =?UTF-8?q?=E6=88=BF=E5=8A=A1=E8=AF=A6=E6=83=85=20changelog=20(PR#4116)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...’店备注+分ä½�明细转å�‘房务详情-修改接å�£-管ç�†å�Žå�°.md | 80 +++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 changelogs-v2/2026-06/20_4116_�房需求�家酒店备注+分�明细转�房务详情-修改接�-管���.md

diff --git a/changelogs-v2/2026-06/20_4116_�房需求�家酒店备注+分�明细转�房务详情-修改接�-管���.md b/changelogs-v2/2026-06/20_4116_�房需求�家酒店备注+分�明细转�房务详情-修改接�-管���.md
new file mode 100644
index 0000000..9f7b5df
--- /dev/null
+++ b/changelogs-v2/2026-06/20_4116_�房需求�家酒店备注+分�明细转�房务详情-修改接�-管���.md
@@ -0,0 +1,80 @@
+# �房需求「�家酒店备注 + �晚备注 + 分�明细�完整转�房务详情 — 修改接� — 管���
+
+> �更类型：✨ 请求字段新增（�家酒店备注）+ �应字段新增（房务详情转�结构化数�）
+> 端类型：管���（定制师 · 调整订�/�房需求 → 房务 · 订�详情）
+> 日期：2026-06-20
+> �务：hl-order-service-v3
+> PR：https://git.1814.love:8443/wx/HL/pulls/4116
+
+---
+
+## ⚠� 关键说明（给�端）
+
+定制师「调整订� / �房需求�填的结构化数�，�在房务抢��的订�详情里**完整看到**。本次补�：�家选的酒店�写备注��晚�写备注，连��晚分�的多家酒店全部�传房务。
+
+### 1. �房需求表�（定制师端，写入）
+
+`PUT /v3/admin/order/{id}/hotel-requirement`，body 里：
+
+| 备注类型 | 字段 | 状� |
+|---|---|---|
+| **整�自定义备注** | 顶层 `remark`（≤500） | **早已存在**，�端把那个自定义备注输入框接到它��（�端无改动） |
+| **�晚备注** | `days[].remark`（≤200） | 早已存在 |
+| **�家酒店备注** | `days[].hotels[].remark`（≤200） | **本次新增**，�家选的酒店��独写备注（如「�湖一侧/��早/�加床�） |
+
+请求示例：
+
+```json
+PUT /v3/admin/order/60001/hotel-requirement
+{
+  "days": [
+    {
+      "dayNumber": 1,
+      "remark": "当晚整体安排说明",
+      "hotels": [
+        {"hotelId": 80001, "hotelName": "湖景酒店", "roomCategory": "KING", "roomCount": 2, "budget": 900.00, "remark": "�湖一侧"},
+        {"hotelId": 80002, "hotelName": "山景酒店", "roomCategory": "TWIN", "roomCount": 1, "remark": "��早（�一晚分�）"}
+      ]
+    }
+  ],
+  "specialTags": ["高楼层", "景观房"],
+  "remark": "整�自定义备注：客人怕�"
+}
+```
+
+### 2. 房务订�详情（房务端，读� → 抢��能看到全部）
+
+`GET /admin/house/orders/{orderId}` 的 `requirement.current`（� `RequirementSnapshot`）：
+
+| 字段 | 说明 | 状� |
+|---|---|---|
+| `consultantRemark` | **整�自定义备注**（= �房的顶层 `remark`） | 早已转� |
+| `specialTags` / `specialTagLabels` | 特殊诉求标签 | 早已转� |
+| `days[].remark` | **当晚备注** | **本次新增转�** |
+| `days[].hotels[]` | **当晚定制师选的全部酒店明细**（��晚分�多家，���给 1 家） | **本次新增** |
+
+`days[].hotels[]` �项（`HotelChoice`）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| hotelId | String（雪花） | 定制师指定酒店 ID |
+| hotelName | String | 酒店�快照 |
+| roomCategory | String | 房型字典 code |
+| roomCount | Integer | 房间数 |
+| budget | String/null | 预算/晚 |
+| remark | String | **�家酒店备注** |
+
+> 兼容：`days[]` 原有的�平字段（`roomCategory/roomCount/budget/preferredHotelId`，�自当晚第 1 家）**����**，��端��影�；本次�是**新增** `days[].remark` 与 `days[].hotels[]` 两项，房务详情其余结构零�化。
+
+---
+
+## 测试
+
+- `HouseDetailAggregatorTest` 21/21 绿（新增 1 例：�晚分� 2 家 + �家 hotelName/remark + 当晚 remark 完整转�，�既有�平字段防回归断言）；`RequirementServiceTest` 99/0（VO 加字段无�列化回归）。
+- 已部署测试� order-v3 �实例 success；9443 实测：房务详情端点无回归��房 VO 接�新 `days[].hotels[].remark`/`days[].remark` 字段。
+- 注：测试环境当�无�抢房务�，未在真实订�上观测到转��值；映射逻辑由�测覆盖。
+
+## 备注
+
+- 网关无需改。
+- 定制师端「自定义备注输入框�「�家酒店备注输入框�UI 由�端实现，�端字段已就�。