From 374002060363e3ee07963e6c41a9b02c4060ba8e Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Thu, 23 Jul 2026 15:26:42 +0800 Subject: [PATCH] docs(fleet): hand off holding reassignment contract (#5186) --- ...中订单恢复派车派人入口-修改接口-管理后台.md | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 changelogs-v2/2026-07/23_5186_排车中订单恢复派车派人入口-修改接口-管理后台.md diff --git a/changelogs-v2/2026-07/23_5186_排车中订单恢复派车派人入口-修改接口-管理后台.md b/changelogs-v2/2026-07/23_5186_排车中订单恢复派车派人入口-修改接口-管理后台.md new file mode 100644 index 0000000..4fc511b --- /dev/null +++ b/changelogs-v2/2026-07/23_5186_排车中订单恢复派车派人入口-修改接口-管理后台.md @@ -0,0 +1,61 @@ +# Fleet：排车中订单恢复“派车派人”入口 + +> **服务**: hl-fleet-service +> **Issue**: #5186 +> **日期**: 2026-07-23 +> **影响范围**: 管理后台车务派单看板及订单派车流程 + +--- + +## ⚠️ 关键变化 + +排车状态为 `holding` 或 `holding_urgent` 时，订单并非不可操作：后端现在返回 `canAssign=true`，并在 `availableActionCodes` 中下发 `CHANGE_ASSIGNMENT`，允许车务继续进入“派车派人”流程调整司机或车辆。 + +## 一、变更接口 + +| 接口 | 方法 | 路径 | 变更类型 | +|------|------|------|----------| +| 派单看板列表 | GET | `/v3/admin/fleet/board/orders` | 响应字段取值扩展 | + +请求参数、响应结构和写接口路径均未改变。 + +## 二、响应契约 + +`records[]` 中以下字段按服务端返回值处理： + +| `assignmentStatus` | `canAssign` | `availableActionCodes` | 前端行为 | +|---|---:|---|---| +| `unassigned` | `true` | 包含 `ASSIGN` | 展示“派车派人”，提交既有创建派单接口 | +| `unassigned_urgent` | `true` | 包含 `ASSIGN` | 展示“派车派人”，提交既有创建派单接口 | +| `holding` | `true` | 包含 `CHANGE_ASSIGNMENT` | 展示“派车派人”，提交既有 `changeAssignment` 改派接口 | +| `holding_urgent` | `true` | 包含 `CHANGE_ASSIGNMENT` | 展示“派车派人”，提交既有 `changeAssignment` 改派接口 | +| `assigned` / `completed` / `canceled` | `false` | 不包含上述可派动作 | 不展示入口 | + +前端不要再用 `assignmentStatus === 'unassigned'` 自行推断入口，也不要因为订单已有司机或车辆就隐藏按钮。入口以 `canAssign === true` 为第一判断，具体提交模式以 `availableActionCodes` 为准。 + +排车中进入流程属于调整当前有效派单，不是新增第二条有效派单；继续复用现有改派请求、基线差异提示、司机车辆档期冲突提示和刷新逻辑。 + +## 三、不影响范围 + +- `canRejectRequirement` 仍只在未派阶段可能为 `true`；排车中不得重新开放“驳回用车需求”。 +- 已派车、已完成、已取消状态不会因本次变更开放派车入口。 +- 无数据库、Redis、MQ、请求字段或错误码变更。 + +## 四、前端自测清单 + +- [ ] `holding` 订单显示“派车派人”按钮，点击后带出当前司机、车辆并进入调整流程。 +- [ ] `holding_urgent` 同样可进入调整流程。 +- [ ] 提交时调用既有 `changeAssignment`，不调用创建派单接口。 +- [ ] `assigned`、`completed`、`canceled` 不误显示入口。 +- [ ] 调整成功后刷新看板，页面只保留一组当前有效派单。 + +## 五、后端验证 + +- 状态矩阵、生命周期动作及排车中改派保护已有定向测试覆盖。 +- `mvn -f hl-fleet-service/pom.xml spotless:check` 通过。 +- `mvn -pl hl-fleet-service -am verify` 通过。 + +## 六、相关文档 + +- [wx/HL#5186](https://git.1814.love:8443/wx/HL/issues/5186) +