From d9ecc04a93751f6491921929789340f0df862346 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sun, 5 Jul 2026 15:59:14 +0800
Subject: [PATCH] docs(fleet): clarify vehicle model dropdown contracts

---
 ...ˆ†æ®µå±•ç¤ºä¸Žè½¦åž‹ä¸‹æ‹‰æŽ¥å�£æ£€æŸ¥-å‰�端待处ç�†-管ç�†å�Žå�°.md | 215 ++++++++++++++++++
 1 file changed, 215 insertions(+)
 create mode 100644 changelogs-v2/2026-07/22_车务看�车型分段展示与车型下拉接�检查-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/22_车务看�车型分段展示与车型下拉接�检查-�端待处�-管���.md b/changelogs-v2/2026-07/22_车务看�车型分段展示与车型下拉接�检查-�端待处�-管���.md
new file mode 100644
index 0000000..1c0aceb
--- /dev/null
+++ b/changelogs-v2/2026-07/22_车务看�车型分段展示与车型下拉接�检查-�端待处�-管���.md
@@ -0,0 +1,215 @@
+# 车务看�车型分段展示与车型下拉接�检查（�端待处�）
+
+- 日期：2026-07-05
+- 端：管���
+- 页�：
+  - 车务管� / 派�看� `/fleet/board`
+  - 订�详情 / 用车需求弹窗
+- 结论：
+  - “实际车型�下拉的读�接�已有：`GET /admin/fleet/vehicle-types`，�分页，返回车型大类 + 型�树。
+  - 派�看�列表当�没有“�几天哪个车型��几天哪个车型�的分段字段，�能��端从现有��字段硬推。
+  - 订�用车需求�交接�当�也没有 `vehicleModelId` / 分段日期字段；�端��把实际型��直接塞进旧的 `vehicleType` 字段。
+
+## 1. 测试环境接��验
+
+### 1.1 派�看�列表
+
+```http
+GET /admin/fleet/board/orders
+```
+
+测试环境返回 `200`，列表记录当�有这些关键字段：
+
+| 字段 | 当��义 |
+|------|----------|
+| `startDate` | 本�派�行的开始日期 |
+| `endDate` | 本�派�行的结�日期 |
+| `fleetItemIndex` | �一用车需求展开�的项次� |
+| `requiredVehicles` | �订����的需求车型数组 |
+| `currentVehicleModel` | 已派车辆型�快照，未派为空 |
+| `currentVehicleSeats` | 已派车辆座�数，未派为空 |
+
+实测�一个订�出现多�派�行时，返回形�类似：
+
+```json
+[
+  {
+    "fleetItemIndex": 0,
+    "startDate": "2026-07-02",
+    "endDate": "2026-07-04",
+    "requiredVehicles": [
+      { "vehicleType": "mpv", "categoryLabel": "商务车", "seats": 7, "count": 1 },
+      { "vehicleType": "suv", "categoryLabel": "SUV", "seats": 5, "count": 2 }
+    ]
+  },
+  {
+    "fleetItemIndex": 1,
+    "startDate": "2026-07-02",
+    "endDate": "2026-07-04",
+    "requiredVehicles": [
+      { "vehicleType": "mpv", "categoryLabel": "商务车", "seats": 7, "count": 1 },
+      { "vehicleType": "suv", "categoryLabel": "SUV", "seats": 5, "count": 2 }
+    ]
+  }
+]
+```
+
+这说明 `requiredVehicles` 是订�级��，�是“该日期段对应车型�的明细。�端�能用这个字段推断“�几天商务车，�几天 SUV�。
+
+### 1.2 车型大类 + 实际型�树
+
+```http
+GET /admin/fleet/vehicle-types
+```
+
+测试环境返回 `200`，�分页，结构为：
+
+```json
+[
+  {
+    "id": "车型大类ID",
+    "typeKey": "suv2",
+    "typeName": "SUV系列",
+    "modelCount": 5,
+    "models": [
+      {
+        "id": "车型型�ID",
+        "vehicleTypeId": "所属大类ID",
+        "modelName": "丰田普拉多",
+        "seats": 7,
+        "basePrice": "1000.00",
+        "alias": "",
+        "inUseCount": 2
+      }
+    ]
+  }
+]
+```
+
+这个接��以作为“实际车型�下拉的数��。
+
+对比：
+
+```http
+GET /admin/fleet/vehicle-types/list
+```
+
+这个接��返回车型大类，�� `models`，�适��“实际车型型��下拉。
+
+## 2. �端处��求
+
+### 2.1 车型下拉改用实际车型树
+
+用车需求弹窗里的“车型�下拉��继续用��字典或写死选项：
+
+- 轿车
+- 商务车
+- SUV
+- 中巴
+- 大巴
+- 房车
+- 行�车
+
+应改读：
+
+```http
+GET /admin/fleet/vehicle-types
+```
+
+建议�端把 `data[].models[]` 拉平��选项：
+
+| 下拉内容 | �值 |
+|----------|------|
+| 展示文案 | `modelName`，�附带 `seats`，例如 `丰田普拉多 · 7座` |
+| 型� ID | `models[].id` |
+| 所属大类 | 外层 `id / typeKey / typeName` |
+| 默认座�数 | `models[].seats` |
+
+��用 `/admin/fleet/vehicle-types/list` �这个下拉；它�适�筛选大类，��实际型�。
+
+### 2.2 ��把实际型��直接�交到旧字段
+
+当�用车需求�交接��是旧契约：
+
+```http
+PUT /v3/admin/order/{id}/vehicle-requirement
+```
+
+当�入���有：
+
+| 字段 | 当��义 |
+|------|----------|
+| `fleet[].vehicleType` | 车型分类 |
+| `fleet[].seats` | 座�数 |
+| `fleet[].count` | 辆数 |
+
+当�没有：
+
+- `fleet[].vehicleModelId`
+- `fleet[].modelName`
+- `fleet[].startDate`
+- `fleet[].endDate`
+
+所以�端�能把 `丰田普拉多` 这类 `modelName` 直接�交到 `vehicleType`。fleet 侧历�归一�识别 `suv / mpv / bus / sedan` �少�中文分类别�，直接�交实际型��会导致�续需求展开无法稳定归一。
+
+如果本次�是“下拉数���先��实际车型库�，�端�以先用车型树�展示和辅助填座�数，但真正�存实际型� ID 需��端补�交契约。
+
+## 3. 派�看�“�几天哪个车型��几天哪个车型�
+
+当� `GET /admin/fleet/board/orders` �满足这个展示。
+
+原因：
+
+1. `requiredVehicles` 是订�级��数组，�是分段明细。
+2. `startDate/endDate` 是当�派�行日期段，�表达“�个车型需求对应哪个日期段�。
+3. 订�用车需求�数�当�也没有�个车型项自己的开始/结�日期。
+
+�端��按以下方�硬推：
+
+- ��用 `requiredVehicles` 数组顺� + `fleetItemIndex` 猜测日期段。
+- ��用整� `startDate/endDate` 切分���几天。
+- ��根�人数�车型数�或�片顺�推断车型分段。
+
+如果页��稳定展示“�几天 A 车型，�几天 B 车型�，需��端补明确字段。建议目标形�如下：
+
+```json
+{
+  "vehicleSegments": [
+    {
+      "startDate": "2026-05-19",
+      "endDate": "2026-05-21",
+      "vehicleModelId": "2090000000000000001",
+      "modelName": "丰田普拉多",
+      "vehicleType": "suv",
+      "vehicleTypeLabel": "SUV",
+      "seats": 7,
+      "count": 1
+    },
+    {
+      "startDate": "2026-05-22",
+      "endDate": "2026-05-24",
+      "vehicleModelId": "2090000000000000002",
+      "modelName": "别克GL8",
+      "vehicleType": "mpv",
+      "vehicleTypeLabel": "商务车",
+      "seats": 7,
+      "count": 1
+    }
+  ]
+}
+```
+
+�端补契约�，派�看�建议�按现有字段展示：
+
+- 整体行程日期：`startDate ~ endDate`
+- 需求车型 chip：`requiredVehicles[].categoryLabel + seats + count`
+- 已派车辆：`currentVehicleModel / currentVehicleSeats / currentVehiclePlate`
+
+## 4. 验收�径
+
+- 用车需求弹窗车型下拉数��自 `GET /admin/fleet/vehicle-types` 的 `models[]`，��用写死选项。
+- 下拉能展示实际型��和座�数，例如 `丰田普拉多 · 7座`。
+- �端�把 `modelName` 直接�交到旧的 `fleet[].vehicleType`。
+- 派�看��基于 `requiredVehicles` ��数组硬推“�几天/�几天�的车型分段。
+- 若�展示车型分段，等�端补明确的分段字段��接。
+