From 1076c68896e4ec3002a898bc6bf0bcc065bde398 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 21 Jul 2026 11:35:19 +0800 Subject: [PATCH] =?UTF-8?q?docs(fleet):=20=E8=A1=A5=E5=85=85=E7=9F=A9?= =?UTF-8?q?=E9=98=B5=E9=87=8D=E5=8F=A0=E5=BC=82=E5=B8=B8=E6=8E=A5=E5=8F=A3?= =?UTF-8?q?=E5=A5=91=E7=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...车务矩阵图例与空闲格直接派单-前端待处理.md | 26 ++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md b/changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md index 0d0b97e..7ba9ce4 100644 --- a/changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md +++ b/changelogs-v2/2026-07/74_4933_车务矩阵图例与空闲格直接派单-前端待处理.md @@ -18,7 +18,7 @@ 3. 订单详情“历史操作”把保险退保结果的内部 JSON 原样拼进业务时间线，业务人员无法阅读。 4. 矩阵只解释衔接标记，未解释蓝灰色派车占用条；同车出现重叠时也没有冲突语义。后端 #5109 将统一过滤取消记录，前端仍需区分普通占用与有效派车重叠异常。 -本次不需要后端改接口。前端必须消费后端下发的衔接状态和样式，不能按“海拉尔/外地”自行推导。 +后端 #5109 已统一矩阵统计与占用条口径，并新增有效派车重叠异常字段。前端必须消费后端下发的衔接状态和异常信息，不能按“海拉尔/外地”或占用条颜色自行推导。 ## 图例适配要求 @@ -83,6 +83,29 @@ - `status`：`MISSING_TIME`、`DIFFERENT_CITY`、`SAME_CITY_TOO_SHORT`、`SAME_CITY_OK` - `style`：`RED_DASHED`、`DARK_RED`、`LIGHT_RED`、`GREEN` +每辆车新增 `overlaps`，仅在两个不同的有效派车组日期重叠时返回；无异常时固定为空数组： + +```json +{ + "vehicleId": 100, + "assignments": [], + "overlaps": [ + { + "firstAssignmentGroupId": 1001, + "secondAssignmentGroupId": 1002, + "overlapStartDate": "2026-05-03", + "overlapEndDate": "2026-05-04", + "code": "ACTIVE_ASSIGNMENT_OVERLAP", + "message": "同一车辆存在有效派车日期重叠" + } + ] +} +``` + +- `canceled` 派车切片不进入 `assignments`、顶部统计、衔接计算或 `overlaps`。 +- 同一派车组的有效日期被取消日切断时，`assignments` 返回两个不连续日期段，但顶部仍按一个派车组计数。 +- `overlaps` 是明确的数据异常，不是新的普通占用颜色；前端应显示独立冲突提示并允许定位涉及的两个派车组。 + 派单继续复用现有车务候选、预校验和创建派单接口，不新增接口。 ## 验收清单 @@ -97,6 +120,7 @@ - [ ] 图例分别说明“派车占用”和“订单衔接”，普通占用、衔接标记与重叠异常不会混淆。 - [ ] 历史操作默认不显示或拼接 `detailJson`，保险退保记录使用中文业务摘要。 - [ ] 已取消且有效派车组为 0 的订单只保留详情历史，不绘制矩阵占用条。 +- [ ] `vehicles[].overlaps[]` 非空时展示明确重叠异常；为空时不显示冲突样式。 - [ ] 在 以车务管理员角色完成页面、Network/API 响应和截图验收。 ## 现场证据