From a133aa7a50ae0d979d685b7190868b318617fddf Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 10 Aug 2026 14:57:44 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E8=BD=A6=E5=8A=A1=E7=9C=8B?= =?UTF-8?q?=E6=9D=BF=E8=81=8A=E5=A4=A9=E8=A7=92=E6=A0=87=E5=AE=9E=E6=97=B6?= =?UTF-8?q?=E5=8C=96(#5792=20=E5=90=8E=E7=AB=AF=E5=B7=B2=E9=BD=90=E5=BE=85?= =?UTF-8?q?=E5=89=8D=E7=AB=AF=E6=8E=A5)=20+=20=E8=AE=A2=E5=8D=95=E8=AF=A6?= =?UTF-8?q?=E6=83=85=E7=94=A8=E8=BD=A6=E5=AE=89=E6=8E=92=E6=8C=89=E8=BD=A6?= =?UTF-8?q?=E8=81=9A=E5=90=88=E4=B8=8E=E6=B2=BF=E7=94=A8=E8=AF=AD=E4=B9=89?= =?UTF-8?q?(=E5=89=8D=E7=AB=AF=E4=BC=98=E5=8C=96=C3=972)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 (1M context) --- ...车安排按车聚合与沿用语义-前端优化-管理后台.md | 49 +++++++++++++++++++ ...聊天角标实时化与已读联动-前端优化-管理后台.md | 49 +++++++++++++++++++ 2 files changed, 98 insertions(+) create mode 100644 changelogs-v2/2026-08/10_frontend_订单详情用车安排按车聚合与沿用语义-前端优化-管理后台.md create mode 100644 changelogs-v2/2026-08/10_frontend_车务看板聊天角标实时化与已读联动-前端优化-管理后台.md diff --git a/changelogs-v2/2026-08/10_frontend_订单详情用车安排按车聚合与沿用语义-前端优化-管理后台.md b/changelogs-v2/2026-08/10_frontend_订单详情用车安排按车聚合与沿用语义-前端优化-管理后台.md new file mode 100644 index 0000000..58b346d --- /dev/null +++ b/changelogs-v2/2026-08/10_frontend_订单详情用车安排按车聚合与沿用语义-前端优化-管理后台.md @@ -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 diff --git a/changelogs-v2/2026-08/10_frontend_车务看板聊天角标实时化与已读联动-前端优化-管理后台.md b/changelogs-v2/2026-08/10_frontend_车务看板聊天角标实时化与已读联动-前端优化-管理后台.md new file mode 100644 index 0000000..8a1274b --- /dev/null +++ b/changelogs-v2/2026-08/10_frontend_车务看板聊天角标实时化与已读联动-前端优化-管理后台.md @@ -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