hl-api-changelog/changelogs-v2/2026-08/10_frontend_车务看板聊天角标实时化与已读联动-前端优化-管理后台.md

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base
hl-changelog/v2	frontend-fleet-board-chat-badge-realtime	车务看板聊天角标不实时、需刷新才更新——后端 SSE 信令已齐（含 #5792 超管补口），前端待接	admin	wx(GIT)	前端优化	deployed	not_required	pending	mmg				后端信令链路已齐：im-chat/unread-count/im-chat-read/fleet-board-changed；#5792 修复超管读不清团队红点+车务定向信令放行超管（PR 待合并部署后此条即可接）。前端需在 fleet/board 订阅信令刷新卡片角标，参照房务页既有 chatSignalBus 接法。	2026-08-10	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

联系人

• 后端负责人: @wx
• 前端负责人: @mmg