diff --git a/changelogs-v2/2026-07/27_4760_hl-ui-v2.1车务矩阵对账模板真实接口对接告知-管理后台.md b/changelogs-v2/2026-07/27_4760_hl-ui-v2.1车务矩阵对账模板真实接口对接告知-管理后台.md index 7aca791..5c4c0ff 100644 --- a/changelogs-v2/2026-07/27_4760_hl-ui-v2.1车务矩阵对账模板真实接口对接告知-管理后台.md +++ b/changelogs-v2/2026-07/27_4760_hl-ui-v2.1车务矩阵对账模板真实接口对接告知-管理后台.md @@ -395,3 +395,33 @@ GET /admin/fleet/message-templates - 车队对账页 Network 必须看到 `/admin/fleet/reconciliation/cars` 和 `/insurance`,默认周期是当前月 `2026-07-01 ~ 2026-07-31`。 - 车管模板页 Network 必须看到 `/admin/fleet/message-templates`。 - 车务菜单测试账号必须是车务角色;不要用 `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` 的车辆仍显示“待派司机”。 +- [ ] 车辆分窗与主矩阵展示一致。 +- [ ] 车队、车型、状态筛选及派车占用条不受本次展示修复影响。