68c8d61f39
- 新增 GET /admin/order/{orderId}/itinerary/summary 聚合接口（PR #1064）
- 修复 GET /admin/order/{orderId} 的 hotelAssignmentDetails[].assignmentDate 现算（PR #1064）
- PUT /admin/order/{orderId}/vehicle-assignment 请求 body 删除 vehicleCount（PR #1054）
74 行
2.2 KiB
Markdown
74 行
2.2 KiB
Markdown
# 管理端配车接口下线 vehicleCount 字段 — 2026-04-21
|
||
|
||
> **服务** hl-order-service-v2（端口 8094）· **类型** refactor · **关联** Issue #1053 / PR #1054
|
||
> **破坏性变更**：请求 body 字段 `vehicleCount` 删除，前端不再传，后端固定写 1
|
||
|
||
---
|
||
|
||
## 一、影响接口
|
||
|
||
### ✏️ `PUT /admin/order/{orderId}/vehicle-assignment` — 分配车辆（管理端）
|
||
|
||
**请求参数变更**：`VehicleAssignmentReqVO` 移除 `vehicleCount` 字段。当前阶段每单车辆数固定为 1，后端直接写入，前端无需传递。
|
||
|
||
**变更对比**：
|
||
|
||
| 字段 | 状态 | 说明 |
|
||
| --- | --- | --- |
|
||
| ~~`vehicleCount`~~ | **已删除** | 前端传入将被忽略（JSON 未知字段不报错） |
|
||
|
||
**保留字段**：
|
||
|
||
| JSON 字段 | Java 字段 | 类型 | 必填 | 说明 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `vehicleModel` | `vehicleType` | `String` | ✅ ≤100 | 车型（`@JsonProperty("vehicleModel")` 对齐前端契约） |
|
||
| `plateNumber` | `plateNumber` | `String` | 否 ≤20 | 车牌号 |
|
||
| `driverName` | `driverName` | `String` | 否 ≤50 | 司机姓名 |
|
||
| `driverPhone` | `driverPhone` | `String` | 否 ≤20 | 司机电话 |
|
||
| `remark` | `remark` | `String` | 否 ≤500 | 备注 |
|
||
|
||
**新请求示例**：
|
||
|
||
```json
|
||
PUT /admin/order/700001/vehicle-assignment
|
||
{
|
||
"vehicleModel": "商务车",
|
||
"plateNumber": "京A12345",
|
||
"driverName": "张三",
|
||
"driverPhone": "13800000000",
|
||
"remark": ""
|
||
}
|
||
```
|
||
|
||
**返回值** `Result<Void>`（`code=200` 即成功）。
|
||
|
||
---
|
||
|
||
### ℹ️ `GET /admin/order/{orderId}/vehicle-assignment` — 查车辆分配（未变）
|
||
|
||
返回值 `VehicleAssignmentVO` 仍然包含 `vehicleCount` 字段（当前版本固定为 `1`），为后续多车扩展预留。
|
||
|
||
---
|
||
|
||
## 二、数据库变更
|
||
|
||
**无**。`order_vehicle_assignment` 表未改。
|
||
|
||
---
|
||
|
||
## 三、错误码
|
||
|
||
HTTP 始终返回 200，错误码在 `Result.code` 中。
|
||
|
||
| code | 触发 | 说明 |
|
||
| --- | --- | --- |
|
||
| 200 | 正常 | 成功 |
|
||
| 400 | `vehicleModel` 缺失/超长 | 参数校验失败 |
|
||
|
||
---
|
||
|
||
## 四、关联
|
||
|
||
- Issue: [wx/HL#1053](https://git.1814.love:8443/wx/HL/issues/1053)
|
||
- PR: [wx/HL#1054](https://git.1814.love:8443/wx/HL/pulls/1054)（已合并到 dev）
|