diff --git a/changelogs-v2/2026-06/24_4336_释放后整段对话进留言池+抢单前展示完整留言_管理后台.md b/changelogs-v2/2026-06/24_4336_释放后整段对话进留言池+抢单前展示完整留言_管理后台.md new file mode 100644 index 0000000..84139ef --- /dev/null +++ b/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] 角色发的「客人难搞/酒店满房/我先释放了」),抢单前可见完整上下文。