101 行
5.0 KiB
Markdown
101 行
5.0 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "5254"
|
||
title: "订单侧已配置车辆补充车型车队服务日期与日单价"
|
||
consumer: "admin"
|
||
change_type: "修改接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "pending"
|
||
frontend_owner: ""
|
||
frontend_ref: ""
|
||
target_release: ""
|
||
verified_at: ""
|
||
status_note: "后端已合入 dev-v3 并部署测试环境；网关已验证新增字段、多车守恒和手机号脱敏。"
|
||
updated_at: "2026-07-26"
|
||
base: "dev-v3"
|
||
generated: "2026-07-26T09:57:21+08:00"
|
||
---
|
||
|
||
# 订单侧已配置车辆补充车型车队服务日期与日单价
|
||
|
||
订单详情的已配置车辆补齐车型标题、车队、连续服务日期、服务天数和协议日单价。
|
||
本记录只表示后端契约交接，`frontend_status` 在真实前端领取前保持 `pending`。
|
||
|
||
## 关联
|
||
|
||
- Issue: #5254
|
||
- PR: wx/HL#5260
|
||
|
||
## 变更接口
|
||
|
||
| 方法 | 路径 | 来源 |
|
||
|---|---|---|
|
||
| GET | `/v3/admin/order/:id/itinerary`（`:id` 为订单 ID） | `data.vehicleGroup.assignments[]` |
|
||
|
||
### `data.vehicleGroup.assignments[]`
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
|---|---|---|---|
|
||
| `brand` | string | 否 | 兼容字段；Fleet 实时数据下回填车辆车型名称，前端标题可按 `brand \|\| vehicleType \|\| '—'` 展示 |
|
||
| `fleetTeamId` | string | 否 | 车辆所属车队 ID；雪花 ID 按字符串返回 |
|
||
| `fleetTeamName` | string | 否 | 车辆所属车队名称；归档车辆或历史快照无法补齐时为空 |
|
||
| `startDate` | string(`yyyy-MM-dd`) | 否 | 车辆/司机连续服务段开始日 |
|
||
| `endDate` | string(`yyyy-MM-dd`) | 否 | 车辆/司机连续服务段结束日 |
|
||
| `serviceDays` | integer | 否 | 连续服务天数，首尾日期均计入 |
|
||
| `plannedDailyFee` | string(decimal) | 否 | 协议日单价；连续段内每日协议价不一致或无价格时为空，不得按 0 元展示 |
|
||
|
||
既有 `vehicleType`、`licensePlate`、`seats`、`driverName` 和
|
||
`driverPhoneMasked` 继续返回；手机号保持脱敏。
|
||
|
||
### 内部 Feign/shared Java
|
||
|
||
`OrderDriverVehicleCandidateDTO` 新增可空字段：
|
||
|
||
- `fleetTeamId: Long`（JSON 字符串）
|
||
- `fleetTeamName: String`
|
||
- `protocolPrice: BigDecimal`（JSON 字符串）
|
||
|
||
既有 `startDate`、`endDate` 本次开始映射到订单侧公开响应。新旧 Fleet/Order
|
||
可滚动部署：旧消费者忽略新增字段，新消费者读取旧生产者时新增字段为空。
|
||
|
||
## 契约影响文件
|
||
|
||
- `hl-common/hl-common-core/src/main/java/com/hulalv/common/dto/fleet/OrderDriverVehicleCandidateDTO.java`
|
||
- `hl-order-service-v3/src/main/java/com/hulalv/order/core/controller/admin/vo/detail/ItineraryVO.java`
|
||
- `hl-order-service-v3/src/test/java/com/hulalv/order/core/controller/admin/OrderControllerTest.java`
|
||
- `hl-order-service-v3/src/test/java/com/hulalv/order/fleet/feign/FleetDriverVehicleFeignContractTest.java`
|
||
|
||
## 前端/调用方动作
|
||
|
||
- `src/views/order-v2/detail/_shared/v3Adapter.js` 映射新增字段：
|
||
`fleetTeamName`、`startDate`、`endDate`、`serviceDays`、`plannedDailyFee`。
|
||
- 车型标题使用 `brand || vehicleType || '—'`；`brand === vehicleType` 时不要重复展示同一车型。
|
||
- “用车安排”摘要展示车型、车牌、座位、司机、脱敏手机号和服务日期。
|
||
- “已配置车辆”弹窗展示车型、车牌、座位、所属车队、司机、脱敏手机号、
|
||
服务起止日期、服务天数和协议日单价。
|
||
- `plannedDailyFee == null` 时显示 `—`，不得显示 0 元；无车辆时保持“暂无已配车”。
|
||
- 多车/改派连续段按接口数组逐条渲染，不按车牌或司机姓名自行去重。
|
||
|
||
## 验证证据
|
||
|
||
- Fleet 定向测试：
|
||
`mvn -pl hl-fleet-service -am -Dtest=OrderDriverVehicleQueryServiceTest,AssignmentConverterTest -Dsurefire.failIfNoSpecifiedTests=false test`
|
||
（31 项通过）。
|
||
- Order 消费者与内部契约：
|
||
`mvn -pl hl-order-service-v3 -am -Dtest=OrderDetailServiceTest,FleetDriverVehicleFeignContractTest -Dsurefire.failIfNoSpecifiedTests=false test`
|
||
（79 项通过）。
|
||
- 前端 API 序列化：
|
||
`mvn -pl hl-order-service-v3 -am -Dtest=OrderControllerTest#getItinerary_validId_returns200 -Dsurefire.failIfNoSpecifiedTests=false test`
|
||
（1 项通过）。
|
||
- Fleet Spotless：`mvn -pl hl-fleet-service spotless:check`（通过）。
|
||
- 联合验证：`mvn -pl hl-fleet-service,hl-order-service-v3 -am verify`
|
||
（BUILD SUCCESS；Fleet 2387 项通过，Spotless 通过；order-v3 定向 81 项通过）。
|
||
- 测试环境：`hl-fleet-service`、`hl-order-service-v3` 已从 `dev-v3`
|
||
滚动部署，两实例均健康。
|
||
- 网关验证：连续 6 次调用 `GET /v3/admin/order/:id/itinerary` 均返回 3 个唯一车辆连续段；
|
||
新增车型、车队、服务日期、服务天数和计划日单价字段存在，手机号保持脱敏且未返回原始手机号。
|
||
- 降级路径：Fleet 调用失败或空响应由 `OrderDetailServiceTest` 覆盖，本次未人为中断测试环境 Fleet。
|
||
- 兼容性结论：仅新增可空响应字段并补齐既有空字段；内部 Feign JSON 双向兼容，
|
||
不修改方法、路径、参数、必填项、枚举或错误码。
|