From 7ee03a8399b11b18d101115a3601df60d267dc8e Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sun, 28 Jun 2026 10:09:59 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E6=88=BF=E5=8A=A1E2E?=
 =?UTF-8?q?=E6=8F=AA=E5=87=BA3=20bug=E4=BF=AE=E5=A4=8D=E5=AF=B9=E6=8E=A5(#?=
 =?UTF-8?q?4491=E6=94=B9=E5=A4=A9=E6=95=B0=E7=BA=A7=E8=81=94/#4492?=
 =?UTF-8?q?=E5=8F=8D=E5=BA=8F=E8=81=8A=E5=A4=A9/#4529=E5=88=87=E8=A7=92?=
 =?UTF-8?q?=E8=89=B2token)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 ...�天级��置酒店�房还原库存_�端对接-管���.md | 31 +++++++++++++++++++
 ...¢å�•å�Žå®šåˆ¶å¸ˆå¼€è�Šå¤©ä¼šè¯�ä¸�通已修_知悉-管ç�†å�Žå�°.md | 24 ++++++++++++++
 ...§’色与刷新token原å­�ä¿�å­˜_å‰�端必改-管ç�†å�Žå�°.md | 26 ++++++++++++++++
 3 files changed, 81 insertions(+)
 create mode 100644 changelogs-v2/2026-06/36_4491_改行程天数�天级��置酒店�房还原库存_�端对接-管���.md
 create mode 100644 changelogs-v2/2026-06/37_4492_房务先抢��定制师开�天会��通已修_知悉-管���.md
 create mode 100644 changelogs-v2/2026-06/38_4529_切角色与刷新token原��存_�端必改-管���.md

