From 24fd4d7e3bdf68ca681629bdb6d547cf02b6c96d Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sat, 27 Jun 2026 14:21:13 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E7=BB=84=E9=95=BF=E5=8F=AA=E8=AF=BB=E7=9B=91=E7=9D=A3=E8=A7=92?=
 =?UTF-8?q?=E8=89=B2+=E7=BB=84=E9=95=BF=E6=88=BF=E5=8A=A1=E8=AE=A2?=
 =?UTF-8?q?=E5=8D=95=E8=81=8A=E5=A4=A9(#4493=20PR#4494)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¯»ç›‘ç�£è§’色+组长房务订å�•è�Šå¤©-新增接å�£-管ç�†å�Žå�°.md | 67 +++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 changelogs-v2/2026-06/30_4493_房务组长�读监�角色+组长房务订��天-新增接�-管���.md

diff --git a/changelogs-v2/2026-06/30_4493_房务组长�读监�角色+组长房务订��天-新增接�-管���.md b/changelogs-v2/2026-06/30_4493_房务组长�读监�角色+组长房务订��天-新增接�-管���.md
new file mode 100644
index 0000000..1e983bc
--- /dev/null
+++ b/changelogs-v2/2026-06/30_4493_房务组长�读监�角色+组长房务订��天-新增接�-管���.md
@@ -0,0 +1,67 @@
+# 新增「房务组长��读监�角色 + 组长↔房务基于订�的�天
+
+> �更类型：✨ 新增角色 + 新增接�（房务管家·监�视图/�天）
+> 端类型：管���（房务管家）
+> 日期：2026-06-27 ｜ 工�：#4493 ｜ PR：#4494 ｜ �务：hl-order-service-v3 + hl-user-service（��务已部署测试�，house_keeper_lead 账� API 实测通过）
+
+---
+
+## 一�新增角色：房务组长（house_keeper_lead）
+
+新增 sys_role `role_key=house_keeper_lead`（房务组长）。**�读监�角色**：
+- 看**全部房务**抢到的订� + 全部房务待办（标明属哪个房务）。
+- **��任何写�作**�**�能抢�**。
+- �基于订�与对应房务在线�天。
+
+由超管在「管�员管��给账�指派该角色。登录� JWT `role=house_keeper_lead`。
+
+---
+
+## 二�新增：组长监�全部已抢订�
+
+`GET /v3/admin/order/grab-pool/all-claims/hotel`（入��「我的接��`HouseMyOrderPageReqVO`：page/pageSize/houseStatus 等）
+- **��**：仅 `house_keeper_lead` / `SUPER_ADMIN` �调；普通房务调用返 `808091`（无�）。
+- **出�**：�「我的接��`HouseMyOrderPageRespVO`（`total` + `stats` 全局计数 + `list[]`），**列表项新增 2 字段**：
+  - `claimerId`（String，雪花）—— 该�所属房务 ID，**�端开「组长↔房务�会�时作 peerAdminId 传入**。
+  - `claimerName`（String）—— 该�所属房务姓�，用于「属哪个房务�展示。
+
+> 「我的接��`GET .../my-claims/hotel`（房务看自己的）��。
+
+---
+
+## 三�组长待办（�用现有端点）
+
+`GET /v3/admin/order/todos?scope=all`：组长传 `scope=all` �看全部房务待办；待办项 `ownerUserId` / `ownerName` 标明归属房务。**无需新接��无字段�更**。
+
+---
+
+## 四�组长写�作一律被拒（�读�律）
+
+组长调用任何房务写端点（抢� claim / �房�存 / �日确认 / 整体确认 / release / transfer / close / reopen / 删�房 / 改价 / 验房日志 / 水�回执 等）一律返：
+- `code: 808091`「房务组长为�读监�角色，无�执行该�作�。
+
+�端：组长视图��所有�作按钮（抢�/�房/确认/释放/转�等），仅�留查看 + �天入�。
+
+---
+
+## 五�新增：组长↔房务基于订�的�天（方案 A 独立会�）
+
+`POST /admin/message/chat/open-house-lead`
+- Body：`{ "orderId": Long, "peerAdminId": Long }` —— `peerAdminId` = 该订�房务（claimer），**�端从 all-claims 列表的 `claimerId` �**。两者�必填。
+- 行为：幂等找回/新建会�，键 = **`HOUSE_LEAD:{orderId}`**（与定制师↔房务的 `HOUSE:{orderId}` **独立隔离**，互�污染）。转��房务�更，�调自动对�对端。
+- 出�：`ChatOpenRespVO`（`conversationKey=HOUSE_LEAD:{orderId}` + `isNew` + 对端/未读信�）。
+- **�续�消�/拉线程/标已读/会�列表/未读总数全部�用现有端点**（按 `conversationKey` 工作）：
+  - �消� `POST /admin/message/chat/{conversationKey}/messages`
+  - 拉线程 `GET /admin/message/chat/{conversationKey}/messages`
+  - 标已读 `POST /admin/message/chat/{conversationKey}/read`
+- 房务侧：该会�出现在房务现有�天 Tab（对端角色 `HOUSE_LEAD`「房务组长�），�正常读�与回�。`senderRole` 自动正确（组长�=HOUSE_LEAD，房务回=HOUSE）。
+
+�端需：�天角色徽章新增 `HOUSE_LEAD`「房务组长�；组长在订�行点「�系房务�走 `/open-house-lead`（传 orderId + claimerId）。
+
+---
+
+## 六�测试�实测（house_keeper_lead 账�）
+
+组长看 all-claims（带 claimerId/claimerName）✓；纯房务调 all-claims 拒 808091 ✓；组长抢�/�房/release/reopen 全拒 808091 ✓，普通房务写�被误拦 ✓；组长 open-house-lead→`HOUSE_LEAD:{orderId}`��消�→房务�员行建出 unread+1�房务�读�回��与 `HOUSE:{orderId}` 隔离 ✓。
+
+> �端已完�并实测，�端按本�接入。`808091` 文案在「普通房务调 all-claims 被拒�场景略�（�用了组长�读文案），�影�行为，�续�微调。