docs(fleet): 接续通知changelog补render-batch真实请求响应+日期分段后端问题指引
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
这个提交包含在:
父节点
5293bb84cf
当前提交
a09466557f
@ -44,23 +44,29 @@ POST https://api.test.1814.love:9443/admin/fleet/message-templates/{templateId}/
|
|||||||
|
|
||||||
接口注释原文:**"多槽位/多司机预览按槽位逐项渲染同一模板,返回与请求 items 同序的结果列表;前端预览区按司机分 tab,发送时按选中司机取对应 renderedBody。"**
|
接口注释原文:**"多槽位/多司机预览按槽位逐项渲染同一模板,返回与请求 items 同序的结果列表;前端预览区按司机分 tab,发送时按选中司机取对应 renderedBody。"**
|
||||||
|
|
||||||
请求体:
|
请求体(**真实调用**,订单 26-6436 orderId=2086270156475936769,模板 id=2073978002412105729「排车待确认-标准」):
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"items": [
|
"items": [
|
||||||
{"orderId":"2086270156475936769","vehicleId":"<E2E01车id>","driverId":"<道尔吉id>","assignmentGroupId":"...","serviceDates":["2026-08-23"]},
|
{"orderId":"2086270156475936769","vehicleId":"2085284111341023234","driverId":"2065272150012444674","serviceDates":["2026-08-23"]},
|
||||||
{"orderId":"2086270156475936769","vehicleId":"<E2E99车id>","driverId":"<王信id>","assignmentGroupId":"...","serviceDates":["2026-08-24","2026-08-25"]}
|
{"orderId":"2086270156475936769","vehicleId":"2085539421276286978","driverId":"2067084362829979650","serviceDates":["2026-08-24","2026-08-25"]}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
- `items[]` 每项 = 一个司机/接续段的预览入参(orderId/vehicleId/driverId/assignmentGroupId/serviceDates 等,同单渲染),1~20 项;1 项时等价单渲染(无 tab)。
|
- `items[]` 每项 = 一个司机/接续段的预览入参(orderId/vehicleId/driverId/assignmentGroupId/serviceDates 等,同单渲染),1~20 项;1 项时等价单渲染(无 tab)。
|
||||||
|
- vehicleId:蒙A-E2E01=2085284111341023234 / 蒙A-E2E99=2085539421276286978;driverId:道尔吉=2065272150012444674 / 王信=2067084362829979650。
|
||||||
|
|
||||||
响应:
|
响应(**真实返回**,code=200):
|
||||||
```json
|
```json
|
||||||
{"code":200,"data":{"items":[{"success":true,"renderedBody":"道尔吉,您好...8/23..."},{"success":true,"renderedBody":"王信,您好...8/24-25..."}]}}
|
{"code":200,"message":"成功","data":{"items":[
|
||||||
|
{"success":true,"renderedBody":"呼伦旅行—订车单\n...\n道尔吉,您好,请确认以下订车信息:\n团号:26-6436\n日期:2026-08-23 至 2026-08-25\n人数:2人(成人2)\n车辆:蒙A-E2E01 丰田普拉多(7座)\n..."},
|
||||||
|
{"success":true,"renderedBody":"呼伦旅行—订车单\n...\n王信,您好,请确认以下订车信息:\n团号:26-6436\n日期:2026-08-23 至 2026-08-25\n人数:2人(成人2)\n车辆:蒙A-E2E99 丰田普拉多(7座)\n...行程详情:https://web.test.1814.love:9443/s/tlMa2xQ..."}
|
||||||
|
]}}
|
||||||
```
|
```
|
||||||
- `items[]` 与请求同序,每项独立 success + renderedBody;单项失败不阻断其他项。
|
- `items[]` 与请求同序,每项独立 success + renderedBody;单项失败不阻断其他项。
|
||||||
|
|
||||||
|
**⚠️ 实测发现的后端问题(另见后端工单)**:两个司机渲染的「日期」都是「2026-08-23 至 2026-08-25」(订单全程),**没按各自 serviceDates 分段**——道尔吉只负责 8/23(serviceDates=[8/23])却显示全程,王信负责 8/24-25 也显示全程。司机会搞不清自己负责哪几天。需后端 render-batch 渲染的日期按 serviceDates 分段。
|
||||||
|
|
||||||
**前端现状**:`src/api/fleet/message-template.js` **只封装了单渲染 `POST /render`,没有 render-batch**;待确认页预览仍调单渲染,只渲染第一个司机。
|
**前端现状**:`src/api/fleet/message-template.js` **只封装了单渲染 `POST /render`,没有 render-batch**;待确认页预览仍调单渲染,只渲染第一个司机。
|
||||||
|
|
||||||
**前端要改**:
|
**前端要改**:
|
||||||
|
|||||||
正在加载...
x
在新工单中引用
屏蔽一个用户