wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态

docs(fleet): verify reassign context handoff (#5186)
所有检测均成功
changelog-filename-gate / validate (push) Successful in 2s
详情

浏览代码
这个提交包含在：
API Changelog Bot 2026-07-23 16:23:50 +08:00
父节点 6b29df3f63
当前提交 171be62be5
共有 1 个文件被更改，包括 12 次插入 和 8 次删除
显示统计 下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

20
changelogs-v2/2026-07/23_5186_排车中订单恢复派车派人入口-修改接口-管理后台.md
查看文件

@ -4,8 +4,8 @@ ticket: "5186"
title: "排车中订单恢复派车派人入口并补齐改派上下文" title: "排车中订单恢复派车派人入口并补齐改派上下文"
consumer: "admin" consumer: "admin"
backend: "verified" backend: "verified"
gateway: "pending" gateway: "verified"
frontend: "pending" frontend: "not-required"
base: "dev-v3" base: "dev-v3"
generated: "2026-07-23T16:10:00+08:00" generated: "2026-07-23T16:10:00+08:00"
--- ---
@ -23,14 +23,14 @@ generated: "2026-07-23T16:10:00+08:00"
排车状态为 `holding` 或 `holding_urgent` 时，订单并非不可操作：后端现在返回 `canAssign=true`，并在 `availableActionCodes` 中下发 `CHANGE_ASSIGNMENT`，允许车务继续进入“派车派人”流程调整司机或车辆。 排车状态为 `holding` 或 `holding_urgent` 时，订单并非不可操作：后端现在返回 `canAssign=true`，并在 `availableActionCodes` 中下发 `CHANGE_ASSIGNMENT`，允许车务继续进入“派车派人”流程调整司机或车辆。
2026-07-23 补充：改派候选查询需要用 `orderId + requirementId + fleetItemIndex` 精确定位当前订单的当前用车需求槽位。看板列表、详情顶层和详情内每个有效派车组现均稳定返回字符串形式的 `requirementId`，前端直接透传，不自行推导。 2026-07-23 契约修订：改派候选查询需要用 `orderId + requirementId + fleetItemIndex` 精确定位当前订单的当前用车需求槽位。看板列表、详情顶层和详情内每个有效派车组现均稳定返回字符串形式的 `requirementId`，前端直接透传，不自行推导。
## 一、变更接口 ## 变更接口
| 接口 | 方法 | 路径 | 变更类型 | | 接口 | 方法 | 路径 | 变更类型 |
|------|------|------|----------| |------|------|------|----------|
| 派单看板列表 | GET | `/v3/admin/fleet/board/orders` | 响应字段取值扩展、新增字段 | | 派单看板列表 | GET | `/admin/fleet/board/orders` | 响应字段取值扩展、新增字段 |
| 派单看板详情 | GET | `/v3/admin/fleet/board/orders/{orderId}` | 新增字段 | | 派单看板详情 | GET | `/admin/fleet/board/orders/:orderId` | 新增字段 |
请求参数和写接口路径均未改变。 请求参数和写接口路径均未改变。
@ -84,11 +84,15 @@ generated: "2026-07-23T16:10:00+08:00"
- [ ] `assigned`、`completed`、`canceled` 不误显示入口。 - [ ] `assigned`、`completed`、`canceled` 不误显示入口。
- [ ] 调整成功后刷新看板，页面只保留一组当前有效派单。 - [ ] 调整成功后刷新看板，页面只保留一组当前有效派单。
## 五、后端验证 ## 验证证据
- 状态矩阵、生命周期动作、改派上下文及排车中改派保护已有定向测试覆盖。 - 后端提交：`aaeb01242`；PR：[wx/HL#5190](https://git.1814.love:8443/wx/HL/pulls/5190)，已合并 `dev-v3`。
- 状态矩阵、生命周期动作、改派上下文及排车中改派保护已有定向测试覆盖；`BoardOrderServiceTest` 与 `BoardControllerTest` 共 49 项通过。
- `mvn -f hl-fleet-service/pom.xml spotless:check` 通过。 - `mvn -f hl-fleet-service/pom.xml spotless:check` 通过。
- `mvn -pl hl-fleet-service -am verify` 通过。 - `mvn -pl hl-fleet-service -am verify` 通过。
- 测试环境 Fleet 滚动部署任务 `3458b3ab` 成功，8087、8187 两实例健康。
- 网关按团号 `26-7042` 验证：列表与详情 HTTP/code 200，`requirementId` 在列表、详情顶层、`currentAssignment` 和 `activeAssignments[]` 均存在；携带 `orderId + requirementId + fleetItemIndex + excludeAssignmentId` 调用候选接口 HTTP/code 200，返回 19 辆车、19 名司机候选。
- 当前前端 `v2.1` 已从 `order.requirementId` 组装候选请求，本次无需前端代码修改；后端部署后直接获得该字段。
## 六、相关文档 ## 六、相关文档