feat(fleet): 前端缺陷-车辆接续派车通知多司机分tab(接render-batch)+按日改派汇总显示接续
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
这个提交包含在:
父节点
5349d91d27
当前提交
5293bb84cf
@ -0,0 +1,85 @@
|
||||
---
|
||||
schema: "hl-changelog/v2"
|
||||
ticket: "frontend-fleet-continuity-notify-tabs"
|
||||
title: "车辆接续场景:派车通知需按司机分多 tab(接入 render-batch)+ 按日改派槽位汇总显示接续"
|
||||
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: "车辆接续(一槽多天不同车/司机)两个前端展示问题。后端能力已具备(render-batch 多司机预览 + change 的 serviceDates 按天拆接续),前端未接入:①派车通知预览仍用单渲染 render、只显示单 tab,需改调 render-batch 按司机分 tab;②按日改派顶部槽位汇总只显示第一天、未反映接续。待前端接入。"
|
||||
updated_at: "2026-08-09"
|
||||
base: "dev-v3"
|
||||
generated: "2026-08-09T11:20:00+08:00"
|
||||
---
|
||||
|
||||
# 车辆接续场景:派车通知按司机分多 tab + 按日改派槽位汇总显示接续
|
||||
|
||||
> 前端改造,**后端能力已具备、无需改后端**。待前端接入。
|
||||
|
||||
## 场景(车辆接续)
|
||||
|
||||
一个车辆槽位在多天内由**不同车辆/司机接续**服务。例:订单 26-6436(8/23~8/25 三天),按天改派后:
|
||||
- 8/23:蒙A-E2E01 道尔吉
|
||||
- 8/24~8/25:蒙A-E2E99 王信
|
||||
|
||||
即同一槽位 8/23 是道尔吉、8/24-25 是王信——**一个槽位对应多个司机/多辆车(接续)**。
|
||||
|
||||
## 问题 1:派车通知只显示单 tab,接续的其他司机没通知预览
|
||||
|
||||
**现象**:待确认页「司机待确认通知」微信消息预览**只有一个 tab(道尔吉)**,接续的王信(8/24-25)没有 tab、看不到也给不了他的派车通知。
|
||||
|
||||
**期望**:派车通知预览**按司机分多个 tab,一个 tab 一个司机**,每个 tab 显示该司机所负责天数/车辆的派车通知;发送时按选中司机取对应的 renderedBody。
|
||||
|
||||
**后端已支持——直接用 `render-batch` 批量渲染接口**:
|
||||
|
||||
```
|
||||
POST https://api.test.1814.love:9443/admin/fleet/message-templates/{templateId}/render-batch
|
||||
```
|
||||
|
||||
接口注释原文:**"多槽位/多司机预览按槽位逐项渲染同一模板,返回与请求 items 同序的结果列表;前端预览区按司机分 tab,发送时按选中司机取对应 renderedBody。"**
|
||||
|
||||
请求体:
|
||||
```json
|
||||
{
|
||||
"items": [
|
||||
{"orderId":"2086270156475936769","vehicleId":"<E2E01车id>","driverId":"<道尔吉id>","assignmentGroupId":"...","serviceDates":["2026-08-23"]},
|
||||
{"orderId":"2086270156475936769","vehicleId":"<E2E99车id>","driverId":"<王信id>","assignmentGroupId":"...","serviceDates":["2026-08-24","2026-08-25"]}
|
||||
]
|
||||
}
|
||||
```
|
||||
- `items[]` 每项 = 一个司机/接续段的预览入参(orderId/vehicleId/driverId/assignmentGroupId/serviceDates 等,同单渲染),1~20 项;1 项时等价单渲染(无 tab)。
|
||||
|
||||
响应:
|
||||
```json
|
||||
{"code":200,"data":{"items":[{"success":true,"renderedBody":"道尔吉,您好...8/23..."},{"success":true,"renderedBody":"王信,您好...8/24-25..."}]}}
|
||||
```
|
||||
- `items[]` 与请求同序,每项独立 success + renderedBody;单项失败不阻断其他项。
|
||||
|
||||
**前端现状**:`src/api/fleet/message-template.js` **只封装了单渲染 `POST /render`,没有 render-batch**;待确认页预览仍调单渲染,只渲染第一个司机。
|
||||
|
||||
**前端要改**:
|
||||
1. `message-template.js` 增加 `renderBatch(templateId, items)` 封装(POST `/fleet/message-templates/{templateId}/render-batch`)。
|
||||
2. 待确认页派车通知预览:从 `board/orders/{orderId}` 的 `dailyVehiclePlan` 按 `assignmentId`/司机分组得到各接续段(每段的 vehicleId/driverId/serviceDates),调 render-batch 传入多 item;预览区按司机分 tab 展示各 item 的 renderedBody;发送时按选中司机取对应 renderedBody。
|
||||
|
||||
## 问题 2:按日改派顶部槽位汇总只显示第一天,未反映接续
|
||||
|
||||
**现象**:按日改派表格里每天已正确显示各车各司机(8/23 道尔吉、8/24-25 王信),但**顶部槽位表格「当前车辆/当前司机」只显示第一天的**(蒙A-E2E01 道尔吉),看不出这是接续单。
|
||||
|
||||
**期望**:接续槽位的顶部「当前车辆/当前司机」汇总应体现接续(如显示「多车接续」/分段列出各段车与司机,或标注「接续:道尔吉(8/23)+王信(8/24-25)」),让车务一眼看出该槽位是多车多司机接续。
|
||||
|
||||
**数据源**:`board/orders/{orderId}` 的 `dailyVehiclePlan`(按 serviceDate 各天 vehiclePlate/driverName/assignmentId)——前端按 assignmentId 分组即可识别接续并分段展示。
|
||||
|
||||
## 复现路径
|
||||
|
||||
派单看板 → 已派车订单(如 26-6436)→ 改派 → 下一步 → 按天改派 → 选中 8/23 改派给另一车/司机(形成接续)→ 待确认页看派车通知预览(只有单 tab);排车页看顶部槽位汇总(只显示第一天)。
|
||||
|
||||
## 备注
|
||||
|
||||
- 后端 `change` 接口的 `serviceDates`(按天改派限定日期集,其余天保留)已支持拆接续;`render-batch` 已支持多司机预览。**后端两处均无需改**。
|
||||
- 关联:改派回显缺陷(08_frontend_改派选完车司机槽位列不回显)——都是接续/改派场景的前端展示问题,可一并处理。
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户