docs(fleet): 改派回显缺陷补充接口地址/参数/响应详情

changelogs-v2/2026-08/08_frontend_改派选完车司机槽位列不回显-前端缺陷-管理后台.md

@@ -1,7 +1,7 @@
 ---
 schema: "hl-changelog/v2"
 ticket: "frontend-fleet-reassign-display"
-title: "改派选完车辆/司机后，槽位「当前车辆/当前司机」列不回显新选择（仍显示「待重新选择」）"
+title: "改派选完车辆/司机后，槽位「当前车辆/当前司机」列与按天改派表格不回显新选择"
 consumer: "admin"
 author: "wx(GIT)"
 change_type: "前端缺陷"
@@ -12,38 +12,93 @@ frontend_owner: "mmg"
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "前端缺陷：改派流程选完车辆/司机（点「完成选择」）后，槽位表格顶部「当前车辆/当前司机」列不回显新选择，仍显示「待重新选择」；实际选择已写入底部改派草稿（可正常提交）。用户误以为没选上。待前端修复回显。"
+status_note: "前端缺陷：改派选完车辆/司机（完成选择）后，槽位顶部列与按天改派表格均不回显新选择。选择已在前端草稿（底部可见）且可正常提交生效，纯前端回显未刷新。待前端修复。"
 updated_at: "2026-08-08"
 base: "dev-v3"
-generated: "2026-08-08T22:40:00+08:00"
+generated: "2026-08-08T22:50:00+08:00"
 ---
 
-# 改派选完车辆/司机后，槽位「当前车辆/当前司机」列不回显新选择
+# 改派选完车辆/司机后，槽位列与按天改派表格不回显新选择
 
 > 前端缺陷，待前端修复。后端无问题（改派可正常提交生效）。
 
 ## 现象（TEST 实测，订单 26-6436 周梦洁）
 
-1. 改派流程：改派 → 选择改派 → 清除车辆/司机 → 选择车辆/司机 → 弹窗选好新车（蒙A-T7777）+新司机（宝音德力格尔）→ 点「完成选择」。
-2. 回到排车页，**槽位表格顶部「当前车辆」「当前司机」列仍显示「待重新选择」**——看不到刚选的车/司机。
-3. 但页面**底部改派草稿已正确显示**「蒙A-T7777（丰田普拉多）· 宝音德力格尔 135****5009」——选择已记录。
-4. 按天改派表格仍显示原派单（蒙A-E2E01 道尔吉 已派车）。
+改派流程操作：改派 → 下一步 → 选择改派 → 清除车辆/司机 → 选择车辆/司机 → 弹窗选**蒙A-T7777 + 宝音德力格尔** → 点「完成选择」。
 
-**问题**：选完后槽位顶部列不回显，用户以为没选上/操作没生效，易困惑误操作。
+回到排车页后：
+- **槽位表格顶部**：「当前车辆」「当前司机」列仍显示「**待重新选择**」（未回显新选）。
+- **按天改派表格**（3 个服务日 8/23~8/25）：「当前车辆」「当前司机」列仍显示旧派单「**蒙A-E2E01 道尔吉**」（未回显新选）。
+- **底部改派草稿**正确显示「蒙A-T7777（丰田普拉多）· 宝音德力格尔 135\*\*\*\*5009」——选择已被前端记录，只是上面两处列没刷新。
+
+用户以为没选上，易困惑/重复操作。
+
+## 涉及接口
+
+### 1. 派单详情（回显数据源）
+
+```
+GET https://api.test.1814.love:9443/admin/fleet/board/orders/{orderId}
+```
+
+路径参数：`orderId`（如 2086270156475936769，团号 26-6436）
+
+响应（节选，data 节点）——**这是改派前的当前派单事实**：
+```json
+{
+  "currentAssignment": {
+    "id": "2086276434870853634",
+    "vehiclePlate": "蒙A-E2E01",
+    "driverName": "道尔吉",
+    "assignmentStatus": "assigned"
+  },
+  "vehicleSlots": [{
+    "fleetItemIndex": 0,
+    "vehiclePlate": "蒙A-E2E01",
+    "driverName": "道尔吉",
+    "slotStatus": "assigned",
+    "vehicleId": "2085284111341023234",
+    "driverId": "2065272150012444674"
+  }]
+}
+```
+
+**说明**：改派「完成选择」后，新选择只在前端**草稿态**（尚未提交 change），此时槽位列/按天表格若仍读 `currentAssignment`/`vehicleSlots`（即旧 assigned 派单），就永远显示旧值。前端应在选完后用**草稿的新 vehicleId/driverId（车辆车牌/司机姓名）**覆盖回显这两处列，而不是继续展示 assigned 事实。
+
+### 2. 改派提交（选择真正生效）
+
+```
+POST https://api.test.1814.love:9443/admin/fleet/assignments/{assignmentId}/change
+```
+
+路径参数：`assignmentId`（当前派单 id，如 2086276434870853634）
+
+请求体（示例）：
+```json
+{
+  "newVehicleId": "蒙A-T7777对应vehicleId",
+  "newDriverId": "宝音德力格尔对应driverId",
+  "effectiveDate": "2026-08-23",
+  "holdMode": 1,
+  "reason": "改派",
+  "requestId": "front-change-<ts>"
+}
+```
+
+响应：`code=200` 成功，旧行取消、新行生效。**此接口实测正常**（改派提交后车辆/司机正确变更）——所以是纯前端回显问题。
 
 ## 期望
 
-改派选完车辆/司机（完成选择）后，槽位表格的「当前车辆」「当前司机」列应立即回显新选的车辆+司机（与底部草稿一致），让用户明确看到改派结果。
+改派「完成选择」后（草稿态、未提交前），以下两处立即回显新选的车辆+司机（与底部草稿一致）：
+1. 槽位表格顶部「当前车辆」「当前司机」列；
+2. 按天改派表格每个服务日的「当前车辆」「当前司机」列。
 
-## 对比
-
-- 初次派单：选完应用后槽位列正常显示车/司机 ✅
-- 改派：选完后槽位列不回显（仍「待重新选择」）❌
+即：选完后前端用草稿的 `newVehicleId/newDriverId`（解析出车牌/司机名）覆盖这两处的展示，让用户明确看到改派结果。
 
 ## 复现路径
 
-派单看板 → 已派车订单 → 改派 → 下一步 → 选择改派 → 清除车辆/司机 → 选择车辆/司机 → 弹窗选车+选司机 → 完成选择 → 看槽位顶部「当前车辆/当前司机」列。
+派单看板 → 已派车订单（如 26-6436）→ 改派 → 下一步 → 选择改派 → 清除车辆/司机 → 选择车辆/司机 → 弹窗选车+选司机 → 完成选择 → 观察槽位顶部列与按天改派表格的「当前车辆/当前司机」列。
 
 ## 备注
 
-- 后端改派提交（POST /{id}/change）正常，选择已正确传入并生效——纯前端回显问题。
+- 初次派单（AssignModal）选完应用后槽位列正常回显 ✅；问题仅在**改派（重新派单）流程**的「完成选择」回显环节。