docs(changelog): 车型管理下线 + 产品编排去车型接口契约变更 (#4062)

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 <token>" "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` |