hl-api-changelog/changelogs-v2/2026-06/24_4336_释放后整段对话进留言池+抢单前展示完整留言_管理后台.md
API Changelog Bot e6febaa22b @
docs(changelog-v2): 释放后整段对话进留言池+抢单前展示完整留言 (#4336)
@
2026-06-24 14:33:28 +08:00

2.3 KiB

房务释放回池:整段对话进「留言池」+ 抢单前展示完整留言(前端需展示)

变更类型:🔧 修复(后端,前端需配合:抢单池/未抢单详情展示留言 端类型:管理后台(房务管家·抢单池/订单详情·内部留言/聊天) 日期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→房务详情 messages17 条完整对话(含旧房务 [HOUSE] 角色发的「客人难搞/酒店满房/我先释放了」),抢单前可见完整上下文。