docs(fleet): 补充矩阵重叠异常接口契约

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[]` 非空时展示明确重叠异常；为空时不显示冲突样式。
 - [ ] 在 <http://192.168.100.160:9527> 以车务管理员角色完成页面、Network/API 响应和截图验收。
 
 ## 现场证据