yaosutu 68c8d61f39 changelog(order-v2): 管理端行程安排接口变更（聚合接口新增 + vehicleCount 下线）

- 新增 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）

2026-04-21 15:38:48 +08:00

2.2 KiB

原始文件 Blame 文件历史

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

新请求示例：

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
PR: wx/HL#1054（已合并到 dev）

2.2 KiB 原始文件 Blame 文件历史 Unescape Escape