diff --git a/changelogs-v2/2026-06/36_4491_改行程天数�天级��置酒店�房还原库存_�端对接-管���.md b/changelogs-v2/2026-06/36_4491_改行程天数�天级��置酒店�房还原库存_�端对接-管���.md
new file mode 100644
index 0000000..14b4d55
--- /dev/null
+++ b/changelogs-v2/2026-06/36_4491_改行程天数�天级��置酒店�房还原库存_�端对接-管���.md
@@ -0,0 +1,31 @@
+# 改行程天数(�天)级��置酒店�房 + 还原库存（�端对接）
+
+> 模�：订�调整（adjustment）/ 房务�房（管���）
+> 类型：�端 bug 修�（PR #4491 已� dev-v3 + 测试�实测生效）+ **�端需��一项**
+> 日期：2026-06-28
+
+## 背景 / 修了什么
+
+定制师调整订�**�少行程天数**�，原先房务侧「超出新天数范围那几晚�的已�房 + 已扣 resource 库存**完全�被清��永久泄�**（2 天行程�挂� 3 晚酒店�房�第 3 晚库存永久�用）。
+
+现已修�（与「改出�日期��款级�）：�行程天数�交�，�端自动
+- **软删超出新范围的酒店�房行** + **还原对应 resource 库存**；
+- 把该订�的酒店需求**�版回抢�池**（回到「待�房�），房务�新认领/�房；
+- 订� room_control 回 PENDING�生�「需求�更(REQUIREMENT_ADJUSTED)�待办。
+
+测试�实测：4 天 3 晚→� 3 晚确认(扣库存)→�到 2 天 → 第 3 晚 3 行�房全软删�`stock_used` 还原�需求回「待�房�。
+
+## �端需��（1 项）
+
+**�行程天数时，请�时下��剪�的酒店需求 `hotelRequirement.days`（��留新天数范围内的晚）。**
+
+- �端库存泄�已彻底修�（超范围�房软删 + 库存还原，与�端是�下��剪无关）。
+- 但若�端�天数时**�改 itinerary���步下��剪�的 `hotelRequirement.days`**，则�版�的新「待�房�需求的 days 模���「那一晚�的天�目（�影�库存��影� active �房=0，仅房务�新�房时会多看到一晚空档）。�端�步�剪�完全对�。
+
+�：请确认�端「改行程天数�入�对 CORE（短途/定制）产�是�开放；本修�对任何�天数路径都生效。
+
+## 影�接�
+- `POST /v3/admin/order/{orderId}/adjustment/submit`（itinerary �天数分支，行为增强，入�结构��）
+- 房务侧详情/日历/待办�之�映（需求回待�房�库存释放�REQUIREMENT_ADJUSTED 待办）
+
+�端无需�端改���泄�库存；�端��下��剪 days �让��体验完全一致。
diff --git a/changelogs-v2/2026-06/37_4492_房务先抢��定制师开�天会��通已修_知悉-管���.md b/changelogs-v2/2026-06/37_4492_房务先抢��定制师开�天会��通已修_知悉-管���.md
new file mode 100644
index 0000000..59c0327
--- /dev/null
+++ b/changelogs-v2/2026-06/37_4492_房务先抢��定制师开�天会��通已修_知悉-管���.md
@@ -0,0 +1,24 @@
+# 房务先抢��定制师�开�天「会��通�已修（�端知悉，无需改动）
+
+> 模�：站内信�天（房务订�会�）/ 管���
+> 类型：�端 bug 修�（PR #4492 已� dev-v3 + 测试�实测生效）—— **�端无需改动，�明修�**
+> 日期：2026-06-28
+
+## 背景 / 修了什么
+
+房务订�会�此�有个**��断链**（最常�的生产顺�中招）：
+
+- �A（原本 OK）：定制师**先**开�天（抢��）→ 房务**�**抢� → 抢�时补�会� → �天正常。
+- �B（原本断�最常�）：房务**先**抢� → 定制师**�**点「�系房务�开�天 → 因为定制师�知�房务是���传对端，�端�挂了个��对端（peer=0）→ **定制师�的消�房务永远收�到�房务读消�被拒（281002）�④未读消�待办永�触�**。
+
+现已修�：定制师开房务会�时，**�端自动按订��查当�接�房务**作为真实对端，建出�方真实会��员行。无论「定制师先开�还是「房务先抢�，�天都正常连通。
+
+测试�实测（�B）：房务先抢� → 定制师 open-house（�传对端）→ �端解�到房务 → �方�员行建出 → 定制师�消� → 房务 `unread_count=1` → 房务读消� 200（�� 281002）→ ④未读消�待办触�。
+
+## �端
+
+**无需改动**。`POST /admin/chat/open-house` 入�/出�结构��；�端**传�传对端 `peerAdminId` 都�**（�传/传��时由�端�查解�）。原本在「房务先抢��顺�下��通的问题现已�明修�。
+
+## 影�接�
+- `POST /admin/chat/open-house`（行为增强：peer 缺�/��时�端�查当�房务 claimer，出� `peerAdminId/peerName/peerRole` 现会带真实房务）
+- 跨�务：order-v3 `chat-summary-batch` 内部接��应补 `claimerId`（�端�感知）
diff --git a/changelogs-v2/2026-06/38_4529_切角色与刷新token原��存_�端必改-管���.md b/changelogs-v2/2026-06/38_4529_切角色与刷新token原��存_�端必改-管���.md
new file mode 100644
index 0000000..47647ae
--- /dev/null
+++ b/changelogs-v2/2026-06/38_4529_切角色与刷新token原��存_�端必改-管���.md
@@ -0,0 +1,26 @@
+# 切角色 / 刷新令牌「掉登�已修 + �端必改一项（原��存 token）
+
+> 模�：admin 鉴�（hl-user-service）/ 管���
+> 类型：�端 bug 修�（PR #4529 已� dev-v3 + 测试�实测生效）+ **�端必改一项加固**
+> 日期：2026-06-28
+
+## 背景 / 修了什么（�端）
+
+两个掉登 bug 已修：
+
+- **Bug1（切角色被登出）**：超管切到「房务�等角色�刷新页�报「刷新令牌无效或已过期�被踢回原角色。根因：切角色会轮转 refresh 令牌�使旧 refresh 立�失效，�端若没存�新 refresh 就被登出。
+  - �端修�：**切角色��轮转 refresh**（���带新角色的 access，refresh �用���有效）。�使�端�改也�会�因切角色被登出。
+- **Bug2（刷新��掉登）**：整页刷新��「刷新令牌无效或已过期�。根因：refresh 校验与续期�原�，并�刷新读到中间�。
+  - �端修�：refresh 校验+续期改为 Redis 原�执行，并�刷新��误判。
+
+测试�实测：切角色�用原 refresh 刷新 200（�掉登）；�一 refresh 并� 3 次刷新全 200；切「定制师/房务�回归全正常。
+
+## �端必改（1 项加固）
+
+**切角色 `POST /admin/auth/switch-role` 与刷新 `POST /admin/auth/refresh` 的�应里，`token`(access) 与 `refreshToken` �原�地一起�存**（两者�时�本地存储，���存其一），切角色�用�应里的新 `token` 调�续接�。
+
+- 说明：�端�次 switch-role / refresh 都��**新 access**并把旧 access 轮转出（access 白�� last-issued-wins）。所以切角色/刷新�**必须改用�应里的新 access**，旧 access 会失效（这是既有设计，�本次改动）。本次修���的是 **refresh �会因切角色失效**，刷新链路稳定。
+
+## 影�接�
+- `POST /admin/auth/switch-role`（行为：refresh ��轮转；�应结构��）
+- `POST /admin/auth/refresh`（行为：校验+续期原�化；�应结构��）