From 0cb9a139a1a40e1a5f78e04a876169b301f67d81 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 5 Aug 2026 17:27:38 +0800 Subject: [PATCH] =?UTF-8?q?changelog(#5552):=20=E6=B4=BE=E8=BD=A6=E6=9D=BF?= =?UTF-8?q?=E8=AF=A6=E6=83=85=E6=97=A5=E5=8E=86=E4=BB=B7=E5=88=97=E5=85=91?= =?UTF-8?q?=E5=BA=95=E5=9B=9E=E6=98=BE=EF=BC=88board=20=E8=AE=A2=E5=8D=95?= =?UTF-8?q?=E8=AF=A6=E6=83=85=20calendarPrice=20=E8=AF=AD=E4=B9=89?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...板详情日历价列兑底回显-修改接口-管理后台.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 changelogs-v2/2026-08/05_5552_派车板详情日历价列兑底回显-修改接口-管理后台.md 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 违规