From cc06bb796aeb60a85153580d9e98d9884292f8dc Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 24 Jun 2026 11:13:59 +0800 Subject: [PATCH] =?UTF-8?q?@=20docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?= =?UTF-8?q?=E8=81=8A=E5=A4=A9=E8=A7=92=E8=89=B2=E5=BE=BD=E7=AB=A0=E4=B8=AD?= =?UTF-8?q?=E6=96=87label(#4328)+=E5=89=8D=E7=AB=AF=E5=8E=BB=E7=95=99?= =?UTF-8?q?=E8=A8=80=E6=8C=89=E9=92=AE=E5=8F=AA=E7=95=99=E8=81=8A=E5=A4=A9?= =?UTF-8?q?=20@?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...徽章中文label+前端去留言按钮只留聊天_管理后台.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 changelogs-v2/2026-06/24_4328_房务聊天角色徽章中文label+前端去留言按钮只留聊天_管理后台.md diff --git a/changelogs-v2/2026-06/24_4328_房务聊天角色徽章中文label+前端去留言按钮只留聊天_管理后台.md b/changelogs-v2/2026-06/24_4328_房务聊天角色徽章中文label+前端去留言按钮只留聊天_管理后台.md new file mode 100644 index 0000000..9cac78b --- /dev/null +++ b/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`）在前端撤掉留言展示后即闲置，**暂留兜底不删**；后续确认无调用方再弃用。