From 2a878856b8254391efd2e53a4c338c1e4458acc2 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 8 Jul 2026 15:26:44 +0800
Subject: [PATCH] =?UTF-8?q?docs(fleet):=20=E6=B4=BE=E5=8D=95=E7=9C=8B?=
 =?UTF-8?q?=E6=9D=BF=E7=AD=9B=E9=80=89=E5=8F=82=E6=95=B0=E5=85=BC=E5=AE=B9?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...�•çœ‹æ�¿ç­›é€‰å�‚数兼容与定制师展示å��-管ç�†å�Žå�°.md | 152 ++++++++++++++++++
 1 file changed, 152 insertions(+)
 create mode 100644 changelogs-v2/2026-07/47_4845_派�看�筛选�数兼容与定制师展示�-管���.md

diff --git a/changelogs-v2/2026-07/47_4845_派�看�筛选�数兼容与定制师展示�-管���.md b/changelogs-v2/2026-07/47_4845_派�看�筛选�数兼容与定制师展示�-管���.md
new file mode 100644
index 0000000..ed5801d
--- /dev/null
+++ b/changelogs-v2/2026-07/47_4845_派�看�筛选�数兼容与定制师展示�-管���.md
@@ -0,0 +1,152 @@
+# ��端对接·管���】派�看�筛选�数兼容与定制师展示�
+
+> Issue: [wx/HL#4845](https://git.1814.love:8443/wx/HL/issues/4845)  
+> PR: [wx/HL#4849](https://git.1814.love:8443/wx/HL/pulls/4849)  
+> �务: `hl-fleet-service`  
+> 日期: 2026-07-08  
+> 影�范围: 车务派�看��派�详情�车务工作�摘�
+
+## 1. 结论
+
+- �端已兼容�端 v2.1 当�真实传�：`statuses/typeKeys/startDate/endDate/keyword`。
+- �字段��留：`vehicleTypeKeys/startDayFrom/startDayTo/driverName`，�端无需回改已有代�。
+- `statuses=unassigned` 会返回普通待派车和急待派车；`statuses=holding` 会返回普通�车中和�车中超时。
+- 精确派生����独传：`unassigned_urgent`�`holding_urgent`。
+- 派�列表和详情新增定制师展示字段：`consultantName`�`consultantDisplayName`；旧字段 `plannerName` ��。
+
+## 2. 派�看�列表
+
+```http
+GET /admin/fleet/board/orders
+Authorization: Bearer <token>
+```
+
+�端当�传�示例：
+
+```http
+GET /admin/fleet/board/orders?page=1&pageSize=10&statuses=unassigned&typeKeys=suv&startDate=2026-07-01&endDate=2026-07-31&keyword=王
+```
+
+兼容�数：
+
+| �端现用字段 | 旧字段 | 类型 | 说明 |
+|--------------|--------|------|------|
+| `statuses` | `statuses` | string[] | 状�多选，�� query key 传数组。 |
+| `status` | - | string | �值状�别�，也支�逗�分隔。 |
+| `typeKeys` | `vehicleTypeKeys` | string[] | 车型大类多选，`suv/mpv/bus/sedan`。 |
+| `startDate` | `startDayFrom` | date | 行程区间筛选起，未传旧字段时生效。 |
+| `endDate` | `startDayTo` | date | 行程区间筛选止，未传旧字段时生效。 |
+| `keyword` | `driverName` | string | �机姓�模糊�索，未传旧字段时生效。 |
+
+状�筛选�径：
+
+| 入� | 返回 |
+|------|------|
+| `unassigned` / `待派车` | `unassigned` + `unassigned_urgent` |
+| `unassigned_urgent` | 仅急待派车 |
+| `holding` / `�车中` | `holding` + `holding_urgent` |
+| `holding_urgent` | 仅�车中超时 |
+| `assigned` | 已派车 |
+| `change_requested` | �车请求 |
+| `canceled` | 已�消 |
+| `completed` | 已完结 |
+| `all` / 空 | �筛选状� |
+
+�应示例：
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "page": 1,
+    "pageSize": 10,
+    "total": 108,
+    "records": [
+      {
+        "id": "HL20260703142715457",
+        "orderId": "2074724409473458177",
+        "customerName": "�瑶",
+        "productName": "测试核心产�-�档-固定订金",
+        "headcount": 5,
+        "startDate": "2026-07-23",
+        "endDate": "2026-07-25",
+        "assignmentStatus": "unassigned_urgent",
+        "urgentBadge": "急",
+        "plannerName": "张三",
+        "consultantName": "张三",
+        "consultantDisplayName": "张三",
+        "customerNote": "需�接�机",
+        "requiredVehicles": [
+          {
+            "vehicleType": "suv",
+            "categoryLabel": "SUV",
+            "seats": 7,
+            "count": 1
+          }
+        ],
+        "unreadMessageCount": 0
+      }
+    ]
+  }
+}
+```
+
+�端处�建议：
+
+- 展示定制师优先读 `consultantDisplayName`，兼容回退 `consultantName || plannerName`。
+- 继续用当� `paramsSerializer: { indexes: null }`，数组�列化为 `statuses=unassigned&statuses=assigned`。
+- `statuses=unassigned` ��在�端�外补 `unassigned_urgent`，�端已�包�。
+
+## 3. 派�看�详情
+
+```http
+GET /admin/fleet/board/orders/2074724409473458177
+Authorization: Bearer <token>
+```
+
+新增字段与列表一致：
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "id": "HL20260703142715457",
+    "orderId": "2074724409473458177",
+    "customerName": "�瑶",
+    "plannerName": "张三",
+    "consultantName": "张三",
+    "consultantDisplayName": "张三",
+    "transport": {
+      "pickupRequired": true,
+      "batches": []
+    }
+  }
+}
+```
+
+说明：
+
+- 三个字段当��值，��是订�创建时的定制师展示�快照。
+- 展示����径是�微�优先；没有�微�时回退用户�。
+- `plannerName` 继续�留，��破�旧页�。
+
+## 4. 本次�端验�
+
+```bash
+mvn -pl hl-fleet-service -am -Dtest=BoardOrderServiceTest -DfailIfNoTests=false test
+mvn -pl hl-fleet-service spotless:check
+mvn -pl hl-fleet-service -am -DfailIfNoTests=false test
+mvn -pl hl-fleet-service -am verify
+```
+
+验�结果：
+
+- `BoardOrderServiceTest` 23 个用例通过。
+- `hl-fleet-service -am test` 通过。
+- `hl-fleet-service -am verify` 通过，1362 个测试�ArchUnit�Spotless 全部�功。
+- 覆盖点：�端别��数�基础�包�派生��`all` �筛选�车型大类别���机 `keyword`�定制师字段。
+