# 管理端配车接口下线 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）
