changelog(#5552): 派车板详情日历价列兑底回显(board 订单详情 calendarPrice 语义)

这个提交包含在:
API Changelog Bot 2026-08-05 17:27:38 +08:00
父节点 b99b00940d
当前提交 0cb9a139a1

查看文件

@ -0,0 +1,52 @@
---
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: ""
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-H77772026-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 违规