文件
hl-api-changelog/changelogs-v2/2026-08/05_5552_派车板详情日历价列兑底回显-修改接口-管理后台.md
T

2.9 KiB
原始文件 Blame 文件历史

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
schema ticket title consumer author change_type backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base
hl-changelog/v2 5552 派车板详情日历价列快照缺失时按车型实时兑底回显(不再显示 ¥0) admin wx(GIT) 修改接口 deployed verified implemented pi-main-session N/A:前端字段已存在,仅后端取值变化,无需前端改动 2026-08-05 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 违规

关联/联系人

链接

联系人

  • 后端负责人: @wx