From 6cbed28e94ee4a56ff8fd3aa10067c675217903e Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 25 Jun 2026 17:55:55 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E9=85=8D=E6=88=BF?=
 =?UTF-8?q?=E7=BB=9F=E4=B8=80=E6=8D=A2=E9=85=92=E5=BA=97=E5=86=99=E5=8F=A3?=
 =?UTF-8?q?=20+=20=E5=8E=BB=E6=8D=A2=E9=85=92=E5=BA=97=E6=8C=89=E9=92=AE?=
 =?UTF-8?q?=20+=20=E5=9B=9E=E6=98=BE=E5=B7=B2=E9=85=8D=E9=85=92=E5=BA=97?=
 =?UTF-8?q?=20(#4407)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¢é…’店写å�£-去æ�¢é…’店按钮-回显已é…�酒店-管ç�†å�Žå�°.md | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 changelogs-v2/2026-06/25_4407_�房统一�酒店写�-去�酒店按钮-回显已�酒店-管���.md

diff --git a/changelogs-v2/2026-06/25_4407_�房统一�酒店写�-去�酒店按钮-回显已�酒店-管���.md b/changelogs-v2/2026-06/25_4407_�房统一�酒店写�-去�酒店按钮-回显已�酒店-管���.md
new file mode 100644
index 0000000..4c539c0
--- /dev/null
+++ b/changelogs-v2/2026-06/25_4407_�房统一�酒店写�-去�酒店按钮-回显已�酒店-管���.md
@@ -0,0 +1,45 @@
+# �房统一�酒店写� — 去「�酒店�按钮 + 回显已�酒店 + 根治�房��超�
+
+> �更类型：♻� �构（�端，**房务管家�端需��：去�酒店按钮 + 候选回显**）
+> 端类型：管���（房务管家·�房/�酒店）
+> 日期：2026-06-25 ｜ 工�：#4401 ｜ PR：#4407（在 #4402 基础上�写）｜ �务：hl-order-service-v3（�实例已部署 health UP，**测试� API+DB 实测全通过**）
+
+---
+
+## 背景
+「�房�与「�酒店�本质�一功能（�城�日选酒店+房型）。原两个按钮/两��端路径，且�酒店候选�传 roomTypeId 导致�交报 `808403 新酒店库存扣�失败`。本�把�酒店**并入�房�存唯一写�**，去�酒店按钮，并根治「�房���天�酒店→新店�扣(超�)/旧店�释放(泄�)�潜� P0。
+
+---
+
+## �端必改（房务管家，mmg）
+
+### 1. 去掉「�酒店�按钮，改房统一走「�房�
+- **�酒店 3 个端点已删除**，�端�止调用：
+  - `GET /v3/admin/order/swap-hotel/candidates`（删）
+  - `POST /v3/admin/order/swap-hotel/preview`（删）
+  - `POST /v3/admin/order/swap-hotel/commit`（删）
+- **改房统一走�房�存**：`POST /v3/admin/order/hotel-requirements/{requirementId}/assignments`（§2.2，原�房�存接�）。给�天�交一个新的酒店/房型 item �完�「�酒店�——�端自动识别：�酒店�房型�间数=幂等�动；酒店/房型/间数�=替�（释放旧店库存+扣新店+软删旧行+�留 swap 血缘+��店通知）。**一个 item 一个 (天,酒店,房型)，�天�三元组�����交**（�端 808117 拒，请�并间数）。
+
+### 2. �房候选回显「本天当�已�酒店�（用户�求）
+`GET /v3/admin/hotel-candidates?orderId=&dayNumber=` 候选项 `candidates[]` **新增 2 字段**：
+- `isCurrentlyAssigned`（Boolean）：该候选是�=本天当�已�酒店。�端�此**高亮/默认选中**原酒店。
+- `assignedRoomTypeId`（String 雪花）：本天已�的房型 ID，供**预填原房型下拉**。
+- 已�酒店**��出现在候选结果中**（�使排���也强制�留，�被 limit 截断）。
+- 候选项本就� `tags`（��标签）�`roomTypes[]`（roomTypeId/房型/�议价/�用数）——�酒店选房直接�用�房候选这套，标签照常展示。
+
+### 3. 订�详情 currentAssignment 补 roomTypeId
+`GET /admin/house/orders/{orderId}` → `itinerary[].currentAssignment` **新增 `roomTypeId`**（String 雪花），供详情侧精确回显/预填原房型。
+
+---
+
+## �端行为（�端知悉��）
+- �房�存按天对账：�天�酒店时先释放旧酒店库存��用隔离幂等键扣新酒店（根治�天多房型/�店�用键短路�扣的超�），软删旧行�新行 `swap_from_id` 指�旧行。
+- �酒店（hotelId 真�）�� 3 �通知（旧店/新店/客户，走通知中心）+ 写 SWAP_SUCCESS 审计 + 自动归档 SWAP_HOTEL 待办。
+- 原 `808403` ���现（�房候选自带 roomTypeId）。
+
+---
+
+## 测试�实测（已通过）
+- 回显：候选 day2 正确标已�酒店 `isCurrentlyAssigned=true`+`assignedRoomTypeId`；详情 currentAssignment 返 roomTypeId。
+- �酒店：�房�存��天酒店 → 旧行软删+库存释放�新行 swap 血缘��天仅 1 active�新旧幂等键隔离真扣。
+- 多房型�天：一次�交 2 房型 → �自独立扣�（键����短路）。