docs(changelog): 车务看板聊天角标实时化(#5792 后端已齐待前端接) + 订单详情用车安排按车聚合与沿用语义(前端优化×2)
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot 2026-08-10 14:57:44 +08:00
父节点 c7bd95e01f
当前提交 a133aa7a50
共有 2 个文件被更改,包括 98 次插入0 次删除

查看文件

@ -0,0 +1,49 @@
---
schema: "hl-changelog/v2"
ticket: "frontend-order-vehicle-arrange-display"
title: "订单详情「用车安排」展示优化:逐日行按车聚合 + 换版沿用语义标注"
consumer: "admin"
author: "wx(GIT)"
change_type: "前端优化"
backend_status: "not_required"
gateway_status: "not_required"
frontend_status: "pending"
frontend_owner: "mmg"
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "纯前端展示优化,后端字段已足够;两点DAILY_V3 逐日镜像行按(车,司机)聚合展示;#5784 换版后沿用车辆加「沿用」语义避免与「车控处理中」并显造成困惑。"
updated_at: "2026-08-10"
base: "dev-v3"
---
# 订单详情: 用车安排展示优化(按车聚合 + 沿用语义)
> wx 2026-08-10 实测反馈两处TEST 订单 26-9313
## 问题 1逐日行平铺重复截图同一辆车/司机出现 3 次 × 2 车 = 6 行)
DAILY_V3 配车快照是「逐服务日 × 车辆槽位」的明细2 车 × 3 天 = 6 行数据,**数据本身正确**),前端把 `vehicleGroup.assignments[]` 每行直接平铺渲染。
**建议**:按(车牌/司机 或 assignmentId 前缀相同的槽)聚合成一张车卡,卡内展示服务日期范围或日期 chips。后端行含 `serviceDate`(逐日镜像)或 `startDate/endDate/serviceDays`feign 聚合段),聚合信息足够,无需后端改动。
## 问题 2换版后沿用车辆缺「沿用」语义易被当成残留数据
改用车需求(如 mpv×2 → mpv×1+suv×1后,签名匹配的槽位**自动沿用**旧派车SRS §9.18 #2 拍板:派单确认后是独立资产,不误撤已通知司机的派单)。此时详情呈现为「需求摘要=车控处理中」+ 一辆「已回配」的车并列,定制师会误以为是旧数据残留wx 今日即如此反馈)。
**建议**
- 当前需求部分槽位已配、部分待配时,头部状态细化为「部分回配1/2」而非笼统「车控处理中」;
- 沿用槽位的车卡加「沿用」小徽标(新需求版本仍在处理中、但该车延续自上一版方案)。
判定数据:`vehicleGroup.requirement.status=PROCESSING/PENDING``assignments` 非空 ⇒ 即「部分回配/沿用」形态(回配完成时 status=DONE
## 关联 / 联系人
### 链接
- **相关工单**: [#5784](https://git.1814.love:8443/wx/HL/issues/5784)(换版保留/沿用规则落地)
### 联系人
- **后端负责人**: @wx
- **前端负责人**: @mmg

查看文件

@ -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