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` 的车辆仍显示“待派司机”。
+- [ ] 车辆分窗与主矩阵展示一致。
+- [ ] 车队、车型、状态筛选及派车占用条不受本次展示修复影响。