diff --git a/changelogs-v2/2026-08/08_5706_车辆异步下拉options出参加dayPrice车型当日牌价-修改接口-管理后台.md b/changelogs-v2/2026-08/08_5706_车辆异步下拉options出参加dayPrice车型当日牌价-修改接口-管理后台.md index b1574cf..466eb53 100644 --- a/changelogs-v2/2026-08/08_5706_车辆异步下拉options出参加dayPrice车型当日牌价-修改接口-管理后台.md +++ b/changelogs-v2/2026-08/08_5706_车辆异步下拉options出参加dayPrice车型当日牌价-修改接口-管理后台.md @@ -2,17 +2,17 @@ schema: "hl-changelog/v2" ticket: "5706" title: "车辆异步下拉 options 出参加 dayPrice 车型当日牌价（核单选型参考价）" -consumer: "admin" +consumer: "internal" author: "wx" change_type: "修改接口" backend_status: "deployed" gateway_status: "verified" -frontend_status: "pending" +frontend_status: "not_required" frontend_owner: "" frontend_ref: "" target_release: "" verified_at: "" -status_note: "后端完成：PR #5714 合并 dev-v3（cba9a1ed16432f33c823a211472c10169766790c）并部署 TEST，网关验证 options 返回 dayPrice。order 侧配套（FleetVehicleOptionFeignVO + SettlementVehicleOptionRespVO 加 dayPrice 透传）由腰苏图负责；核单前端接 order step3/vehicles 的 dayPrice。" +status_note: "后端完成：PR #5714 合并 dev-v3（cba9a1ed16432f33c823a211472c10169766790c）并部署 TEST，网关验证 options 返回 dayPrice。internal Feign 接口，消费方为后端服务（order 核单侧），前端无关。order 侧配套（FleetVehicleOptionFeignVO + SettlementVehicleOptionRespVO 加 dayPrice 透传）由腰苏图负责。" updated_at: "2026-08-08" base: "dev-v3" generated: "2026-08-08T16:05:00+08:00" @@ -20,13 +20,15 @@ generated: "2026-08-08T16:05:00+08:00" # 车辆异步下拉 options 出参加 dayPrice 车型当日牌价（#5706） +> **影响范围**：仅后端服务间 Feign 内部调用（order 核单侧 → fleet），**前端无关**。`/internal/fleet/vehicles/options` 经 9443 网关访问直接 403（网关白名单只放通 admin/mp/internal-feign），前端/小程序不需要也不应调用。本 changelog 告知**后端同事**（order 核单侧 / 腰苏图）接入 `dayPrice` 透传。 + ## 需求 order-v3 核单 Step3 车辆费用「选车」下拉走 `GET /internal/fleet/vehicles/options`，原只回车辆身份字段不带价格。本单给选型下拉带「车型当日牌价」作参考，让定制师选车时心里有数。 **核算单价维持现状不动**：核单侧核算价仍来自派单后冻结快照 `dailyPrice`（按车型+用车日从价格日历冻结）。 -## 修改接口：`GET /internal/fleet/vehicles/options` +## 变更接口：`GET /internal/fleet/vehicles/options` ### 入参（新增可选） @@ -52,9 +54,9 @@ order-v3 核单 Step3 车辆费用「选车」下拉走 `GET /internal/fleet/veh ## order 侧配套（腰苏图负责，不在本单） -`FleetVehicleOptionFeignVO` + `SettlementVehicleOptionRespVO` 各加 `dayPrice` 透传；fleet 端点上测试服后接入 + 推前端 changelog。**核单前端**：Step3 选车下拉展示 `dayPrice` 作参考价（标注「参考价，非最终价」），最终核算价仍以 step3/vehicles 的 `dailyPrice` 为准。 +**后端同事交接（order 核单侧 / 腰苏图）**：`FleetVehicleOptionFeignVO` + `SettlementVehicleOptionRespVO` 各加 `dayPrice` 透传；fleet 端点已上测试服，可接入。order 核单 Step3 选车下拉如需展示参考价，用 `dayPrice`（标注「参考价，非最终价」）；**最终核算价仍以 step3/vehicles 的 `dailyPrice`（派单后冻结快照）为准，不要用 `dayPrice` 当核算金额**。 -## 验证 +## 验证证据 - VehicleServiceTest **115/115**（新增 2 dayPrice 用例：日历命中/basePrice回退/双无null/无N+1 + 默认日期回退今天/全日历命中不查basePrice）；VehicleInternalControllerTest 3/3（serviceDate 透传+dayPrice 返回+vehicleModelId 不下发）；dev-v3 全量 verify 3299/0F/0E。 - 网关实证（TEST fleet 实例直连）：①日历价优先 GL8 2026-10-09 设价500(basePrice900)→dayPrice=500；②未设价日回退 basePrice（2027-01-15→GL8=900/汉兰达=800/普拉多=1000）；③软删设价行不取（汉兰达2099-02-12已软删→回退800）；④dayPrice 下发+vehicleModelId 不下发。探针 `tools/probe_5706_vehicle_options_dayprice.py` 5/5 PASS。