@

docs(changelog-v2): 房务聊天角色徽章中文label(#4328)+前端去留言按钮只留聊天
@

changelogs-v2/2026-06/24_4328_房务聊天角色徽章中文label+前端去留言按钮只留聊天_管理后台.md

@@ -0,0 +1,31 @@
+# 房务聊天：对方角色徽章返中文 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/open`、`POST /admin/message/chat/open-house`（出参 `ChatOpenRespVO`）
+  - `GET /admin/message/chat/conversations`（出参 list 项 `ChatConversationRespVO`）
+- **新增字段 `peerRoleLabel`**（中文）：`CUSTOMIZER→定制师`、`HOUSE→房务`、`FLEET→车务`、`SYSTEM→系统`。
+  - 占位「待接单」会话 `peerRole` 为空时 `peerRoleLabel` 同为空；未知码回退原码。
+- **前端**：角色徽章改用 `peerRoleLabel` 展示（原 `peerRole` 英文码保留不动，可继续做逻辑判断）。
+- ✅ 测试服实测：`open-house` 与 `conversations` 均返 `peerRoleLabel=定制师`。
+
+---
+
+## 二、前端待办：去掉「给定制师留言」按钮，沟通只走聊天
+房务管家订单详情目前有两套沟通入口——「联系定制师」(实时聊天) 和「给定制师留言」(异步留言)。实时聊天已可用，**留言入口冗余，去掉，只保留聊天**：
+
+- **移除**「给定制师留言」按钮（订单详情头部右上 + 「内部留言」Tab 底部各一个）。
+- 房务↔定制师沟通**统一走「联系定制师」**（实时聊天，对方角色徽章已中文化）。
+- 「内部留言」Tab：**保留**上方「定制师需求」展示（晚数/酒店/诉求/备注，有用）；**移除**下方留言输入区/留言记录区（改去聊天看沟通记录）。Tab 名是否保留/改名由前端定。
+
+### 后端说明（前端无需关心，仅备注）
+- 留言「池」机制（抢单前定制师消息暂存 + 换房务时转发给新房务）**作为聊天的底座保留**，不随留言按钮移除而下线——它是聊天在「还没房务接单 / 释放回池再被抢」时的消息连续性保障，对前端透明。
+- 取留言列表的内部接口 `listHouseLeaveMessages`（房务详情 `leaveMessages`）在前端撤掉留言展示后即闲置，**暂留兜底不删**；后续确认无调用方再弃用。