From ed8448c625dbc87b9b83ffc84555d06158bd569d Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sun, 5 Jul 2026 20:35:20 +0800
Subject: [PATCH] docs(fleet): add menu api validation handoff

---
 ...¦åŠ¡è�œå�•å…¨æŽ¥å�£éªŒæ”¶ä¸Žå‰�端契约收å�£-管ç�†å�Žå�°.md | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 changelogs-v2/2026-07/25_4756_车务��全接�验收与�端契约收�-管���.md

diff --git a/changelogs-v2/2026-07/25_4756_车务��全接�验收与�端契约收�-管���.md b/changelogs-v2/2026-07/25_4756_车务��全接�验收与�端契约收�-管���.md
new file mode 100644
index 0000000..96a8f45
--- /dev/null
+++ b/changelogs-v2/2026-07/25_4756_车务��全接�验收与�端契约收�-管���.md
@@ -0,0 +1,63 @@
+# ��端对接·管���】车务��全接�验收与契约收�
+
+> **Issue**: [wx/HL#4756](https://git.1814.love:8443/wx/HL/issues/4756)  
+> **PR**: [wx/HL#4757](https://git.1814.love:8443/wx/HL/pulls/4757), [wx/HL#4758](https://git.1814.love:8443/wx/HL/pulls/4758)  
+> **�务**: hl-fleet-service + hl-order-service-v3  
+> **日期**: 2026-07-05  
+> **影�范围**: 管���车务管�全��
+
+---
+
+## 1. 结论
+
+- 测试�已完�真实 API 回归：车务��级 `23/23` 通过，覆盖��端点 `76` 个。
+- 补充全链路回归 `31/31` 通过，多订�并�回归 `10/10` 通过。
+- 已修�派���确认返回 `100000` 的问题，现在返回业务� `605020 当�派�状���许此�作`。
+- `/admin/fleet/**` 已按当�登录角色拦截：车务角色�访问，定制师角色会返回 `403`。
+
+---
+
+## 2. �端必须处�
+
+| 场景 | �端处� |
+|------|----------|
+| 当�角色 | 车务���能由 `VEHICLE_MANAGER` 或 `SUPER_ADMIN` 访问；`wx/CUSTOMIZER` 访问 `/admin/fleet/**` 返回 `403`，�示切�车务角色。 |
+| �机结算方� | �机新增/编辑/导入使用字典 `driver_settlement_mode`：`direct`=直接结算，`fleet_leader`=车队长结算。 |
+| 待审核详情 ID | `GET /admin/fleet/drivers/pending/{pendingId}` �应主键字段是 `id`，�是 `pendingId`；路径���� `pendingId`。 |
+| 派���确认 | `POST /admin/fleet/assignments/{assignmentId}/confirm` ��许 `holding -> assigned`；� `holding` 返回 `605020`。 |
+| �消���作 | 终�派��次�消也返回 `605020`。 |
+| 快速连点 | 多个写接�有幂等�护，会返回 `100502`，�端按钮需� loading/disabled。��把 `100502` 当系统故障。 |
+| 价格日历多车型批�设价 | `PUT /admin/fleet/pricing-calendar/batch-set` 幂等窗�是 300 秒，�一批完全相�入�会返回 `100502`。 |
+| 价格日历删除 | `DELETE /admin/fleet/pricing-calendar/{vehicleModelId}` 使用 query �数 `startDate`�`endDate`，��放 body。 |
+| 车型树字段 | `GET /admin/fleet/vehicle-types` 大类和车型主键都读 `id`；��读旧的 `typeId`。 |
+| 看� summary | 使用 `pendingUrgentCount`�`holdingTimeoutCount`；��自造旧字段。 |
+| 车辆 busy | 车辆新增/编辑�能人工写 `vehicleStatus=busy`，返回 `600112`；busy �能由派��用�算。 |
+| 常驻�机冲� | 车辆指定常驻�机时，�机已被别车�用返回 `605022`；�机侧改绑目标车已被�用返回 `605023`。 |
+| 自带车审核 | H5 自带车 `regCertUsage` 为��类时必须带 `operationLicenseUrls`。 |
+
+---
+
+## 3. 本次确认的��覆盖
+
+| �� | 关键接� |
+|------|----------|
+| 派�看� | `/admin/fleet/board/summary`, `/orders`, `/orders/{orderId}`, `/timeline`, `/expiry`, `/assignments/**` |
+| 矩阵派� | `/admin/fleet/matrix/grid`, `/unassigned-orders`, `/day-orders` |
+| 车队对账 | `/admin/fleet/reconciliation/cars`, `/insurance`, `/periods`, `/actual`, `/close`, `/reopen`, `/pending-compensations/**`, `/export/cars` |
+| 价格日历 | `/admin/fleet/pricing-calendar/overview`, `/{vehicleModelId}`, `/{vehicleModelId}/status`, `/batch-set` |
+| 车辆档案 | `/admin/fleet/vehicles/page`, `/{vehicleId}`, `/{vehicleId}/disable`, `/{vehicleId}/enable`, `/import`, `/import/template` |
+| 车型管�库 | `/admin/fleet/vehicle-types`, `/list`, `/page`, `/models/page`, `/{typeId}`, `/{typeId}/models`, `/models/{modelId}` |
+| �机档案 | `/admin/fleet/drivers/page`, `/options`, `/{driverId}`, `/{driverId}/resident-vehicle`, `/{driverId}/blacklist`, `/{driverId}/unban`, `/batch-season-renew`, `/import`, `/import/template` |
+| 待审核/自助录入 | `/admin/fleet/drivers/pending/**`, `/admin/fleet/h5/token`, `/h5/tokens/**`, `/app/h5/driver-onboard/**` |
+| 车管模� | `/admin/fleet/message-templates/**` |
+
+---
+
+## 4. 验���
+
+- ��级真实 API：`23/23` 通过，订� `HL20260705203149299`，覆盖 76 个��端点。
+- 全链路真实 API：`31/31` 通过，订� `HL20260705203226195`。
+- 多订�并�：`10/10` 通过，真实创建 3 个订�，仅 1 �派��功，其余按 `605001` 冲�返回。
+- 本地�端验�：
+  - `mvn -pl hl-fleet-service -am "-Dtest=AssignmentServiceTest,FleetAdminRoleGuardInterceptorTest" -DfailIfNoTests=false test` 通过，69 tests。
+  - `mvn -pl hl-fleet-service spotless:check` 通过。