docs(changelog): 车务看板聊天角标实时化(#5792 后端已齐待前端接) + 订单详情用车安排按车聚合与沿用语义(前端优化×2)
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在:
父节点
c7bd95e01f
当前提交
a133aa7a50
@ -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
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户