From ff7e1190730db00bb752f34e63000bf141b075d9 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 10 Aug 2026 15:38:48 +0800
Subject: [PATCH] =?UTF-8?q?changelog(v2):=20#5788=20=E6=8D=A2=E7=89=88?=
 =?UTF-8?q?=E4=BF=9D=E7=95=99=E6=B4=BE=E5=8D=95=E5=8F=AF=E6=94=B9=E6=B4=BE?=
 =?UTF-8?q?+vehicleSlots=20=E6=A0=87=E6=97=A7=E5=AD=97=E6=AE=B5(PR=20#5796?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¿�留派å�•å�¯æ”¹æ´¾ä¸Žæ§½ä½�标旧-修改接å�£-管ç�†å�Žå�°.md | 74 +++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 changelogs-v2/2026-08/10_5788_�版�留派��改派与槽�标旧-修改接�-管���.md

diff --git a/changelogs-v2/2026-08/10_5788_�版�留派��改派与槽�标旧-修改接�-管���.md b/changelogs-v2/2026-08/10_5788_�版�留派��改派与槽�标旧-修改接�-管���.md
new file mode 100644
index 0000000..8a1b459
--- /dev/null
+++ b/changelogs-v2/2026-08/10_5788_�版�留派��改派与槽�标旧-修改接�-管���.md
@@ -0,0 +1,74 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5788"
+title: "�版�留派��改派：候选排除放行 superseded 行 + vehicleSlots 新增标旧字段"
+consumer: "admin"
+author: "wx(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "not_required"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+target_release: ""
+verified_at: "2026-08-10"
+status_note: "�端已部署测试�并按 26-9313 实测通过。�端需消费 vehicleSlots 新增 superseded 标识渲染「旧数��样�,并放开�留行的改派入�(候选请求��传 fleetItemIndex)。"
+updated_at: "2026-08-10"
+base: "dev-v3"
+---
+
+# 车务: 需求�版�留派��改派 + 槽�视图标旧（#5788）
+
+> **�务**: hl-fleet-service (8087/8187)
+> **PR**: #5796
+> **Issue**: #5788
+> **日期**: 2026-08-10
+> **影�范围**: 派�看�订�详情 vehicleSlots 结构(新增 3 字段)�派�候选查询排除校验语义
+> **背景**: #5784 �版�留行此�点「�新�置车辆�必报「�数�法: 排除派��属于当�订��当�用车需求或当�车型项�(26-9313 实测),改派通路被拦死;且槽�视图无法区分新旧行。
+
+---
+
+## 1. 详情接� vehicleSlots 新增 3 字段
+
+`GET /admin/fleet/board/orders/{orderId}` 的 `vehicleSlots[]` �行新增:
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `requirementId` | string(Long) | 槽�行所属用车需求ID;与顶层 requirementId �等且 superseded=true 时为�版�留的旧需求行 |
+| `superseded` | boolean | **是��版�留的旧派�行**。true=旧数�,仅供人工核对�改派/�消,��与当�方案日格进度与车费计数 |
+| `supersededByRequirementId` | string(Long) | �代该行的新需求ID;superseded=true 时�空 |
+
+**排�约定**: 当�需求槽�行在�(顺���),�版�留行追加在尾部。�留行固定 `canDelete=false`,`deleteBlockReason="需求已改版�留行，请改派或�消，�支�直接删除槽�"`。
+
+**�端��**: �留行渲染「旧数�/需求已改版�标识(区别于当�槽�),�作�留「改派 / �消�;顶部黄�(supersededAssignments)��现状作�醒入�。注��留行的 `fleetItemIndex` 是旧版展开�,�能与当�需求槽�撞�,**渲染分组请以 superseded 标志区分,勿��� fleetItemIndex**。
+
+## 2. 候选查询排除校验放宽(�留行改派入�打通)
+
+`POST /admin/fleet/assignments/candidates`:
+
+- `excludeAssignmentId` 现在�许两类:①当�需求本身的派�(原�径,�须 requirementId+fleetItemIndex 精确匹�);②**�版�留派�**(supersededByRequirementId �空,属当�订���)。
+- **排除�留行时 `fleetItemIndex` ��传**(旧版��在新需求下无语义,�端��校验);座�匹�自动锚�留行自身座�快照(requiredSeats),��按新需求车型项定�。
+- �留行自身�用会被正确排除:实测 exclude �原车 available=true�conflicts=[](�改回原车或�车)。
+- 防护�回归:�本订�/�存在的 assignmentId�普通行 fleetItemIndex �匹� → �报「�数�法�。
+
+## 3. 实测数�样例(测试� 26-9313)
+
+```json
+// vehicleSlots 尾部�留行
+{"fleetItemIndex":1, "requiredVehicleType":"mpv", "slotStatus":"assigned",
+ "vehiclePlate":"è’™A-S6666", "superseded":true,
+ "requirementId":"2086270153913225218",
+ "supersededByRequirementId":"2086700635972915201",
+ "canDelete":false, "deleteBlockReason":"需求已改版�留行，请改派或�消，�支�直接删除槽�"}
+```
+
+## 关� / �系人
+
+### 链接
+
+- **相关工�**: [#5788](https://git.1814.love:8443/wx/HL/issues/5788)�[#5784](https://git.1814.love:8443/wx/HL/issues/5784)(�版�留规则)
+
+### �系人
+
+- **�端负责人**: @wx
+- **�端负责人**: @mmg