From f3b433a034f01310e189a8c62b1674ce4ab1cac4 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 8 Jul 2026 18:12:52 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=A2=E5=8D=95=E7=94=A8=E8=BD=A6?=
 =?UTF-8?q?=E5=BA=A7=E4=BD=8D=E6=95=B0=E6=8C=89=E8=BD=A6=E5=9E=8B=E5=9E=8B?=
 =?UTF-8?q?=E5=8F=B7=E4=B8=8B=E6=8B=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¢å�•è°ƒæ•´ç”¨è½¦åº§ä½�数按车型型å�·ä¸‹æ‹‰-管ç�†å�Žå�°.md | 207 ++++++++++++++++++
 1 file changed, 207 insertions(+)
 create mode 100644 changelogs-v2/2026-07/50_4856_订�调整用车座�数按车型型�下拉-管���.md

diff --git a/changelogs-v2/2026-07/50_4856_订�调整用车座�数按车型型�下拉-管���.md b/changelogs-v2/2026-07/50_4856_订�调整用车座�数按车型型�下拉-管���.md
new file mode 100644
index 0000000..2efd537
--- /dev/null
+++ b/changelogs-v2/2026-07/50_4856_订�调整用车座�数按车型型�下拉-管���.md
@@ -0,0 +1,207 @@
+# ��端对接·管���】订�调整用车座�数按车型型�下拉
+
+> Issue: [wx/HL#4856](https://git.1814.love:8443/wx/HL/issues/4856)  
+> PR: [wx/HL#4857](https://git.1814.love:8443/wx/HL/pulls/4857)  
+> �务: `hl-fleet-service`�`hl-order-service-v3`  
+> 日期: 2026-07-08  
+> 影�范围: 订�详情 / 调整订�弹窗 / 车辆安排
+
+## 1. 结论
+
+- 订�调整弹窗的车辆安排��选择“车型大类�，�选择具体车型型�。
+- 座�数�是车型大类固定值，而是该大类下所有真实车型型� `seats` 去��的下拉选项。
+- �端调用 `GET /admin/fleet/vehicle-types/list`，用返回的 `seatOptions` 渲染座�数下拉。
+- �交时 `fleet[].vehicleType` 传大类 `typeKey`，`fleet[].seats` 传用户从 `seatOptions` 中选中的座�数。
+- �端会按真实车型库校验 `vehicleType + seats` 组�；�在该大类 `seatOptions` 内会拒��交。
+
+## 2. 车型大类与座�下拉
+
+```http
+GET /admin/fleet/vehicle-types/list
+Authorization: Bearer <admin-token>
+```
+
+�应示例：
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": [
+    {
+      "id": "2057378611889180674",
+      "typeKey": "suv2",
+      "typeName": "SUV系列",
+      "icon": "Car",
+      "description": null,
+      "sortOrder": 1,
+      "modelCount": 5,
+      "inUseCount": 4,
+      "seatOptions": [5, 7]
+    },
+    {
+      "id": "2057378611889180675",
+      "typeKey": "mpv",
+      "typeName": "商务车",
+      "icon": "Van",
+      "sortOrder": 2,
+      "modelCount": 5,
+      "inUseCount": 10,
+      "seatOptions": [7, 9, 19]
+    }
+  ]
+}
+```
+
+字段说明：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `typeKey` | string | 车型大类�交值。历�兼容值如 `suv2` �端会规范化�存。 |
+| `typeName` | string | 车型大类展示�。 |
+| `seatOptions` | number[] | 当�大类下车型型� `seats` 去����的�选座�数。 |
+| `modelCount` | number | 当�大类下车型型�数�。 |
+| `inUseCount` | number | 当�大类下在用车辆数�。 |
+
+�端处�规则：
+
+- 先选车型大类，�从该大类 `seatOptions` 渲染座�数下拉。
+- 座�数��许手输，��许用户改� `seatOptions` 之外的值。
+- 切�车型大类�，如果原座�数�在新大类 `seatOptions` 中，需�清空座�数并�求�新选择。
+- `seatOptions` 为空时，该大类�能�交，�示“该车型大类暂无�用座�数，请先维护车型库�。
+
+## 3. �交车辆需求
+
+```http
+PUT /v3/admin/order/2074746808742928386/vehicle-requirement
+Authorization: Bearer <admin-token>
+Content-Type: application/json
+```
+
+请求示例：
+
+```json
+{
+  "fleet": [
+    {
+      "vehicleType": "suv2",
+      "seats": 5,
+      "count": 1
+    },
+    {
+      "vehicleType": "mpv",
+      "seats": 7,
+      "count": 1
+    }
+  ],
+  "specialTags": ["儿童安全座椅", "中文�机"],
+  "remark": "需�接机，�备箱放 2 个 28 寸行�箱"
+}
+```
+
+�功�应示例：
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "id": "2074759000000000001",
+    "version": 1,
+    "isActive": true,
+    "status": "PENDING",
+    "submittedAt": "2026-07-08T18:40:00",
+    "claimerId": null,
+    "claimerName": null,
+    "claimedAt": null
+  }
+}
+```
+
+�端�存�径：
+
+- `fleet[].vehicleType` �存为规范化�的车型大类，例如历�值 `suv2` 会�存为 `suv`。
+- `fleet[].seats` 是用户选择的座�数选项值，�代表具体车型型� ID。
+- 一组车型默认覆盖整段行程；�会出现�几天和�几天车型大类��的需求。
+- 多车需求通过多组 `fleet[]` 或�组 `count > 1` 表达。
+
+## 4. �法座�数组�
+
+如果�端�交了�在该大类 `seatOptions` 中的座�数：
+
+```json
+{
+  "fleet": [
+    {
+      "vehicleType": "suv2",
+      "seats": 19,
+      "count": 1
+    }
+  ]
+}
+```
+
+失败�应示例：
+
+```json
+{
+  "code": 582024,
+  "message": "座�数�在该车型大类�选座�数中，请检查车型库",
+  "success": false,
+  "data": null
+}
+```
+
+�端处�：
+
+- 直接展示�端 `message`。
+- ��在�端自行兜底�任�座�数。
+- 如果线上出现该错误，先检查页�是�使用了最新 `seatOptions`，�检查车型库维护数�。
+
+## 5. 车务车型库��用
+
+订��务�交�会�读调用车务车型库校验座�数。如果车务车型库��用：
+
+```json
+{
+  "code": 582091,
+  "message": "车队车型库��用，无法校验座�数选项",
+  "success": false,
+  "data": null
+}
+```
+
+�端处�：
+
+- 直接�示�端 `message`。
+- ��绕过校验继续�交，因为�则会产生无法派车或错误座�数需求。
+
+## 6. �端对接清�
+
+| 场景 | 处�方� |
+|------|----------|
+| �次打开车辆安排 | 调 `GET /admin/fleet/vehicle-types/list`，缓存本次弹窗内的大类和 `seatOptions`。 |
+| 选择车型大类 | 更新座�数下拉为该大类 `seatOptions`。 |
+| 选择座�数 | �能从下拉中选，�能文本输入。 |
+| 切�车型大类 | 清空�兼容座�数，�求�新选择。 |
+| �交车辆需求 | `vehicleType=typeKey`，`seats=选中的 seatOptions 值`，`count=车辆数�`。 |
+| `seatOptions=[]` | �止�交该大类，�示维护车型库。 |
+| 错误� `582024` | 展示“座�数�在该车型大类�选座�数中，请检查车型库�。 |
+| 错误� `582091` | 展示“车队车型库��用，无法校验座�数选项�。 |
+
+## 7. �端本地验�
+
+```bash
+mvn -pl hl-fleet-service -am -Dtest=VehicleTypeServiceTest -DfailIfNoTests=false test
+mvn -pl hl-order-service-v3 -am -Dtest=RequirementServiceTest -DfailIfNoTests=false test
+```
+
+覆盖点：
+
+- `GET /admin/fleet/vehicle-types/list` 返回 `seatOptions`。
+- `seatOptions` ��于车型型� `seats`，去�并��。
+- 历�大类 key 兼容，例如 `suv2` �映射到 `suv` 座�数选项。
+- 订��交时�法 `vehicleType + seats` 通过。
+- 订��交时�法 `vehicleType + seats` 返回 `582024`。