2.9 KiB
2.9 KiB
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通过。