chore(changelog): 派车详情按车型聚合为全程槽（#5562）

changelogs-v2/2026-08/05_5562_派车详情按车型聚合为全程槽-修改接口-管理后台.md

@@ -0,0 +1,67 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5562"
+title: "派车详情按车型聚合为全程槽（详情页 2 条全程槽，可删除，删除意图持久化）"
+consumer: "admin"
+change_type: "修改接口"
+author: "wx(GIT)"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "后端完成：PR #5564 已合并 dev-v3 并部署 TEST；网关验证通过（详情页 2 条全程槽 + 整组删 + 按天派车不回归）。前端详情页默认用 vehicleSlots[] 呈现按车型聚合的全程槽并接入删除入口。"
+updated_at: "2026-08-05"
+base: "dev-v3"
+---
+
+# 车务: 派车详情按车型聚合为全程槽
+
+> **服务**: hl-fleet-service
+> **PR**: #5564
+> **Issue**: [#5562](https://git.1814.love:8443/wx/HL/issues/5562)
+> **日期**: 2026-08-05
+
+## 背景
+
+定制师提用车需求（例：1 SUV + 1 商务，服务 4 天），车务详情页此前按 `dailyVehiclePlan` 逐日×车型展示 8 条散装切片。本次在详情接口新增**按车型聚合的全程槽** `vehicleSlots[]`（SUV 一条管全程、商务一条管全程），并支持整组删除；删除后同一需求的重新展开不会复活被删槽位。按天派车细节 `dailyVehiclePlan` 保留不变（按天派不同车/司机能力不回归）。
+
+## 变更接口
+
+| 方法 | 路径 | 来源 |
+|---|---|---|
+| `GET` | `/admin/fleet/board/orders/{orderId}` | `BoardController`（fleet） |
+
+路径前缀 `/admin/fleet/**` 已由网关登录/角色校验与 `FleetAdminRoleGuardInterceptor`（VEHICLE_MANAGER / SUPER_ADMIN）收口，无需新增网关规则。响应**新增字段** `vehicleSlots[]`，其余字段不变。
+
+## 1. 详情接口新增 `vehicleSlots[]`（按车型聚合的全程槽）
+
+响应 `data.vehicleSlots[]` 每项：
+
+| 字段 | JSON 类型 | 说明 |
+|---|---|---|
+| `assignmentSlotId` | string(Long) | 稳定车辆槽位 ID（删除接口入参） |
+| `fleetItemIndex` | int | 需求车辆槽位序号（0 起） |
+| `assignmentGroupId` | string(Long) | 当前派车组 ID；同槽位跨段换车时每段一条 |
+| `requiredVehicleType` | string | 要求车型编码（小写 key，如 `suv`/`mpv`） |
+| `requiredVehicleTypeLabel` | string | 要求车型标签（如 `SUV`/`商务车`） |
+| `requiredSeats` | int | 要求座位数 |
+| `serviceStartDate` / `serviceEndDate` | string(date) | 本段槽位全程服务区间（如 4 天全程） |
+| `serviceDays` | int | 服务天数（闭区间） |
+| `slotStatus` | string | 槽位聚合落库态：`unassigned`/`holding`/`assigned`/`completed`/`canceled` |
+| `slotStatusLabel` | string | 聚合状态中文标签 |
+| `assignmentId` | string(Long) | 代表派单 ID |
+| `vehicleId`/`vehiclePlate`/`vehicleModel` | string | 代表车辆（未派为 null） |
+| `driverId`/`driverName`/`driverPhone` | string | 代表司机（未派为 null，手机号脱敏） |
+| `canDelete` | bool | 本槽位是否可整组删除（无已派/已确认/已完结/finalized 取消行且订单未只读） |
+| `deleteBlockReason` | string | 不可删除原因；可删除时为 null（`槽位已派车或已确认，请先取消派车后再删除` / 只读原因） |
+
+**删除规则与口径**：与 `DELETE /admin/fleet/assignments/slots/{slotId}`（#5550）完全一致；删除成功即整组删（软删全部未派切片 + Step2 快照收敛）。**新增持久化**：删除意图写入 `fleet_assignment_slot_removal`（按 requirement_id + fleet_item_index 唯一），同一需求后续重新展开（reconcile 重放/补缺）自动跳过被删槽位，不再复活；需求换版（新 requirementId）按新需求重新展开不受影响。
+
+## 前端配合
+
+1. 详情页**默认以 `vehicleSlots[]` 呈现槽位列表**（2 条全程槽），替代按天切片展示；
+2. `canDelete=true` 时提供「删除槽位」入口，调 `DELETE /admin/fleet/assignments/slots/{slotId}`（body `{"reason":"..."}`）；605007/605012 错误提示沿用；
+3. 逐日细节（每日车/司机/价格/接送）继续用 `dailyVehiclePlan`（按天派车、改派、确认能力不变）。