From a93d1f7fe6ebc262ca8c5a787f36e180c6c06339 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 21 Jul 2026 09:36:44 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E9=80=9A=E7=9F=A5=E5=89=8D=E7=AB=AF?= =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E8=BD=A6=E5=8A=A1=E7=9F=A9=E9=98=B5=E5=9B=BE?= =?UTF-8?q?=E4=BE=8B=E4=B8=8E=E7=9B=B4=E6=8E=A5=E6=B4=BE=E5=8D=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...车务矩阵图例与空闲格直接派单-前端待处理.md | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md diff --git a/changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md b/changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md new file mode 100644 index 0000000..e7b6050 --- /dev/null +++ b/changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md @@ -0,0 +1,89 @@ +# 【前端待处理·管理后台】#4933 车务矩阵图例与空闲格直接派单 + +## 目标前端 + +- 端类型：管理后台（Web） +- 目标仓库：`mmg/hl-ui` +- 仓库地址： +- 联调/验收环境： +- 小程序：无需处理，本问题仅涉及管理后台车务矩阵页面 +- H5：无需处理，本问题仅涉及管理后台车务矩阵页面 + +## 问题与结论 + +2026-07-21 在车务管理员角色访问 `/fleet/matrix` 时确认两处前端缺陷： + +1. 页面图例仍显示“绿 海拉尔接/送机、橙 外地接/送机”，把地域误当成衔接状态；这与 #4933 已确认的后端语义不一致。 +2. 点击车辆空闲格只弹出“请先从未派订单池拖拽或在订单详情发起派单”，阻断了矩阵页直接派单。矩阵页已有 `AssignModal` 和车辆预选能力，应直接进入本页派单流程。 + +本次不需要后端改接口。前端必须消费后端下发的衔接状态和样式，不能按“海拉尔/外地”自行推导。 + +## 图例适配要求 + +图例按 `connections[].status/style` 固定展示以下四种业务语义： + +| `status` | `style` | 图例文案 | 展示要求 | +| --- | --- | --- | --- | +| `SAME_CITY_OK` | `GREEN` | 同城衔接正常 | 绿色实线/标记 | +| `DIFFERENT_CITY` | `DARK_RED` | 不同城 | 深红色实线/强提醒 | +| `SAME_CITY_TOO_SHORT` | `LIGHT_RED` | 同城间隔不足 | 淡红色实线/提醒 | +| `MISSING_TIME` | `RED_DASHED` | 缺少接送信息 | 红色虚线 | + +- 删除“海拉尔接/送机”“外地接/送机”两项旧图例。 +- 图例颜色、矩阵连线/标记和悬浮详情必须使用同一份状态映射。 +- 悬浮详情优先展示后端 `label`、`reasonText`、`intervalMinutes`、`minIntervalMinutes`；不得覆盖后端文案或重新计算状态。 + +## 空闲格直接派单要求 + +用户点击车辆某日的空闲格后，应在当前矩阵页面完成派单： + +1. 打开未派订单选择层（或复用现有选择组件），只列出当前筛选范围内可派订单。 +2. 选中订单后打开现有 `AssignModal`。 +3. 自动预选被点击车辆，并将点击日期带入派单日期上下文；仍允许用户在弹窗内调整司机、车辆和合法日期范围。 +4. 按现有候选、预校验和创建派单接口完成校验与提交，不能绕过冲突、容量、常驻错配确认等后端门禁。 +5. 成功后关闭弹窗并刷新矩阵、统计和未派订单数量；失败时保留用户已填内容并展示后端错误。 +6. 当确实没有可派订单时才显示空态“暂无可派订单”，不得再提示用户去订单详情发起派单。 + +建议直接修正当前 `@idle-click="onIdleClick"` 分支：现实现只调用 `message.info`，但同页已经挂载 `AssignModal`、`activeOrder`、`preselectVehicle` 和 `assignMode`，应复用现有派单链路。 + +## 接口证据 + +矩阵响应已提供后端判定结果，核心字段位于车辆相邻订单衔接集合 `connections`： + +```json +{ + "status": "SAME_CITY_OK", + "label": "同城衔接正常", + "style": "GREEN", + "reasonCode": "SAME_CITY_INTERVAL_SUFFICIENT", + "reasonText": "同城前后订单衔接间隔满足配置阈值", + "intervalMinutes": 180, + "minIntervalMinutes": 120 +} +``` + +后端允许值： + +- `status`：`MISSING_TIME`、`DIFFERENT_CITY`、`SAME_CITY_TOO_SHORT`、`SAME_CITY_OK` +- `style`：`RED_DASHED`、`DARK_RED`、`LIGHT_RED`、`GREEN` + +派单继续复用现有车务候选、预校验和创建派单接口，不新增接口。 + +## 验收清单 + +- [ ] `/fleet/matrix` 图例只展示四种后端衔接语义，不再出现地域型图例。 +- [ ] 构造四种 `status/style` 数据，图例、矩阵标记和悬浮说明三者一致。 +- [ ] 点击任意车辆空闲格可在当前页面选择未派订单并打开派单弹窗。 +- [ ] 派单弹窗自动预选点击车辆及日期上下文。 +- [ ] 正常派单成功后矩阵、统计与未派数刷新。 +- [ ] 冲突或校验失败时展示后端错误且不产生半成品派单。 +- [ ] 无可派订单时展示空态，不再引导去订单详情。 +- [ ] 在 以车务管理员角色完成页面、Network/API 响应和截图验收。 + +## 现场证据 + +- 页面：`/fleet/matrix` +- 角色：车务管理员 +- 现象：错误地域图例；点击车辆空闲格连续出现阻断性提示 +- 现场截图：由 #4933 验收反馈于 2026-07-21 提供 +- 当前调试 Chrome 登录态已失效，自动复核跳转登录页；修复后需在上述固定验收环境重新登录并完成验收清单。