hl-api-changelog/changelogs-v2/2026-06/24_4328_房务聊天角色徽章中文label+前端去留言按钮只留聊天_管理后台.md
API Changelog Bot cc06bb796a @
docs(changelog-v2): 房务聊天角色徽章中文label(#4328)+前端去留言按钮只留聊天
@
2026-06-24 11:13:59 +08:00

2.7 KiB

房务聊天:对方角色徽章返中文 label后端已做+ 前端去掉「给定制师留言」按钮(只留聊天)

变更类型: 后端补中文 label 字段(已部署)+ 🎨 前端 UI 简化(去留言入口) 端类型:管理后台(房务管家·订单详情·聊天面板 / 会话列表 / 内部留言 Tab 日期2026-06-24 工单:#4327 PR#4328 服务hl-user-service双实例 8081/8181 已部署 health UP,实测通过


一、后端已做:对方角色徽章返中文 label前端改用即可

聊天面板/会话列表「对方角色」原只返英文码 peerRole(如 CUSTOMIZER),徽章显示成英文。现后端新增中文 label 字段

  • 受影响接口:
    • POST /admin/message/chat/openPOST /admin/message/chat/open-house(出参 ChatOpenRespVO
    • GET /admin/message/chat/conversations(出参 list 项 ChatConversationRespVO
  • 新增字段 peerRoleLabel(中文):CUSTOMIZER→定制师HOUSE→房务FLEET→车务SYSTEM→系统
    • 占位「待接单」会话 peerRole 为空时 peerRoleLabel 同为空;未知码回退原码。
  • 前端:角色徽章改用 peerRoleLabel 展示(原 peerRole 英文码保留不动,可继续做逻辑判断)。
  • 测试服实测:open-houseconversations 均返 peerRoleLabel=定制师

二、前端待办:去掉「给定制师留言」按钮,沟通只走聊天

房务管家订单详情目前有两套沟通入口——「联系定制师」(实时聊天) 和「给定制师留言」(异步留言)。实时聊天已可用,留言入口冗余,去掉,只保留聊天

  • 移除「给定制师留言」按钮(订单详情头部右上 + 「内部留言」Tab 底部各一个)。
  • 房务↔定制师沟通统一走「联系定制师」(实时聊天,对方角色徽章已中文化)。
  • 「内部留言」Tab保留上方「定制师需求」展示(晚数/酒店/诉求/备注,有用);移除下方留言输入区/留言记录区改去聊天看沟通记录。Tab 名是否保留/改名由前端定。

后端说明(前端无需关心,仅备注)

  • 留言「池」机制(抢单前定制师消息暂存 + 换房务时转发给新房务)作为聊天的底座保留,不随留言按钮移除而下线——它是聊天在「还没房务接单 / 释放回池再被抢」时的消息连续性保障,对前端透明。
  • 取留言列表的内部接口 listHouseLeaveMessages(房务详情 leaveMessages)在前端撤掉留言展示后即闲置,暂留兜底不删;后续确认无调用方再弃用。