车务订单聊天(定制师 ↔ 车务团队,基于订单)——新增 open-fleet 接口 + 车管控制台接入

模块：管理后台 · 车管控制台 · 订单聊天类型：后端新增(已合并 dev-v3 + 部署测试服 + API 实测) + 前端接入日期：2026-07-01 · 关联 PR #4690(聊天本体)+ #4698(看板列表红点+数字 orderId) / 工单 #4689 + #4695 说明：车务聊天是房务订单聊天的团队化镜像——会话键 FLEET:{orderId},与房务 HOUSE:{orderId} 同构,大部分聊天接口复用。

模型

会话键 FLEET:{orderId}(一个订单一个车务会话)。
两端：该订单定制师 ↔ 车务团队(多车务、无抢单、任一车务可参与任一订单);双向发起。
未读=团队共享:定制师发消息→全体车务在该单亮红点;任一车务读→红点对全体车务清零;车务之间的回复不计入红点(只数定制师发的)。

【前端 · 车管控制台】

1. 打开车务订单会话(核心新接口)

POST /admin/message/chat/open-fleet body:{"orderId": 2071784830965620737}(必填;可选 peer) 返回 ChatOpenFullRespVO(与房务 open-house 同结构):conversationKey(=FLEET:{orderId})、isNew、peerName/peerRole、order(订单卡:orderNo/customerName/productName/…)、thread(首屏消息,最新一页)、unreadCount/unreadTotal;打开即标记已读。

车务点「联系定制师」→ 用它开会话(peer 自动=该单定制师)。
定制师点「联系车务」→ 也用它(peer=车务团队)。

2. 复用的通用聊天接口(与房务同,FLEET 会话直接用)

发消息:POST /admin/message/chat/{conversationKey}/messages body {"content":"..."}
拉历史(上滑分页):GET /admin/message/chat/{conversationKey}/messages?pageSize=20&beforeId=...
标记已读:POST /admin/message/chat/{conversationKey}/read(open-fleet 已自动标已读,一般无需单独调)
会话列表(定制师侧看到 FLEET 会话):GET /admin/message/chat/conversations
conversationKey 即 FLEET:{orderId},路径里带冒号原样传(已实测可用)。

3. 消息角色徽章

车务回复:senderRole=FLEET。
定制师广播:senderRole=null(团队会话无单一收件人的历史设计)。前端在 FLEET 会话内按「非 FLEET 即定制师」渲染徽章(有 senderName 可显示姓名)。

【订单列表红点——已落地(PR #4698 / 工单 #4695)】

车管控制台订单列表 = 派单看板列表 GET /admin/fleet/board/orders(原型「联系定制师+红点」按钮挂在从该列表打开的派车弹窗,按 order.id 取未读)。已照房务 grab-pool 既定模式在该端点服务端注入,前端直接读每行字段,无需自己调 internal 接口:

派单看板列表行 `BoardOrderRecordVO` 新增 2 字段

orderId(String·数字雪花):该单数字订单 id。⚠️ 原有 id 是展示号(如 HL20260627115248778),不能当会话键;前端开车务会话 open-fleet(会话键 FLEET:{orderId})、行内红点都用这个 orderId。
unreadMessageCount(Integer):本单车务团队共享未读数(定制师发未读→全体车务该行亮红点;任一车务读→全体清零;车务之间回复不计)。默认 0;user-service 不可达时软降级为 0,不影响列表。

前端车管控制台订单列表/派车弹窗直接:行 unreadMessageCount>0 显红点(>9 显 9+)、点「联系定制师」用行 orderId 调 open-fleet。矩阵/其它订单视图如需同款红点,拿到 orderId 后走同一 open-fleet/未读机制即可(看板列表是主入口,已透出)。

已验证

open-fleet 实测:200 + 订单卡(HL20260630103610215·吕思远·游牧的森林-短途版)+ 会话三行(车务→定制师 / 定制师→团队 / admin_id=0 团队共享水位行)。
车务发消息→定制师收到(unread+1);车务读→团队共享水位推进(任一车务读全体清零)。
单测 user-service 3099 绿(房务基线零回归)。
看板列表红点(PR #4698)实测:/admin/fleet/board/orders 74 单每行含 orderId(真数字雪花)+ unreadMessageCount;定制师向某单广播一条→重查该行 unreadMessageCount=1(团队未读联动看板);user-service 软降级路径不阻断列表。fleet-service 全量 1307 测试绿、ArchTest 11/11。

4.3 KiB 原始文件 Blame 文件历史 Unescape Escape