docs(changelog): 车务看板聊天角标实时化(#5792 后端已齐待前端接) + 订单详情用车安排按车聚合与沿用语义(前端优化×2)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-10 14:57:44 +08:00
@@ -0,0 +1,49 @@
+---
+schema: "hl-changelog/v2"
+ticket: "frontend-fleet-board-chat-badge-realtime"
+title: "车务看板聊天角标不实时、需刷新才更新——后端 SSE 信令已齐（含 #5792 超管补口），前端待接"
+consumer: "admin"
+author: "wx(GIT)"
+change_type: "前端优化"
+backend_status: "deployed"
+gateway_status: "not_required"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "后端信令链路已齐：im-chat/unread-count/im-chat-read/fleet-board-changed；#5792 修复超管读不清团队红点+车务定向信令放行超管（PR 待合并部署后此条即可接）。前端需在 fleet/board 订阅信令刷新卡片角标，参照房务页既有 chatSignalBus 接法。"
+updated_at: "2026-08-10"
+base: "dev-v3"
+---
+
+# 车务看板: 聊天角标实时化与已读联动（前端接线）
+
+> **背景**: 定制师给车务发消息，派单看板卡片「定制师 王骁」入口无实时角标提醒，要手动刷新才更新；房务侧已有 SSE 实时角标实现。
+> **Issue**: #5792（后端超管读态联动部分）
+
+## 后端现状（信令已齐，无需新接口）
+
+- 定制师发消息 → user-service 经 SSE 按 `targetRoleKey=VEHICLE_MANAGER` 广播 `im-chat` 信令（含 conversationKey=FLEET:{orderId}、团队未读数）。
+- 任一车务读 → 团队共享清零，广播 `im-chat-read`（conversationUnreadCount=0）。
+- **#5792 修复（本日）**：①超管在看板读消息后团队红点真正清零 + 定制师端「已送达→已读」回执；②面向车务角色的定向信令（上述两类 + `fleet-board-changed`）同样推给在线**超管**连接——此前超管连接收不到任何车务定向信令，即使前端接了订阅，超管身份打开看板也不会实时。
+- 看板列表行 `unreadMessageCount` 口径不变（团队共享未读）。
+
+## 对前端的要求（mmg）
+
+1. `fleet/board` 页面订阅 SSE `im-chat` / `im-chat-read`（chatSignalBus 已有房务接法可参照）：
+   - `im-chat`（conversationKey 匹配 FLEET:{orderId}）→ 对应卡片角标 +1 或取信令内未读数；
+   - `im-chat-read`（conversationUnreadCount=0）→ 对应卡片角标清零（他人读了也同步归零）。
+2. 打开会话读完后本地即时清零（不等信令回环）。
+3. 验证两种身份：VEHICLE_MANAGER 与 SUPER_ADMIN 登录看板均应实时（后者依赖 #5792 部署）。
+
+## 关联 / 联系人
+
+### 链接
+
+- **Issue**: [#5792](https://git.1814.love:8443/wx/HL/issues/5792)
+
+### 联系人
+
+- **后端负责人**: @wx
+- **前端负责人**: @mmg