From 92b53da54d90954a7df72e7054c565c4b7f38065 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 24 Jul 2026 11:10:25 +0800
Subject: [PATCH] docs(order): hand off vehicle rejection history (#5200)

---
 ...¦éœ€æ±‚驳回历å�²ä¸Žé‡�æ–°æ��交-修改接å�£-管ç�†å�Žå�°.md | 150 ++++++++++++++++++
 1 file changed, 150 insertions(+)
 create mode 100644 changelogs-v2/2026-07/24_5200_用车需求驳回历�与�新�交-修改接�-管���.md

diff --git a/changelogs-v2/2026-07/24_5200_用车需求驳回历�与�新�交-修改接�-管���.md b/changelogs-v2/2026-07/24_5200_用车需求驳回历�与�新�交-修改接�-管���.md
new file mode 100644
index 0000000..18d0fd7
--- /dev/null
+++ b/changelogs-v2/2026-07/24_5200_用车需求驳回历�与�新�交-修改接�-管���.md
@@ -0,0 +1,150 @@
+---
+schema: "hl-changelog/v1"
+ticket: "5200"
+title: "用车需求驳回历�与�新�交"
+consumer: "admin"
+backend: "verified"
+gateway: "verified"
+frontend: "pending"
+base: "dev-v3"
+generated: "2026-07-24T11:05:00+08:00"
+---
+
+# �修改接�·�端待处�·管���】用车需求驳回历�与�新�交
+
+## 目标�端
+
+- 端类型：管���（Web）
+- 目标仓库：`mmg/hl-ui`
+- 目标分支：`v2.1`
+- �调/验收环境：<http://192.168.100.160:9527>
+- �程�：无需处�
+
+> **�务**: hl-order-service-v3�hl-fleet-service
+>
+> **工�**: [wx/HL#5200](https://git.1814.love:8443/wx/HL/issues/5200)
+>
+> **影�范围**: 订�详情行程安排中的用车需求�驳回�的�新�交
+
+## 业务�径
+
+- 用车需求被车务驳回�，旧版本终�失活并作为�读历��留，�是“已回��。
+- 驳回�没有当� active 用车需求，订�详情�许定制师�新�交。
+- �新�交创建新的 active 版本并�新进入车务�程，��活或覆盖旧版本。
+- 新旧版本�以��展示：当�版本�留原有�作，历�版本�读。
+
+## 一�订�详情行程安排
+
+接�：
+
+```http
+GET /v3/admin/order/{orderId}/itinerary
+```
+
+�应 `data` 新增：
+
+```json
+{
+  "vehicleGroup": null,
+  "vehicleHistory": [
+    {
+      "requirementId": "2080186927616606210",
+      "version": 1,
+      "status": "REJECTED_TO_CONSULTANT",
+      "isActive": false,
+      "submittedAt": "2026-07-23 15:03:06",
+      "returnedAt": "2026-07-24 09:20:00",
+      "returnRemark": "当地无�适车辆",
+      "vehicleTypeSummary": "suv×1",
+      "specialTags": ["儿童安全座椅", "大行�空间"],
+      "pickupRequired": true,
+      "dropoffRequired": true,
+      "remark": "原需求备注"
+    }
+  ],
+  "canContactFleet": false,
+  "contactFleetDisabledReason": "请先�交有效用车需求���系车务"
+}
+```
+
+### `vehicleHistory` 字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `requirementId` | `String` | 历�需求 ID |
+| `version` | `Integer` | 版本�，列表按版本倒� |
+| `status` | `String` | 驳回场景为 `REJECTED_TO_CONSULTANT` 或 `REJECTED_TO_ADMIN` |
+| `isActive` | `Boolean` | 历�项固定为 `false` |
+| `submittedAt` | `LocalDateTime` | 原需求�交时间 |
+| `returnedAt` | `LocalDateTime/null` | 驳回时间 |
+| `returnRemark` | `String/null` | 驳回原因 |
+| 其余摘�字段 | 与 `vehicleGroup.requirement` 相� | 车型�座��接��特殊诉求和备注等原需求快照 |
+
+边界行为：
+
+- 从未�交用车需求：`vehicleGroup=null`�`vehicleHistory=[]`。
+- 已驳回且尚未��：`vehicleGroup=null`�`vehicleHistory` 包�驳回历�。
+- 已�新�交：`vehicleGroup.requirement` 是新 active 版本，`vehicleHistory` �包�旧版本。
+- 历�列表还�能包�被正常�版替�的失活版本，�端按 `status` 决定是�展示“已驳回�。
+
+## 二��新�交
+
+继续使用现有接�：
+
+```http
+PUT /v3/admin/order/{orderId}/vehicle-requirement
+```
+
+驳回��交的返回语义：
+
+```json
+{
+  "code": 200,
+  "data": {
+    "version": 2,
+    "isActive": true,
+    "status": "PENDING",
+    "branchTaken": "INIT_SUBMIT"
+  }
+}
+```
+
+版本规则：
+
+- 新版本� = 历�最高版本� + 1；
+- 新版本为当� active 需求；
+- 旧驳回版本继续留在 `vehicleHistory`；
+- 仅新版本进入车务看�和派��程。
+
+## 三��端处�清�
+
+- [ ] 订�详情用车�片固定支�“历�需求��读区域，�论当� active 需求是�存在。
+- [ ] 历�项展示版本�原需求内容�驳回状��`returnedAt` 和 `returnRemark`。
+- [ ] 历�项�得显示修改��系车务�派车或“已回��等当�需求�作/文案。
+- [ ] `vehicleGroup=null` 且 `vehicleHistory` �空时，继续显示“�交用车需求�入�。
+- [ ] 有新 `vehicleGroup.requirement` 时，�时展示当�需求和旧历�，历�项�覆盖当�状�。
+- [ ] ��把 `vehicleHistory` 项映射�当� `vehicleGroup.requirement`。
+- [ ] 覆盖驳回未���驳回����存在多个历�版本三个场景。
+
+## 四�兼容说明
+
+现有�端在 `vehicleGroup=null` 时已能进入“�交用车需求�空�，因此�端部署��会�把驳回需求误显示�“已回��。新增历�区域需��端按上方清�接入；未接入时�是暂�展示历�内容，�影��新�交。
+
+## 五��端验�
+
+- 驳回 CAS 原�更新 `status`�`is_active=false`�驳回原因/时间并清空接�人。
+- Fleet Outbox 按“订�需求驳回�功 → �消未派���的顺�执行；�放已失活驳回历�时幂等�功。
+- 无 active 需求时按历�最高版本递增，兼容旧 active rejected 数�。
+- 订�/Fleet 相关定�测试累计 658 项通过。
+- `mvn -pl hl-order-service-v3 -am verify`�`mvn -pl hl-fleet-service -am verify` 和 fleet `spotless:check` 全部通过。
+- �端 PR [wx/HL#5206](https://git.1814.love:8443/wx/HL/pulls/5206) 已�并到
+  `dev-v3@c13a035d0`；测试环境滚动部署任务 `a2a5a9fa` �功，8086/8186 两实例�康。
+- 网关以 `wx` 验�订� `26-9919`：驳回�移� `vehicleGroup=null`，
+  `vehicleHistory` 返回 v1�`REJECTED_TO_CONSULTANT`�`isActive=false` �原驳回原因；
+  �新�交返回 v2�`PENDING`，�次查询�时�留 v1 历�和 v2 当�需求。
+- 测试库核对：v1 已失活且�留，v2 为唯一 active；Fleet 为 v2 生� 6 �
+  `unassigned` 日切片，旧 v1 的 6 �派��� `canceled`。
+- 异常团� `26-4165` 的 3 �旧派��已�消并软删除，0 ����0 �在途；
+  对应失败 Outbox 已进入 `QUARANTINED`，网关看�按团��索返回 0 �。
+
+> 本文是�端接入通知，�代表已修改或�布 `mmg/hl-ui`。