diff --git a/changelogs-v2/2026-06/20_4062_车型管理下线-产品编排去车型-接口契约变更.md b/changelogs-v2/2026-06/20_4062_车型管理下线-产品编排去车型-接口契约变更.md new file mode 100644 index 0000000..e5f0c34 --- /dev/null +++ b/changelogs-v2/2026-06/20_4062_车型管理下线-产品编排去车型-接口契约变更.md @@ -0,0 +1,61 @@ +# 【接口下线·管理后台+小程序】资源「车型管理」整套下线 + 产品编排不再绑车型 + +> 服务:hl-resource-service / hl-product-service-v2 / hl-order-service-v3 / hl-order-service-v2 / hl-user-service / hl-gateway | 分支:dev-v3 | PR:#4083 | 工单:#4062 +> 已部署测试服 6 服务双实例 health UP,9443 真 token + DB 地面真相实测通过(2026-06-20) + +## ⚠️ 关键说明 + +1. **车型统一归车务(fleet)**:创建产品不再关联资源车型,资源管理下的「车型管理」整套**物理删除**(代码 + 数据表 + 接口)。前端需移除相关入口/字段。 +2. **影响面**:管理后台(车型管理菜单 + 产品编排绑车型)、小程序(产品详情用车展示)、物流仪表盘(车型/车辆统计)三处。 +3. **用车不受影响**:订单实际用车一直是 fleet 订单派单(配房/配车在 HOUSE 域),本次只是砍掉「产品维度的车型目录」这条已不展示的链路。 + +## 1. 接口下线(管理后台) + +资源管理「车型管理」页面对应的全部接口已删除,调用一律返 `code:404「接口不存在」`: + +| 方法 | 路径 | 说明 | +|---|---|---| +| GET/POST/PUT/DELETE | `/admin/vehicle/model`、`/admin/vehicle/models`、`/admin/vehicle/models/all`、`/admin/vehicle/model/{id}` 等全部 | 车型 CRUD/审批/状态 | +| (内部) | `/internal/vehicle/**`、`/internal/resource/vehicle/stats` | 车型 Feign / 车型统计 | + +```bash +# 实测:车型管理接口已 404 +curl -k -H "Authorization: Bearer " "https://api.test.1814.love:9443/admin/vehicle/models" +# → {"code":404,"message":"接口不存在: /admin/vehicle/models","success":false} +``` + +前端动作:**移除「资源管理 > 车型管理」整个菜单与页面**。 + +## 2. 产品编排去车型(管理后台) + +产品编排不再有「绑定车型」入口,以下字段从接口契约移除: + +| VO / 接口 | 移除字段 | +|---|---| +| `ProductSupplementSaveReqVO`(编排补充配置保存) | `vehicleModelIds`(展示车型) | +| 产品详情 `ProductDetailRespVO` | `routeInfo.vehicleModelId`(成本车型)、`supplement.vehicleModelIds` | +| 小程序产品详情 `MpProductDetailInternalVO.PricingItem` | `vehicleModelIds` | + +前端动作:**产品编排表单移除「车型」选择控件**;详情/小程序不再读这些字段。注:`supplement.vehicleRuleText`(用车规则说明文案)**保留不变**。 + +## 3. 小程序产品详情「用车」展示 + +产品详情快照不再下发车型规格列表(`vehicleModels`,原聚合产品绑定车型的名称/座位/分类)。产品维度的「用车车型」展示口径取消,用车信息以订单侧 fleet 派单为准。 + +前端动作:小程序产品详情页若有「用车车型」展示块,按字段缺失/隐藏处理。 + +## 4. 物流仪表盘去车型/车辆统计 + +`LogisticsDashboardVO` 移除两字段:`totalVehicles`(车辆总数)、`totalVehicleModels`(车型总数)。仪表盘其余项(待配车 `pendingArrangeVehicle`、即将出行 `upcomingTrips`)不变。 + +## 5. 行为变更(后端,前端知悉即可) + +- 新建订单 `needsVehicle` 默认 `false`(原由产品绑定车型派生);配车需求由 HOUSE/requirement 域运营驱动,不再由产品自动派生。fleet 配车/派单/结算/用车需求全套不变。 +- order-v2(一期)订单详情用车弹窗规格 + 房车升级差价:车型成本不再可得,优雅降级(差价含车型部分恒 0,规格显示占位)。 + +## 6. 数据库变更(已在测试服执行) + +| 库 | 变更 | +|---|---| +| hl_resource_service | DROP 表 `vehicle_model` / `vehicle_tag` / `vehicle_tag_rel` / `vehicle_price_calendar` | +| hl_product_service | DROP 列 `product_route_info.vehicle_model_id`、`product_supplement.vehicle_model_ids` |