---
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
