docs(fleet): 补充矩阵常驻司机展示告知 (#4760)
所有检测均成功
changelog-filename-gate / validate (pull_request) Successful in 1s
所有检测均成功
changelog-filename-gate / validate (pull_request) Successful in 1s
原因:矩阵 grid 已返回常驻司机字段,但前端只反查未加载的司机列表,导致全部车辆显示为待派司机。 内容:补充运行态与源码证据、权威字段消费口径、主窗/分窗一致性及前端验收清单;明确无需后端改动或前端工单。 验证:npm test 46 项通过,check:path-aliases 通过,git diff --check 通过。
这个提交包含在:
父节点
1cd35d4c8f
当前提交
bfd54e4617
@ -395,3 +395,33 @@ GET /admin/fleet/message-templates
|
|||||||
- 车队对账页 Network 必须看到 `/admin/fleet/reconciliation/cars` 和 `/insurance`,默认周期是当前月 `2026-07-01 ~ 2026-07-31`。
|
- 车队对账页 Network 必须看到 `/admin/fleet/reconciliation/cars` 和 `/insurance`,默认周期是当前月 `2026-07-01 ~ 2026-07-31`。
|
||||||
- 车管模板页 Network 必须看到 `/admin/fleet/message-templates`。
|
- 车管模板页 Network 必须看到 `/admin/fleet/message-templates`。
|
||||||
- 车务菜单测试账号必须是车务角色;不要用 `admin`、`adminle`、`wx`、定制师账号验证车务菜单。
|
- 车务菜单测试账号必须是车务角色;不要用 `admin`、`adminle`、`wx`、定制师账号验证车务菜单。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 2026-07-27 补充:矩阵车辆行常驻司机全部误显示“待派司机”
|
||||||
|
|
||||||
|
### 8.1 运行态与源码证据
|
||||||
|
|
||||||
|
- `/fleet/matrix` 的 19 条车辆行全部显示“待派司机”。
|
||||||
|
- 同次页面请求 `GET /admin/fleet/matrix/grid` 返回 200;响应车辆中存在非空
|
||||||
|
`primaryDriverName` 和脱敏 `primaryDriverPhone`,因此不是后端漏返回,也不是全部车辆都未绑定常驻司机。
|
||||||
|
- `useFleetMatrixData.adaptMatrixVehicle()` 已把这两个字段保留到车辆行对象。
|
||||||
|
- `VehicleGantt.primaryDriverOf(v)` 却忽略车辆行字段,只执行
|
||||||
|
`findPrimaryDriver(props.drivers, v.plate)`。
|
||||||
|
- 主矩阵和车辆分窗传入的 `drivers` 均为空列表且没有额外加载动作,所以每辆车都稳定落入
|
||||||
|
“待派司机”空态。
|
||||||
|
|
||||||
|
### 8.2 前端修复口径
|
||||||
|
|
||||||
|
1. 矩阵车辆行展示必须以 `data.vehicles[].primaryDriverName` 为权威来源;非空时直接显示该姓名。
|
||||||
|
2. `primaryDriverPhone` 已由后端脱敏,可按现有设计选择展示,但不得为显示姓名再拉全量司机列表。
|
||||||
|
3. 只有 `primaryDriverName` 为 `null` 或空白时,才显示“待派司机”空态。
|
||||||
|
4. 主矩阵和 `matrix-solo?solo=byVehicle` 必须复用同一解析逻辑,不能一处读取车辆行、一处反查本地司机数组。
|
||||||
|
5. 本问题不涉及后端接口、数据库、派单状态或候选规则变更;不要创建 `mmg/hl-ui` 配合工单,直接消费本 changelog。
|
||||||
|
|
||||||
|
### 8.3 前端验收 checklist
|
||||||
|
|
||||||
|
- [ ] 构造一辆 `primaryDriverName` 非空的车辆,主矩阵车辆行显示接口姓名而不是“待派司机”。
|
||||||
|
- [ ] `primaryDriverName=null` 的车辆仍显示“待派司机”。
|
||||||
|
- [ ] 车辆分窗与主矩阵展示一致。
|
||||||
|
- [ ] 车队、车型、状态筛选及派车占用条不受本次展示修复影响。
|
||||||
|
|||||||
正在加载...
x
在新工单中引用
屏蔽一个用户