Mimingguang
87ed9d0a3f
changelog-filename-gate / validate (push) Failing after 2s
处置明细(mmg 2026-09-18): - 68 条机械核验通过批量翻 verified:frontend_ref 均可达且为 v2.1 祖先、 交付文件 HEAD 均在、关联 spec 批量 58 文件 891 例全绿。 - 11 条带演进史的例外逐条核后翻 verified:3 条交付自删文件(06_5610/ 07_5655/11_5810,删除即交付内容且终态保持);8 条被后续 changelog 预期 演进(10_5784→#5810、07_5664/08_5592→#5827、07_5665→去槽位化 U1、 01_5380/05_5356/06_5567/06_5581→settlement 族A扁平化与 mock 清理), status_note 均如实记录演进链。 - 05_5552 改判 not_required:frontend_ref 自述前端无需改动,grep 实证 vehicleFeeAmount.js 直接读后端 calendarPrice/calendarPriceMissing。 - 11_5827 frontend_ref 原空,经核交付即 753503c8(向导 4 步改 3 步提交 即派定),补登全哈希 753503c87cc635e5646b4368a8ed506746c79cf1。 另:保险域 2 条相邻条目(05_5530/06_5593)同标准复核翻 verified。 2026-07 历史月 45 条按规则不回扫,保持原状。
65 行
3.2 KiB
Markdown
65 行
3.2 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: "not_required"
|
||
frontend_owner: "pi-main-session"
|
||
frontend_ref: "N/A：前端字段已存在，仅后端取值变化，无需前端改动"
|
||
target_release: ""
|
||
verified_at: ""
|
||
status_note: "[mmg 2026-09-18 复核改判 not_required] frontend_ref 自述前端无需改动，grep 实证成立：派车板 vehicleFeeAmount.js 直接读后端 calendarPrice/calendarPriceMissing 字段做兑底回显，后端取值变化前端零适配；原 implemented 为误挂，改判 not_required。"
|
||
updated_at: "2026-09-18"
|
||
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
|