From a9fafb8a146969765f36a25691ea2bfbc7f572de Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sat, 18 Jul 2026 11:43:16 +0800
Subject: [PATCH] =?UTF-8?q?docs(fleet):=20=E5=8F=91=E5=B8=83=E8=BD=A6?=
 =?UTF-8?q?=E5=8A=A1=E8=AF=BB=E6=A8=A1=E5=9E=8B=E5=89=8D=E7=AB=AF=E5=A5=91?=
 =?UTF-8?q?=E7=BA=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¦åŠ¡çœ‹æ�¿è¯¦æƒ…候选与矩阵读模型统一-管ç�†å�Žå�°.md | 775 ++++++++++++++++++
 1 file changed, 775 insertions(+)
 create mode 100644 changelogs-v2/2026-07/60_4936_车务看�详情候选与矩阵读模型统一-管���.md

diff --git a/changelogs-v2/2026-07/60_4936_车务看�详情候选与矩阵读模型统一-管���.md b/changelogs-v2/2026-07/60_4936_车务看�详情候选与矩阵读模型统一-管���.md
new file mode 100644
index 0000000..73a4598
--- /dev/null
+++ b/changelogs-v2/2026-07/60_4936_车务看�详情候选与矩阵读模型统一-管���.md
@@ -0,0 +1,775 @@
+# ��端对接·管���】车务看��详情�候选与矩阵读模型统一
+
+> Issue: [wx/HL#4936](https://git.1814.love:8443/wx/HL/issues/4936)
+>
+> PR: [wx/HL#5031](https://git.1814.love:8443/wx/HL/pulls/5031)�[wx/HL#5032](https://git.1814.love:8443/wx/HL/pulls/5032)�[wx/HL#5034](https://git.1814.love:8443/wx/HL/pulls/5034)
+>
+> �务: `hl-fleet-service` / `hl-order-service-v3`
+>
+> 日期: 2026-07-18
+>
+> 影�范围: 车务派�看�汇总与列表�派�详情�车辆/�机候选�矩阵月视图�相邻订�衔接风险
+
+## 一�对接结论
+
+1. 派�看�继续使用分页接�，`pageSize` 最大 100；没有新增“�分页全�接��。
+2. `/summary` 与 `/orders` 共用日期�车型��机��系人�团��定制师和 `keyword` 筛选；汇总忽略 `status/statuses/page/pageSize`，返回�一筛选范围内的全部状�分�。`pendingCount/pendingUrgentCount/todayDepartCount/holdingTimeoutCount` �样�这些订�筛选�化；`idleVehicleCount/idleDriverCount` 是��订�筛选�化的全局资�指标。
+3. 派�列表�详情和矩阵�以**当�订� + 当�有效用车需求 + 当�有效派车组**为准，历�需求和历�派��能覆盖当�数�。
+4. 详情一次返回�日行程�大交通�当�需求�全部有效派车组�生命周期�凭�和�作记录。
+5. 候选车辆和�机分别分页，�许先选车或先选�机；返回完整闭区间�用时间窗�结构化�用性原因�冲�和常驻关系。
+6. 矩阵按整月查询，但�一跨月派车组先补�完整组��剪显示；�会因�查到月内一天而丢失真实起止日期。
+7. 矩阵相邻订�衔接风险由�端返回 `status/statusLabel/style/reasonCode/reasonMessage`，�端�得自行根�颜色或时间�新推导。
+8. **大交通�许�填写。** 无大交通时���交用车需求�查询候选�预检和派车；�端�能显示�示，�得�用派车按钮。
+9. 所有雪花 ID �按字符串处�，�止转为 JavaScript `Number`。
+10. 本次未修改 `hl-ui`，�端�按本文完�接�对接。
+
+## 二�接�清�
+
+| # | 接� | 方法 | 路径 | 用途 |
+|---|---|---|---|---|
+| 1 | 看�汇总 | GET | `/admin/fleet/board/summary` | �筛选状�计数�急�数�资�数�定制师选项 |
+| 2 | 看�列表 | GET | `/admin/fleet/board/orders` | 分页�片�统一筛选�当�状�和�作能力 |
+| 3 | 看�详情 | GET | `/admin/fleet/board/orders/{orderId}` | 当�订��当�需求�行程�大交通�派车组和日志 |
+| 4 | 出行人脱�列表 | GET | `/admin/fleet/board/orders/{orderId}/travelers` | 默认脱�查看出行人 |
+| 5 | 出行人明文查询 | POST | `/admin/fleet/board/orders/{orderId}/travelers/plain` | 有��且有审计�由时查看明文 |
+| 6 | 派�候选 | POST | `/admin/fleet/assignments/candidates` | 车辆和�机独立分页�冲���用时间窗�常驻关系 |
+| 7 | 矩阵月视图 | GET | `/admin/fleet/matrix/grid` | 车辆月历�派车段�并行车辆�大交通和衔接风险 |
+
+## 三�看�汇总与列表公共筛选
+
+### 3.1 查询�数
+
+| �数 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `statuses` | `string[]` | � | 多状�任一命中；支��� query �数或逗�分隔。 |
+| `status` | `string` | � | �状�/逗�分隔别�，与 `statuses` �并。 |
+| `startDayFrom` | `date` | � | 日期区间起，与当�行程闭区间���匹�。 |
+| `startDate` | `date` | � | `startDayFrom` 别�；�者未传时生效。 |
+| `startDayTo` | `date` | � | 日期区间止，与当�行程闭区间���匹�。 |
+| `endDate` | `date` | � | `startDayTo` 别�；�者未传时生效。 |
+| `vehicleTypeKeys` | `string[]` | � | 车型大类：`suv/mpv/bus/sedan`，任一命中。 |
+| `typeKeys` | `string[]` | � | `vehicleTypeKeys` 别�。 |
+| `driverName` | `string` | � | 当��机姓�模糊匹�。 |
+| `keyword` | `string` | � | �机��系人/客户�团��订���当�负责定制师展示�任一包��命中。定制师展示�为�业微信昵称优先�用户�兜底；order-v3 �级时回退派�快照，�匹��端最终解�出的一个展示�。 |
+| `contactName` | `string` | � | �系人/客户�模糊匹�。 |
+| `contactKeyword` | `string` | � | `contactName` 别�。 |
+| `teamNo` | `string` | � | 团�包�匹�，例如 `7218` �命中 `26-7218`。 |
+| `consultantId` | `string` | � | 当�负责定制师管�员 ID 精确匹�。 |
+| `plannerName` | `string` | � | 定制师显示�模糊匹�兼容�数。 |
+| `consultantName` | `string` | � | `plannerName` 别�。 |
+| `variant` | `string` | � | `list` 默认；`grid` 为兼容值，其他值返回�数错误。 |
+| `page` | `int` | 列表� | 默认 1；汇总忽略。 |
+| `pageSize` | `int` | 列表� | 默认 20�最大 100；汇总忽略。 |
+
+状�值：
+
+```text
+unassigned / unassigned_urgent / holding / holding_urgent /
+assigned / change_requested / completed / canceled
+```
+
+状��义由�端 `statusOptions` 返回。`holding` 是“车务已排车��机尚未完�确认链路�，�是“车务正在�览详情�。
+
+### 3.2 汇总请求示例
+
+```http
+GET /admin/fleet/board/summary?startDate=2026-07-01&endDate=2026-07-31&typeKeys=suv&keyword=王
+Authorization: Bearer <fleet-manager-token>
+```
+
+### 3.3 汇总�应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "pendingCount": 3,
+    "pendingUrgentCount": 1,
+    "todayDepartCount": 1,
+    "idleVehicleCount": 9,
+    "idleDriverCount": 5,
+    "holdingTimeoutCount": 1,
+    "statusCounts": {
+      "unassigned": 3,
+      "holding": 1,
+      "assigned": 2,
+      "changeRequested": 0,
+      "completed": 4,
+      "canceled": 1,
+      "unassignedUrgent": 1,
+      "holdingUrgent": 1
+    },
+    "statusOptions": [
+      {
+        "value": "unassigned",
+        "label": "待派车",
+        "count": 3,
+        "urgentCount": 1
+      },
+      {
+        "value": "holding",
+        "label": "排车中",
+        "count": 1,
+        "urgentCount": 1
+      },
+      {
+        "value": "assigned",
+        "label": "已派车",
+        "count": 2,
+        "urgentCount": 0
+      }
+    ],
+    "consultantOptions": [
+      {
+        "value": "2000000000000000001",
+        "label": "�业微信昵称"
+      }
+    ]
+  }
+}
+```
+
+一致性规则：
+
+```text
+�一组�状�筛选�件下：
+summary.statusOptions[value=X].count
+  == orders?statuses=X 返回的 data.total
+```
+
+`idleVehicleCount/idleDriverCount` 是当�物�资�指标，��订�文字筛选影�；其他订�状�计数使用�一筛选�的记录集。
+
+### 3.4 列表请求示例
+
+```http
+GET /admin/fleet/board/orders?page=1&pageSize=20&statuses=unassigned,holding&keyword=7218&consultantId=2000000000000000001
+Authorization: Bearer <fleet-manager-token>
+```
+
+### 3.5 列表�应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "page": 1,
+    "pageSize": 20,
+    "total": 1,
+    "records": [
+      {
+        "id": "HL202607180001",
+        "orderNo": "HL202607180001",
+        "orderId": "2000000000000000101",
+        "teamNo": "26-7218",
+        "assignmentId": "2000000000000000201",
+        "assignmentGroupId": "2000000000000000201",
+        "fleetItemIndex": 0,
+        "customerName": "测试�系人",
+        "contactName": "测试�系人",
+        "productName": "测试产�",
+        "headcount": 4,
+        "adultCount": 3,
+        "childCount": 1,
+        "youngChildCount": 0,
+        "babyCount": 0,
+        "startDate": "2026-07-20",
+        "endDate": "2026-07-22",
+        "days": 3,
+        "pickupAt": null,
+        "dropoffAt": null,
+        "isHailarPickup": false,
+        "isHailarDropoff": false,
+        "consultantId": "2000000000000000001",
+        "plannerName": "�业微信昵称",
+        "consultantName": "�业微信昵称",
+        "consultantDisplayName": "�业微信昵称",
+        "specialTags": ["中文�机", "大行�空间"],
+        "requirementRemark": "无大交通，按行程安排车辆",
+        "requiredVehicles": [
+          {
+            "vehicleType": "suv",
+            "categoryLabel": "SUV系列",
+            "seats": 7,
+            "count": 1
+          }
+        ],
+        "assignmentStatus": "unassigned",
+        "assignmentStatusLabel": "待派车",
+        "lifecycleStageCode": "requirement_pending",
+        "lifecycleStageLabel": "待车务派车",
+        "currentStep": 1,
+        "availableActionCodes": ["ASSIGN", "REJECT_REQUIREMENT"],
+        "urgentBadge": null,
+        "canAssign": true,
+        "canRejectRequirement": true
+      }
+    ]
+  }
+}
+```
+
+### 3.6 列表字段绑定规则
+
+| 字段 | �端规则 |
+|---|---|
+| `teamNo` | 展示当�团�；空值�回退拼造。 |
+| `contactName` | �片�系人。 |
+| `consultantDisplayName` | 定制师展示�，�业微信昵称优先�用户�兜底。 |
+| `startDate/endDate/days` | 当�订�档期，闭区间�首尾。 |
+| `specialTags/requirementRemark` | 当�有效用车需求，�得混入历�需求。 |
+| `assignmentStatusLabel/lifecycleStageLabel` | 直接展示，�端�维护独立中文映射。 |
+| `availableActionCodes/canAssign/canRejectRequirement` | 决定�作入�；急�样��得��按钮。 |
+
+列表按派车组��；底层一天一�派车切片�会把�一派车组���多张�片。紧急待处�在��普通进行中次之�终�沉底，�优先级以稳定 ID 兜底；�端�得二次排�。
+
+## 四�派�详情
+
+### 4.1 请求
+
+```http
+GET /admin/fleet/board/orders/2000000000000000101
+Authorization: Bearer <fleet-manager-token>
+```
+
+路径�数是数字订� ID，按字符串传递，�是订��。
+
+### 4.2 �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "id": "HL202607180001",
+    "orderNo": "HL202607180001",
+    "teamNo": "26-7218",
+    "customerName": "测试�系人",
+    "headcount": 4,
+    "adultCount": 3,
+    "childCount": 1,
+    "youngChildCount": 0,
+    "babyCount": 0,
+    "startDate": "2026-07-20",
+    "endDate": "2026-07-22",
+    "pickupAt": null,
+    "dropoffAt": null,
+    "productName": "测试产�",
+    "consultantId": "2000000000000000001",
+    "plannerName": "�业微信昵称",
+    "consultantName": "�业微信昵称",
+    "consultantDisplayName": "�业微信昵称",
+    "specialTags": ["中文�机", "大行�空间"],
+    "requirementRemark": "无大交通，按行程安排车辆",
+    "itinerary": {
+      "theme": "�原三日",
+      "route": "海拉尔 → �尔�纳 → 满洲里",
+      "days": [
+        {
+          "dayNumber": 1,
+          "date": "2026-07-20",
+          "title": "抵达海拉尔",
+          "detail": "市区行程"
+        },
+        {
+          "dayNumber": 2,
+          "date": "2026-07-21",
+          "title": "�尔�纳",
+          "detail": "�原行程"
+        },
+        {
+          "dayNumber": 3,
+          "date": "2026-07-22",
+          "title": "满洲里",
+          "detail": "返程"
+        }
+      ]
+    },
+    "transport": {
+      "transferTimeHint": "暂无接�机时间",
+      "arrive": null,
+      "depart": null,
+      "batches": [],
+      "pickupRequired": null
+    },
+    "currentAssignment": {
+      "id": "2000000000000000201",
+      "assignmentGroupId": "2000000000000000201",
+      "fleetItemIndex": 0,
+      "requiredVehicleType": "suv",
+      "requiredSeats": 7,
+      "startDate": "2026-07-20",
+      "endDate": "2026-07-22",
+      "vehicleId": "2000000000000000301",
+      "vehiclePlate": "蒙A·TEST1",
+      "driverId": "2000000000000000401",
+      "driverName": "测试�机",
+      "baseAssignmentStatus": "assigned",
+      "assignmentStatus": "assigned",
+      "lifecycleStageCode": "confirmed",
+      "lifecycleStageLabel": "已确认执行",
+      "currentStep": 4,
+      "availableActionCodes": ["CANCEL", "CHANGE_DRIVER", "COMPLETE_EARLY"],
+      "protocolPrice": "1300.00",
+      "driverConfirmationEvidenceFileIds": []
+    },
+    "activeAssignments": [
+      {
+        "assignmentGroupId": "2000000000000000201",
+        "fleetItemIndex": 0,
+        "startDate": "2026-07-20",
+        "endDate": "2026-07-22",
+        "vehiclePlate": "蒙A·TEST1",
+        "driverName": "测试�机",
+        "assignmentStatus": "assigned"
+      }
+    ],
+    "operationLog": {
+      "records": [],
+      "total": 0,
+      "summary": {"totalCount": 0}
+    },
+    "relatedDetailReady": true
+  }
+}
+```
+
+### 4.3 当�需求和派车组隔离
+
+- `currentAssignment` 是最新一个有效派车组的兼容字段。
+- `activeAssignments` �是当�需求下全部有效派车组；一�多车时必须渲染完整数组。
+- 历�需求�已�消组和旧订�快照�能进入当�需求详情。
+- `baseAssignmentStatus` 是�库基础�；`assignmentStatus` 是当�有效状�，�端展示�者。
+
+### 4.4 �日行程规则
+
+- `itinerary.days` �自 `order_itinerary_day`，一天一�事实数�。
+- 返回日期必须�于当� `[startDate,endDate]`，按 `dayNumber` 稳定排�。
+- 改期�按当�订�档期对�；越界�旧版本和�法日�数��返回。
+- 无有效行程时返回 `days=[]`，�端显示空�，�得生��行程。
+
+### 4.5 大交通规则
+
+有数�时：
+
+- 到达接客使用大交通 `arriveTime`。
+- 返程�客使用大交通 `departTime`。
+- 分批接�完整返回 `batches`。
+
+无数�时固定返回：
+
+```json
+{
+  "transport": {
+    "transferTimeHint": "暂无接�机时间",
+    "arrive": null,
+    "depart": null,
+    "batches": [],
+    "pickupRequired": null
+  }
+}
+```
+
+**空大交通是正常业务状�，�是�数错误，也�是派车阻断�件。** `pickupAt/dropoffAt` �样�许为 `null`。
+
+## 五�车辆与�机候选
+
+### 5.1 请求
+
+```http
+POST /admin/fleet/assignments/candidates
+Authorization: Bearer <fleet-manager-token>
+Content-Type: application/json
+```
+
+```json
+{
+  "orderId": "2000000000000000101",
+  "requirementId": "2000000000000000501",
+  "fleetItemIndex": 0,
+  "startDate": "2026-07-20",
+  "endDate": "2026-07-22",
+  "headcount": 4,
+  "selectedVehicleId": null,
+  "selectedDriverId": null,
+  "excludeAssignmentId": null,
+  "vehicleKeyword": "GL8",
+  "driverKeyword": "å¼ ",
+  "vehiclePage": 1,
+  "vehiclePageSize": 20,
+  "driverPage": 1,
+  "driverPageSize": 20
+}
+```
+
+`pickupAt/dropoffAt` 未出现是�法请求；有城市信�时��外传入，供城市衔接判断使用。
+
+### 5.2 请求�数
+
+| �数 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `orderId` | `string` | 改派时是 | 当�订� ID。 |
+| `requirementId` | `string` | 改派时是 | 当�有效用车需求 ID。 |
+| `fleetItemIndex` | `int` | � | 当�车型项��，从 0 开始。 |
+| `startDate/endDate` | `date` | 是 | 请求用车闭区间。 |
+| `pickupAt/dropoffAt` | `string` | � | 城市衔接辅助信�；空值�阻断候选和派车。 |
+| `headcount` | `int` | � | 乘客人数，���机。车辆乘客容�=`seats-1`。 |
+| `selectedVehicleId` | `string` | � | 已选车辆，支�先选车。 |
+| `selectedDriverId` | `string` | � | 已选�机，支�先选�机。 |
+| `excludeAssignmentId` | `string` | � | 改派时排除当�派�，且必须属于当�订�和需求。 |
+| `vehicleKeyword` | `string` | � | 车牌或车型。 |
+| `driverKeyword` | `string` | � | �机姓�或完整手机�。 |
+| `vehiclePage/driverPage` | `int` | 是 | �自分页页�，默认 1。 |
+| `vehiclePageSize/driverPageSize` | `int` | 是 | �自�页�数，最大 100。 |
+
+### 5.3 �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "vehicles": {
+      "records": [
+        {
+          "vehicleId": "2000000000000000301",
+          "plate": "蒙A·TEST1",
+          "modelName": "测试车型",
+          "seats": 7,
+          "passengerCapacity": 6,
+          "seatsEnough": true,
+          "fleet": "own",
+          "selected": false,
+          "available": true,
+          "availabilityReasonCode": "AVAILABLE",
+          "availabilityReasonMessage": "所选�务日期内�用",
+          "availabilityWindows": [
+            {"startDate": "2026-07-20", "endDate": "2026-07-22"}
+          ],
+          "residentMatch": false,
+          "crossResident": false,
+          "requiresCrossResidentConfirmation": false,
+          "relationMessage": null,
+          "conflicts": []
+        }
+      ],
+      "total": 1,
+      "page": 1,
+      "pageSize": 20
+    },
+    "drivers": {
+      "records": [
+        {
+          "driverId": "2000000000000000401",
+          "name": "测试�机",
+          "maskedPhone": "138****0000",
+          "years": 8,
+          "season": "active",
+          "completedOrderCount": 12,
+          "rating": 5.0,
+          "ratingDefaulted": true,
+          "selected": false,
+          "available": true,
+          "availabilityReasonCode": "CITY_JUNCTION_SHAREABLE",
+          "availabilityReasonMessage": "仅存在�衔接的�城边界�用",
+          "availabilityWindows": [
+            {"startDate": "2026-07-20", "endDate": "2026-07-22"}
+          ],
+          "residentMatch": false,
+          "crossResident": false,
+          "requiresCrossResidentConfirmation": false,
+          "conflicts": []
+        }
+      ],
+      "total": 1,
+      "page": 1,
+      "pageSize": 20
+    },
+    "selectedRelation": null
+  }
+}
+```
+
+### 5.4 候选判定规则
+
+| `availabilityReasonCode` | �义 | `available` |
+|---|---|---|
+| `AVAILABLE` | 整个请求闭区间无阻塞�用 | `true` |
+| `CITY_JUNCTION_SHAREABLE` | �有满足规则的城市边界衔接 | `true` |
+| `ASSIGNMENT_CONFLICT` | 请求区间内存在阻塞派� | `false` |
+
+- `availabilityWindows` 是请求区间内的实际�用**闭区间**，冲�会切分时间窗。
+- 车辆和�机都必须覆盖完整请求区间��直接选中。
+- �机无评价时返回 `rating=5.0` 且 `ratingDefaulted=true`；有真实评价时为 `false`。
+- 车辆总座�数包��机，`passengerCapacity=seats-1`；�端�得把�机座��次给乘客。
+- `selectedRelation` 在车辆和�机都已选时返回常驻关系。跨常驻组�必须显示�端�示并显�确认。
+
+## 六�矩阵月视图
+
+### 6.1 请求
+
+```http
+GET /admin/fleet/matrix/grid?year=2026&month=7&season=active&fleets=own,coopA&typeKeys=suv&status=all
+Authorization: Bearer <fleet-manager-token>
+```
+
+### 6.2 请求�数
+
+| �数 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `year` | `int` | 是 | 查询年份。 |
+| `month` | `int` | 是 | 1-12，越界返回车务月份错误。 |
+| `season` | `string` | � | `active` 默认；也支� `pending/archived/blacklist`。 |
+| `fleets` | `string[]` | � | `own/coopA/coopB` 多选。 |
+| `typeKeys` | `string[]` | � | `suv/mpv/bus/sedan` 多选。 |
+| `status` | `string` | � | `all` 默认�`unassigned`�`assigned`。 |
+
+### 6.3 �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "year": 2026,
+    "month": 7,
+    "daysInMonth": 31,
+    "todayDay": 18,
+    "weekendDays": [4, 5, 11, 12, 18, 19, 25, 26],
+    "fleetCount": {"own": 5, "coopA": 4, "coopB": 3},
+    "statusCounts": {
+      "totalAssignments": 21,
+      "unassignedAssignments": 10,
+      "assignedAssignments": 11,
+      "totalOrders": 16,
+      "unassignedOrders": 5,
+      "partialOrders": 2,
+      "assignedOrders": 11
+    },
+    "unassignedWindowCount": 5,
+    "vehicles": [
+      {
+        "id": "2000000000000000301",
+        "plate": "蒙A·TEST1",
+        "modelName": "测试车型",
+        "seats": 7,
+        "fleet": "own",
+        "primaryDriverName": "测试�机",
+        "primaryDriverPhone": "138****0000",
+        "assignments": [
+          {
+            "id": "2000000000000000201",
+            "assignmentGroupId": "2000000000000000201",
+            "orderNumericId": "2000000000000000101",
+            "orderNo": "HL202607180001",
+            "teamNo": "26-7218",
+            "consultantId": "2000000000000000001",
+            "consultantName": "�业微信昵称",
+            "customerName": "测试�系人",
+            "headcount": 4,
+            "adultCount": 3,
+            "childCount": 1,
+            "startDay": 20,
+            "endDay": 22,
+            "startDate": "2026-07-20",
+            "endDate": "2026-07-22",
+            "clippedHead": false,
+            "clippedTail": false,
+            "vehicleCategory": "suv",
+            "categoryLabel": "SUV系列",
+            "assignmentStatus": "assigned",
+            "protocolPrice": "1300.00",
+            "vehicleSpecialTags": ["中文�机"],
+            "vehicleRequirementRemark": "按行程安排",
+            "pickupTransports": [],
+            "dropoffTransports": [],
+            "parallelAssignments": [
+              {
+                "assignmentGroupId": "2000000000000000201",
+                "fleetItemIndex": 0,
+                "vehicleCategory": "suv",
+                "categoryLabel": "SUV系列",
+                "requiredSeats": 7,
+                "startDate": "2026-07-20",
+                "endDate": "2026-07-22",
+                "vehicleId": "2000000000000000301",
+                "vehiclePlate": "蒙A·TEST1",
+                "driverId": "2000000000000000401",
+                "driverName": "测试�机",
+                "assignmentStatus": "assigned",
+                "protocolPrice": "1300.00"
+              }
+            ]
+          }
+        ],
+        "connections": [
+          {
+            "fromAssignmentGroupId": "2000000000000000201",
+            "toAssignmentGroupId": "2000000000000000202",
+            "fromEndDate": "2026-07-22",
+            "toStartDate": "2026-07-23",
+            "previousDepartureTime": null,
+            "nextArrivalTime": null,
+            "previousCity": null,
+            "nextCity": null,
+            "connectionMinutes": null,
+            "thresholdMinutes": 120,
+            "status": "MISSING_TIME",
+            "statusLabel": "缺少接�时间",
+            "style": "RED_DASHED",
+            "reasonCode": "PREVIOUS_REQUIRED_DEPARTURE_MISSING",
+            "reasonMessage": "�一订�缺少必需�客批次"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### 6.4 派�统计�径
+
+- `totalAssignments` 是派车行数，�是订�数。
+- `totalOrders` 是去�订�数。
+- 一��时存在已派和未派项时计入 `partialOrders`，也计入 `unassignedOrders`。
+- `unassignedWindowCount` 是�未派项的去�订�数，�等于未派�日切片�数。
+- 跨月派车组使用完整原始 `startDate/endDate`，仅 `startDay/endDay` �剪到当�月；`clippedHead/clippedTail` 告诉�端是�跨月续接。
+
+### 6.5 相邻订�衔接四�
+
+| `status` | `style` | �义 |
+|---|---|---|
+| `MISSING_TIME` | `RED_DASHED` | 缺少必需大交通�时刻或城市，无法完�衔接判断。 |
+| `DIFFERENT_CITY` | `DARK_RED` | ��订�城市��。 |
+| `SAME_CITY_TOO_SHORT` | `LIGHT_RED` | �城但间隔�于�置阈值。 |
+| `SAME_CITY_OK` | `GREEN` | �城且间隔达到�置阈值。 |
+
+原因�：
+
+```text
+PREVIOUS_REQUIRED_DEPARTURE_MISSING
+NEXT_REQUIRED_ARRIVAL_MISSING
+PREVIOUS_DEPARTURE_TIME_MISSING
+NEXT_ARRIVAL_TIME_MISSING
+PREVIOUS_DEPARTURE_CITY_MISSING
+NEXT_ARRIVAL_CITY_MISSING
+DIFFERENT_CITY
+SAME_CITY_INTERVAL_TOO_SHORT
+SAME_CITY_INTERVAL_SUFFICIENT
+```
+
+�城最�衔接阈值读� Nacos �置，默认 120 分钟；�好等于阈值属于 `SAME_CITY_OK`。
+
+注�：`MISSING_TIME` 是矩阵风险�示，�表示订��能派车。用户未填写大交通时��许完�派车。
+
+## 七�出行人��与审计
+
+### 7.1 脱�列表
+
+```http
+GET /admin/fleet/board/orders/2000000000000000101/travelers
+Authorization: Bearer <fleet-manager-token>
+```
+
+默认返回姓��年龄类型和脱��件/手机�；�端日常派车�使用此接�。
+
+### 7.2 明文查询
+
+```http
+POST /admin/fleet/board/orders/2000000000000000101/travelers/plain
+Authorization: Bearer <fleet-manager-token>
+Content-Type: application/json
+```
+
+```json
+{
+  "reason": "�机出��核对接客人信�"
+}
+```
+
+明文接�必须�过��校验并记录�作人�订���由和时间。�端�得缓存�日志打�或二次�久化明文个人信�。
+
+## 八��端必须处�
+
+1. 看�使用分页接�，分页器读� `data.total/page/pageSize`。
+2. 状�项�状�中文�急�数读� `summary.statusOptions`，�维护独立枚举和独立计数。
+3. 汇总请求必须�带与列表相�的�状�筛选；��把当�状�筛选传�汇总统计范围。
+4. �片展示 `teamNo/contactName/headcount/consultantDisplayName/startDate/endDate/specialTags/requirementRemark`。
+5. 定制师选择值传 `consultantId`；显示使用�端返回的�业微信优先�称。
+6. 统一文本框传 `keyword`，��时匹��机��系人�团��订��和当�定制师展示�；定制师按�业微信昵称优先�用户�兜底，�端�得自行并行匹�多个�称别�。
+7. �作按钮使用 `availableActionCodes/canAssign/canRejectRequirement`，�能按颜色或�端状�猜测。
+8. 详情多车读� `activeAssignments`；`currentAssignment` �是兼容的最新一组。
+9. `transport.transferTimeHint="暂无接�机时间"` 时显示�示，但��派车入��用。
+10. 候选资�分别读� `vehicles/drivers` 分页；显示�端原因和常驻关系�示。
+11. 矩阵直接使用 `connections[].status/style/reasonCode/reasonMessage`；大红�淡红�虚线红和绿色语义�能自行交�。
+12. 所有雪花 ID 当字符串处�。
+
+## ��兼容性与�影�范围
+
+- �留 `status/startDate/endDate/typeKeys/contactKeyword/consultantName` 等兼容别�。
+- �新增�端内部接�，�改�现有派车写接�。
+- ��求填写大交通，也�把空大交通改�校验错误。
+- �改�“一天一�派车切片�的数�库事实模型；本轮�修正读模型��。
+- �处�团期�车。
+- �修改 `hl-ui`。
+
+## ��验���
+
+### 10.1 代�与测试
+
+```text
+hl-fleet-service 定�测试：253/253 通过
+hl-fleet-service 全� verify：1799/1799 通过
+hl-order-service-v3 相关契约测试：30/30 通过
+独立代�评审：无 P0/P1 阻断项
+OpenAPI 说明定�校验：spotless:check + compile 通过
+```
+
+Order-v3 全�测试中 4 项环境/基线失败已在��交干净基线�现：3 项为 H2 缺少 `payment_manual_receipt`，1 项为既有本地缓存架构门�；�由本次车务改动引入。
+
+### 10.2 部署
+
+```text
+hl-order-service-v3：Deploy Panel 任务 22ec81e8，8086/8186 �实例�功
+hl-fleet-service：Deploy Panel 任务 68487f94，8087/8187 �实例�功
+hl-fleet-service OpenAPI �径补充：Deploy Panel 任务 249594e3，8087/8187 �实例�功
+```
+
+部署�已通过网关读�车务 OpenAPI，确认线上文档明确区分“�一订�筛选范围内的状�计数�与“��订�筛选�化的全局空闲资�数�，并包�统一关键�对当�定制师展示�的匹�规则。
+
+### 10.3 真实网关 API
+
+使用独立车务和定制师测试账�，� `https://api.test.1814.love:9443` 完�真实订�全�程回归；未使用 `admin`�`wx` 或 Mock 数�。
+
+```text
+最终回归：161/161 通过，失败 0
+覆盖：看�汇总/列表/详情�统一筛选�定制师�脱�/明文出行人�候选车辆/�机�
+      常驻与跨常驻�预检�派车��机确认��消/��/改派/��完结�矩阵�价格�
+      车辆/�机�对账�模�，以�无大交通订�完整派车链路。
+```
+
+无大交通真实场景�外断言：
+
+```text
+- 新建真实订�并补� 2 �出行人
+- �创建任何大交通计划
+- �功�交有效用车需求
+- 详情：arrive=null�depart=null�batches=[]�transferTimeHint=暂无接�机时间
+- 候选查询�功，pickupAt/dropoffAt ��略
+- 派车预检�功，conflict=false
+- 直派�功并进入已派车状�
+- DB：派车组�日 6 �，pickup_at/dropoff_at 6 ��为空
+```
+
+## �一�相关文档
+
+- 看�字段�统计�行程和�险事务：`57_4882_车务派�看�当�订�字段统计行程与�险事务收�-管���.md`
+- 需求级最终完�回调：`59_4935_车务需求级派�完�回调与滚动�布契约-管���.md`
+- �需求和派�基础契约：`53_4871_车务�需求派�看�闭环契约-管���.md`
+- 团�与定制师筛选：`54_4876_派�看�团�与定制师下拉筛选-管���.md`