From 9e5b45e7a50e60ae70a67e37837bf88034f13236 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sun, 5 Jul 2026 14:56:46 +0800
Subject: [PATCH] docs(vehicle): notify frontend add requirement button

---
 ...¦å®‰æŽ’缺少æ��交用车需求按钮-å‰�端待处ç�†-管ç�†å�Žå�°.md | 132 ++++++++++++++++++
 1 file changed, 132 insertions(+)
 create mode 100644 changelogs-v2/2026-07/20_订�详情用车安排缺少�交用车需求按钮-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/20_订�详情用车安排缺少�交用车需求按钮-�端待处�-管���.md b/changelogs-v2/2026-07/20_订�详情用车安排缺少�交用车需求按钮-�端待处�-管���.md
new file mode 100644
index 0000000..4fd1daf
--- /dev/null
+++ b/changelogs-v2/2026-07/20_订�详情用车安排缺少�交用车需求按钮-�端待处�-管���.md
@@ -0,0 +1,132 @@
+# 订�详情用车安排缺少“用车需求�按钮（�端待处�）
+
+> 模�：管��� · 订�详情 v2 `/order-v2/detail/{orderId}` · 行程安排
+> 类型：**�端待处�（�端无接��更）**
+> 日期：2026-07-05
+> 说明：�端已有�交/修改/调整用车需求接�，�端需�在“用车安排��片补充入�。
+
+## 问题现象
+
+测试页�：
+
+- 页�：订�详情 v2 → 行程安排
+- 订�：`HL20260703140009401`
+- 订� ID：`2072923329412427777`
+- 当�用车�片文案：`尚未�交用车需求`
+- 当�页��显示“�系车务�按钮，缺少“用车需求 / �交用车需求�按钮。
+
+业务期望：
+
+- 当订�尚未�交用车需求时，定制师应能直接从“用车安排��片�起用车需求。
+- 用车需求�交�进入车务�续处�链路。
+
+## �端当��径
+
+�端已有接�，�需�新增接�。
+
+```http
+PUT /v3/admin/order/{id}/vehicle-requirement
+```
+
+��契约：
+
+```text
+�交/修改/调整用车需求（三分支自动判断：无 active=INIT_SUBMIT，PENDING=PENDING_EDIT，DONE=DONE_ADJUST）
+```
+
+测试��验当�订�：
+
+```http
+GET /v3/admin/order/2072923329412427777/itinerary
+```
+
+返回中�宿已完�，且当�没有 `vehicleGroup` 数�；页�展示“尚未�交用车需求�与接�状�一致。这�状�下�端应�供“用车需求�入�，而�是��供“�系车务�。
+
+## 接�说明
+
+### �交/修改/调整用车需求
+
+```http
+PUT /v3/admin/order/{id}/vehicle-requirement
+Content-Type: application/json
+```
+
+请求体：
+
+```json
+{
+  "fleet": [
+    {
+      "vehicleType": "BUSINESS",
+      "seats": 7,
+      "count": 1
+    }
+  ],
+  "specialTags": ["需�大�备箱"],
+  "remark": "客户有 2 个大件行�"
+}
+```
+
+字段约�：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `fleet` | array | 是 | 车型组�，至少 1 项 |
+| `fleet[].vehicleType` | string | 是 | 车型分类，字典 `vehicle_type` 的 value，如 `SUV/BUSINESS/CORE_PRODUCT` |
+| `fleet[].seats` | number | 是 | 座�数，行�车�为 0 |
+| `fleet[].count` | number | 是 | 辆数，需大于 0 |
+| `specialTags` | array | � | 特殊诉求标签，�许自定义 |
+| `remark` | string | � | 备注，最长 500 字 |
+
+�应中 `branchTaken` 表示�端实际分支：
+
+| branchTaken | 场景 |
+|-------------|------|
+| `INIT_SUBMIT` | 首次�交用车需求 |
+| `PENDING_EDIT` | 已有待处�用车需求，编辑当�需求 |
+| `DONE_ADJUST` | 已�车/已完���次调整用车需求 |
+
+## ��端 · 管���】处��求
+
+### 1. 用车安排�片补充“用车需求�按钮
+
+在订�详情 `行程安排` 的“用车安排��片中：
+
+- 当当�无用车需求，页�显示“尚未�交用车需求�时，展示主�作按钮：`用车需求` 或 `�交用车需求`。
+- 按钮�置建议与“�系车务��一�作区，��用户�能�系车务而无法录入需求。
+- 点击�打开现有用车需求表�/弹窗，�交到 `PUT /v3/admin/order/{id}/vehicle-requirement`。
+
+### 2. 已有用车需求时也应�许修改
+
+用车需求与�宿需求一致，�应�在空状���交：
+
+- 待处�/PENDING：按钮文案�为 `修改用车需求`，�交�走 `PENDING_EDIT`。
+- �车中/PROCESSING：��许修改，�交�由�端走调整链路。
+- 已完�/DONE：��许调整，�交�走 `DONE_ADJUST`。
+
+�端��因为用车�片状���“�车中 / 已�车 / 已完��就永久��该入�。
+
+### 3. 入�显示�径
+
+建议�端按“订�存在行程安排页 + 用车安排模����显示该入�，���赖是�已有 `vehicleGroup`：
+
+- 无 `vehicleGroup`：显示 `用车需求 / �交用车需求`。
+- 有 `vehicleGroup`：显示 `修改用车需求`。
+
+## 验收标准
+
+| 场景 | 期望 |
+|------|------|
+| `HL20260703140009401` 用车�片显示“尚未�交用车需求� | �片上显示“用车需求/�交用车需求�按钮 |
+| 点击按钮 | 打开用车需求表�，至少�填写车型�座�数�辆数�特殊诉求�备注 |
+| 首次�交 | 调用 `PUT /v3/admin/order/{id}/vehicle-requirement`，返回 `branchTaken=INIT_SUBMIT` |
+| 已有待处�用车需求 | ��打开表�修改，�端返回 `PENDING_EDIT` |
+| 已�车/已完��调整 | ��打开表�修改，�端返回 `DONE_ADJUST` |
+| “�系车务�按钮 | �留，�替代“用车需求�入� |
+
+## 影�范围
+
+| 页�/能力 | 说明 |
+|-----------|------|
+| `/order-v2/detail/{orderId}` | 行程安排页签 · 用车安排�片 |
+| `PUT /v3/admin/order/{id}/vehicle-requirement` | �用现有�端接�，无新增字段 |