From fc8859b008e266b7bbb121715f135554fa97a00a Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 24 Apr 2026 17:02:57 +0800
Subject: [PATCH] =?UTF-8?q?docs(mp):=20=E7=94=A8=E8=BD=A6=E8=AF=A6?=
 =?UTF-8?q?=E6=83=85=E8=A1=A5=E9=BD=90=204=20=E5=AD=97=E6=AE=B5=20(PR=20#1?=
 =?UTF-8?q?366=20/=20Issue=20#1350)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...26-04-24_mp_vehicle-detail-add-4-fields.md | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 changelogs/2026-04/2026-04-24_mp_vehicle-detail-add-4-fields.md

diff --git a/changelogs/2026-04/2026-04-24_mp_vehicle-detail-add-4-fields.md b/changelogs/2026-04/2026-04-24_mp_vehicle-detail-add-4-fields.md
new file mode 100644
index 0000000..152384b
--- /dev/null
+++ b/changelogs/2026-04/2026-04-24_mp_vehicle-detail-add-4-fields.md
@@ -0,0 +1,65 @@
+# 小程序 - 用车详情补齐 座位数 / 车辆分类 / 驾龄要求 / 配置亮点 4 字段
+
+**日期**: 2026-04-24
+**PR**: #1366 (dev, commit 5899ae9f)
+**Issue**: #1350
+**类型**: fix
+**服务**: hl-mp-service
+
+---
+
+## 接口
+
+`GET /mp/order/{orderId}/vehicle`
+
+订单详情页「服务包含 · 用车详情」弹窗接口。
+
+## 变更
+
+response `data` 新增 4 字段:
+
+| 字段 | 类型 | 说明 | 示例 |
+|------|------|------|------|
+| `seatCount` | `Integer` | 座位数(来自产品快照 vehicleModels) | `6` |
+| `vehicleCategory` | `String` | 字典 `vehicle_type`: CAR=小轿车 / SUV=越野车 / VAN=商务车 / BUS=大巴 / MINIBUS=中巴 | `"VAN"` |
+| `driverYearsRequired` | `String` | 驾龄要求(资源服务暂未提供,当前固定 null) | `null` |
+| `features` | `List<String>` | 配置/亮点列表(资源服务暂未提供,当前固定 null) | `null` |
+
+旧字段保持不变:`vehicleType` / `vehicleCount` / `coverUrl` / `plateNumber` / `driverName` / `driverPhone` / `matched`。
+
+## 示例响应
+
+```json
+{
+  "code": 200,
+  "message": "成功",
+  "success": true,
+  "data": {
+    "vehicleType": "豪华suv",
+    "vehicleCount": 1,
+    "coverUrl": null,
+    "plateNumber": null,
+    "driverName": "够不够",
+    "driverPhone": "1521451212",
+    "matched": true,
+    "seatCount": 5,
+    "vehicleCategory": "GROUP",
+    "driverYearsRequired": null,
+    "features": null
+  }
+}
+```
+
+## 前端接入建议
+
+- 弹窗内 `座位数` 标签改读 `seatCount`,旧实现若读 `vehicleType` 包含「6座」文案可保留兜底
+- 「车辆分类」展示用 `vehicleCategory` 对字典 `vehicle_type` 翻译(前端 i18n 字典已有)
+- `driverYearsRequired` / `features` 为 null 时不渲染对应行,待资源服务后续补数据再显示
+
+## 根因说明(前端不关心,仅存档)
+
+mp-service BFF VO 与 order-v2 源端 VO 同名但字段数不一致,Feign 反序列化丢弃多余字段。本 PR 只补 BFF 端 VO,order-v2 源端早已返回该 4 字段。
+
+## E2E 验证(2026-04-24 测试服)
+
+订单 `HL20260423175303-5448` 直连 mp-service `127.0.0.1:8085` response 完整含 4 字段。