diff --git a/changelogs-v2/2026-08/05_5552_派车板详情日历价列兑底回显-修改接口-管理后台.md b/changelogs-v2/2026-08/05_5552_派车板详情日历价列兑底回显-修改接口-管理后台.md new file mode 100644 index 0000000..46ed40f --- /dev/null +++ b/changelogs-v2/2026-08/05_5552_派车板详情日历价列兑底回显-修改接口-管理后台.md @@ -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-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 违规