docs(changelog): #5784 需求换版保留旧派车待人工核对（看板详情新增徽章字段，前端待接）

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

changelogs-v2/2026-08/10_5784_需求换版保留旧派车待人工核对-修改接口-管理后台.md

@@ -0,0 +1,69 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5784"
+title: "用车需求换版不再自动清除已派车：保留待人工核对 + 看板详情新增徽章字段"
+consumer: "admin"
+author: "wx(GIT)"
+change_type: "修改接口"
+backend_status: "pending"
+gateway_status: "not_required"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "后端 PR 待合并部署；前端需接看板详情两个新字段挂「需求已改版」徽章与人工核对列表。"
+updated_at: "2026-08-10"
+base: "dev-v3"
+---
+
+# 车务/订单: 用车需求换版不再自动清除已派车，保留待人工核对（#5784）
+
+> **服务**: hl-fleet-service (8087/8187) + hl-order-service-v3 (8086/8186)
+> **PR**: 待填
+> **Issue**: #5784
+> **日期**: 2026-08-10
+> **影响范围**: 派单看板订单详情（新增 2 字段）；换版/改期/改天数后的派车与订单配车摘要行为
+
+---
+
+## ⚠️ 关键变化（行为纠偏）
+
+此前：改用车需求（车型/座位）、改出发日期、改行程天数会**自动取消**未沿用的已派车（含已确认 assigned）并软删订单侧配车摘要。
+现在：**只自动取消未派车的 unassigned 占位；holding/assigned 一律保留**（状态、日期、资源占用都不动），盖「已被新版需求取代」标记，由车管人工核对后改派或取消。订单侧旧配车摘要也不再软删。增加出行人数行为不变（全部沿用）。
+
+依据：SRS FLEET §9.18 #2 拍板（派单确认后是独立资产）+ 房务同款口径（既有配房不自动清理）。
+
+## 接口变化（管理后台）
+
+`GET /admin/fleet/board/orders/{orderId}`（看板订单详情）**新增 2 个响应字段**：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `requirementChangePendingCount` | int | 需求已改版待人工核对的保留派单数；**>0 时前端应挂「需求已改版，请人工核对」徽章** |
+| `supersededAssignments` | array | 保留派单明细：`assignmentId`/`assignmentGroupId`/`assignmentSlotId`/`requirementId`(旧版)/`supersededByRequirementId`(新版)/`requirementSupersededAt`/`assignmentStatus`(holding\|assigned)/`vehiclePlate`/`vehicleModel`/`driverName`/`startDate`/`endDate`/`serviceDate`；ID 均字符串序列化 |
+
+其余接口路径/入参无变化。`PUT /v3/admin/order/{id}/vehicle-requirement` 响应中 `assignmentDeletedCount` 字段保留但**恒为 0**（不再软删）。
+
+## 对前端的要求（mmg）
+
+1. 派单看板**详情/派单弹窗**：`requirementChangePendingCount > 0` 时挂「需求已改版，请人工核对」徽章，用 `supersededAssignments` 渲染人工核对列表（含车/司机/日期/状态）。
+2. 处置动作复用现有能力：改派（一键释放重派 #5592 已有）或取消（普通取消派单）；被取消/改派后字段自动归零。
+3. 注意：保留行**不出现**在 `activeAssignments`/`dailyVehiclePlan`（那是当前需求的方案）；也不产生看板列表卡片，徽章只在详情级。
+4. 订单详情（定制师侧）无字段变化；换版后旧配车在新方案回配前的展示口径不变。
+
+## 联动语义（供前端理解，无需实现）
+
+- 保留行继续占用车辆/司机（同日期同资源不可重复派），人工取消后释放；改期后新日期不受旧占用影响。
+- 换版自动化只作用于 unassigned：减槽取消未派占位、增槽补新 unassigned。
+
+## 关联 / 联系人
+
+### 链接
+
+- **Issue**: [#5784](https://git.1814.love:8443/wx/HL/issues/5784)
+
+### 联系人
+
+- **后端负责人**: @wx
+- **前端负责人**: @mmg