From bfd54e4617e511b42b219b96ec499c678eeb3a56 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 27 Jul 2026 10:19:25 +0800 Subject: [PATCH] =?UTF-8?q?docs(fleet):=20=E8=A1=A5=E5=85=85=E7=9F=A9?= =?UTF-8?q?=E9=98=B5=E5=B8=B8=E9=A9=BB=E5=8F=B8=E6=9C=BA=E5=B1=95=E7=A4=BA?= =?UTF-8?q?=E5=91=8A=E7=9F=A5=20(#4760)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原因：矩阵 grid 已返回常驻司机字段，但前端只反查未加载的司机列表，导致全部车辆显示为待派司机。 内容：补充运行态与源码证据、权威字段消费口径、主窗/分窗一致性及前端验收清单；明确无需后端改动或前端工单。 验证：npm test 46 项通过，check:path-aliases 通过，git diff --check 通过。 --- ...务矩阵对账模板真实接口对接告知-管理后台.md | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) 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` 的车辆仍显示“待派司机”。 +- [ ] 车辆分窗与主矩阵展示一致。 +- [ ] 车队、车型、状态筛选及派车占用条不受本次展示修复影响。