@

docs(changelog-v2): 释放后整段对话进留言池+抢单前展示完整留言 (#4336)
@

changelogs-v2/2026-06/24_4336_释放后整段对话进留言池+抢单前展示完整留言_管理后台.md

@@ -0,0 +1,25 @@
+# 房务释放回池：整段对话进「留言池」+ 抢单前展示完整留言（前端需展示）
+
+> 变更类型：🔧 修复（后端，**前端需配合：抢单池/未抢单详情展示留言**）
+> 端类型：管理后台（房务管家·抢单池/订单详情·内部留言/聊天）
+> 日期：2026-06-24 ｜ 工单：#4335 ｜ PR：#4336 ｜ 服务：hl-user-service（双实例已部署 health UP，测试服实测 leaveMessages 返 17 条完整对话）
+
+---
+
+## 需求
+「变成留言就应该在抢单的时候看到」——房务释放回抢单池后，这单之前的对话变成留言，**下个房务在抢单池/抢单前**就应能看到完整对话（了解为什么被释放/换人/客人诉求），而不是抢单后才看到。
+
+## 后端修复（已做）
+释放回池时，把该会话**整段**聊天消息（读+未读、**含旧房务自己发出的**）整段转入「留言池」。
+- 此前只把「发给旧房务的」消息转池，旧房务**发出**的对话（如「客人难搞/酒店满房」）没进池，抢单前 `leaveMessages` 看不到。现已整段转入。
+- 抢单前查询 `leaveMessages`（房务订单详情聚合的 `messages` 字段，#4288）即返完整对话。
+- 不影响抢单后：下个房务抢单时，留言整段转为该房务的聊天，`leaveMessages` 复归空（抢单后内部留言不重复显示，#4326 行为保持）。
+
+## 前端需配合（重点）
+**抢单池 / 未抢单订单详情**，请展示该单 `leaveMessages`（完整留言对话），供房务抢单决策参考——不要只显示「抢单后可与定制师实时沟通」占位。
+- 数据源：房务订单详情接口的 `messages`（留言列表，每条含 `senderName` / `senderRole`(HOUSE=房务/CUSTOMIZER=定制师) / `content` / `sentAt`）。
+- 展示位：抢单池卡片/未抢单订单详情的「留言/沟通记录」区。空会话返空数组（无留言时可显示占位）。
+- 抢单后：转为实时聊天（现有「联系定制师」），`leaveMessages` 自然变空。
+
+## 验证说明（如实·实测）
+✅ 测试服实测：claim→旧房务发 3 条→release→房务详情 `messages` 返 **17 条完整对话**（含旧房务 [HOUSE] 角色发的「客人难搞/酒店满房/我先释放了」），抢单前可见完整上下文。