From e9a625d8fbe1f22aac954c686e1091a7bb3159a6 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 23 Jul 2026 16:11:59 +0800
Subject: [PATCH] docs(fleet): hand off reassign candidate context (#5186)

---
 ...¦ä¸­è®¢å�•æ�¢å¤�派车派人入å�£-修改接å�£-管ç�†å�Žå�°.md | 43 +++++++++++++++++--
 1 file changed, 39 insertions(+), 4 deletions(-)

diff --git a/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md b/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
index 4fc511b..4ff7cc1 100644
--- a/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
+++ b/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
@@ -1,3 +1,15 @@
+---
+schema: "hl-changelog/v1"
+ticket: "5186"
+title: "排车中订���派车派人入�并补�改派上下文"
+consumer: "admin"
+backend: "verified"
+gateway: "pending"
+frontend: "pending"
+base: "dev-v3"
+generated: "2026-07-23T16:10:00+08:00"
+---
+
 # Fleet：排车中订���“派车派人�入�
 
 > **�务**: hl-fleet-service  
@@ -11,13 +23,16 @@
 
 排车状�为 `holding` 或 `holding_urgent` 时，订�并����作：�端现在返回 `canAssign=true`，并在 `availableActionCodes` 中下� `CHANGE_ASSIGNMENT`，�许车务继续进入“派车派人��程调整�机或车辆。
 
+2026-07-23 补充：改派候选查询需�用 `orderId + requirementId + fleetItemIndex` 精确定�当�订�的当�用车需求槽�。看�列表�详情顶层和详情内�个有效派车组现�稳定返回字符串形�的 `requirementId`，�端直接�传，�自行推导。
+
 ## 一��更接�
 
 | 接� | 方法 | 路径 | �更类型 |
 |------|------|------|----------|
-| 派�看�列表 | GET | `/v3/admin/fleet/board/orders` | �应字段�值扩展 |
+| 派�看�列表 | GET | `/v3/admin/fleet/board/orders` | �应字段�值扩展�新增字段 |
+| 派�看�详情 | GET | `/v3/admin/fleet/board/orders/{orderId}` | 新增字段 |
 
-请求�数��应结构和写接�路径�未改�。
+请求�数和写接�路径�未改�。
 
 ## 二��应契约
 
@@ -35,23 +50,43 @@
 
 排车中进入�程属于调整当�有效派�，�是新增第二�有效派�；继续�用现有改派请求�基线差异�示��机车辆档期冲��示和刷新逻辑。
 
+### 改派候选上下文
+
+| �应�置 | 新增字段 | 类型 | 用途 |
+|---|---|---|---|
+| 列表 `data.records[]` | `requirementId` | `string` | 当��片所属用车需求 ID |
+| 详情 `data` | `requirementId` | `string` | 当�有效用车需求 ID |
+| 详情 `data.currentAssignment` | `requirementId` | `string` | 当�派车组所属用车需求 ID |
+| 详情 `data.activeAssignments[]` | `requirementId` | `string` | �个有效派车组所属用车需求 ID |
+
+进入改派候选查询时：
+
+- `orderId` �列表返回的数字订� ID；
+- `requirementId` 优先�详情顶层��字段，按具体派车组�作时��该组的��字段；
+- `fleetItemIndex` �当��片或当�派车组字段；
+- 三者必须原样�传给候选接�，�得使用团��订��或数组�置替代；
+- `orderId`�`requirementId` �按字符串处�，�� JavaScript 大整数精度丢失。
+
+当� `v2.1` 候选请求组装已�读� `order.requirementId`；�端部署�，从列表进入并�并详情时会获得该字段，无需�端猜测需求 ID。
+
 ## 三��影�范围
 
 - `canRejectRequirement` ��在未派阶段�能为 `true`；排车中�得�新开放“驳回用车需求�。
 - 已派车�已完��已�消状��会因本次�更开放派车入�。
-- 无数�库�Redis�MQ�请求字段或错误��更。
+- 无数�库�Redis�MQ�候选请求字段或错误��更。
 
 ## 四��端自测清�
 
 - [ ] `holding` 订�显示“派车派人�按钮，点击�带出当��机�车辆并进入调整�程。
 - [ ] `holding_urgent` �样�进入调整�程。
+- [ ] 打开排车步骤时，候选请求�时�带字符串 `orderId`�`requirementId` 和当� `fleetItemIndex`，��出现“改派候选查询必须�带当�订�ID�用车需求ID和车型项索引�。
 - [ ] �交时调用既有 `changeAssignment`，�调用创建派�接�。
 - [ ] `assigned`�`completed`�`canceled` �误显示入�。
 - [ ] 调整�功�刷新看�，页���留一组当�有效派�。
 
 ## 五��端验�
 
-- 状�矩阵�生命周期动作�排车中改派�护已有定�测试覆盖。
+- 状�矩阵�生命周期动作�改派上下文�排车中改派�护已有定�测试覆盖。
 - `mvn -f hl-fleet-service/pom.xml spotless:check` 通过。
 - `mvn -pl hl-fleet-service -am verify` 通过。