65 行
2.9 KiB
Markdown
65 行
2.9 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "5552"
|
||
title: "派车板详情日历价列快照缺失时按车型实时兑底回显（不再显示 ¥0）"
|
||
consumer: "admin"
|
||
author: "wx(GIT)"
|
||
change_type: "修改接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "implemented"
|
||
frontend_owner: "pi-main-session"
|
||
frontend_ref: "N/A：前端字段已存在，仅后端取值变化，无需前端改动"
|
||
target_release: ""
|
||
verified_at: ""
|
||
status_note: ""
|
||
updated_at: "2026-08-05"
|
||
base: "dev-v3"
|
||
---
|
||
|
||
# 派车板订单详情：日历价列兑底回显
|
||
|
||
> **服务**: hl-fleet-service
|
||
> **PR**: #5554、#5555
|
||
> **Issue**: #5552
|
||
> **日期**: 2026-08-05
|
||
> **影响范围**: 管理后台派车板订单详情（每日派车计划 + 当前派车逐日费用）
|
||
|
||
## 变更接口
|
||
|
||
| 接口 | 方法 | 路径 | 变更 |
|
||
|---|---|---|---|
|
||
| 派车板订单详情 | GET | `/admin/fleet/board/orders/（订单ID）` | `dailyVehiclePlan[].calendarPrice`、`currentAssignment.dailyVehicleFees[].calendarPrice` 在快照缺失（历史派车时日历未设价，`vehicle_fee_calendar_price` 为 NULL）时，按车辆车型（vehicleModelId，价格日历取价键）+ 服务日实时取日历价兑底回显 |
|
||
|
||
### 响应字段语义变更
|
||
|
||
| 字段 | 类型 | 旧语义 | 新语义 |
|
||
|---|---|---|---|
|
||
| `dailyVehiclePlan[].calendarPrice` | `BigDecimal` / null | 已派行快照缺失时为 null（前端显示 ¥0） | 快照缺失时兑底为当前日历价（如 800.00）；快照有值保持冻结价 |
|
||
| `dailyVehicleFees[].calendarPrice` | `BigDecimal` / null | 同上 | 同上，`calendarPriceMissing` 同步变 false |
|
||
| `dailyVehiclePlan[].assignmentPrice` | `BigDecimal` | 协议价快照 | **不变**（快照保持，不随兑底篡改） |
|
||
| `dailyVehiclePlan[].priceSource` | `String` | CALENDAR/OVERRIDE/MISSING 判定 | **不变**（按兑底后日历价与协议价比较判定） |
|
||
|
||
取价键说明：`fleet_pricing_calendar` 按 `vehicle_model_id`（车型）维护；兑底链路为 `vehicle_id → vehicle_model_id → 日历价`，绝不按 vehicleId 查日历。
|
||
|
||
## 验证证据
|
||
|
||
- 网关实测 `GET /admin/fleet/board/orders/2080599963561005058`：
|
||
- 蒙A-H7777（2026-08-01~03）：`calendarPrice=800.00`（原 NULL）、`assignmentPrice=600/610/620`（快照保持）、`priceSource=OVERRIDE`
|
||
- 蒙A-E5555：`calendarPrice=2500.00`（原 NULL）
|
||
- `currentAssignment.dailyVehicleFees`（2026-08-04）：`calendarPrice=800.00`、`calendarPriceMissing=false`（原 NULL/true）
|
||
- 新派车行（蒙C05E05 08-20~25）：`calendarPrice=1000.00` CALENDAR（快照落库正确，不受影响）
|
||
- 测试：BoardOrderServiceTest 80 + VehicleServiceTest 113 全绿；spotless 0 违规
|
||
|
||
## 关联/联系人
|
||
|
||
### 链接
|
||
|
||
- [后端工单 #5552](https://git.1814.love:8443/wx/HL/issues/5552)
|
||
- [后端 PR #5555](https://git.1814.love:8443/wx/HL/pulls/5555)
|
||
- Merge commit: `da565dec88`
|
||
|
||
### 联系人
|
||
|
||
- **后端负责人**: @wx
|