From f84deb7464dfeca2f541ef57ec5d487a62848294 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 16 Jun 2026 14:13:21 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E8=87=AA=E5=B8=A6=E8=BD=A6?=
 =?UTF-8?q?=E5=AE=A1=E6=A0=B8=E9=80=9A=E8=BF=87=E8=87=AA=E5=8A=A8=E5=BB=BA?=
 =?UTF-8?q?=E8=BD=A6+=E5=AE=A1=E6=A0=B8=E6=8A=BD=E5=B1=89=E5=8A=A0?=
 =?UTF-8?q?=E8=87=AA=E5=B8=A6=E8=BD=A6=E5=8C=BA(=E5=89=8D=E7=AB=AF?=
 =?UTF-8?q?=E5=BE=85=E5=8A=A0)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...�核通过自动建车-审核抽屉加自带车区-管理后台.md | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 changelogs-v2/2026-06/16_自带车审核通过自动建车-审核抽屉加自带车区-管理后台.md

diff --git a/changelogs-v2/2026-06/16_自带车审核通过自动建车-审核抽屉加自带车区-管理后台.md b/changelogs-v2/2026-06/16_自带车审核通过自动建车-审核抽屉加自带车区-管理后台.md
new file mode 100644
index 0000000..a035487
--- /dev/null
+++ b/changelogs-v2/2026-06/16_自带车审核通过自动建车-审核抽屉加自带车区-管理后台.md
@@ -0,0 +1,58 @@
+# 【新功能·管理后台】自带车审核通过自动建车辆档案，审核抽屉需新增「自带车」区（前端待加）
+
+> 端：hl-ui 管理后台（车务 · 待审核 · 审核抽屉）| 服务：hl-fleet-service | PR #3866 / 工单 #3865 | 已合并 dev-v3 + 部署测试服双实例 | 2026-06-16
+
+## ⚠️ 关键说明
+
+司机经 H5 入职填了「自带车」，车管审核通过后**原来不建车辆档案**（只把自报车牌写成司机的文本字段，车辆列表查不到这台车、不能派单/对账）。现已实现：**审核通过自动建车辆档案并设为该司机常驻车**。
+
+但建车辆档案必须有**车型（关联车型库）+ 车队归属**，而 H5 自带车填的车型是自由文本——所以**需要前端在审核抽屉新增「自带车」区，让车管选车型库 + 车队**，再随审核通过提交。
+
+## 1. 审核通过接口入参新增 ownVehicle（前端要加）
+
+`POST /admin/fleet/drivers/pending/{pendingId}/approve`
+
+当待审核记录是 **mode=new 且 hasOwnVehicle=true**（自带车）时，请求体需带 `ownVehicle`：
+
+```json
+{
+  "approveReason": "资料齐全，予以通过",
+  "ownVehicle": {
+    "vehicleModelId": "车型库车型ID（必填，下拉选）",
+    "fleet": "车队归属（必填，字典 fleet_attribution，下拉选：own/coopA/coopB）",
+    "plate": "确认车牌（可选，不传用申请车牌）",
+    "ownerType": "所有权（可选，不传默认 personal 个人所有）",
+    "vin": "车架号（可选）"
+  }
+}
+```
+
+- **vehicleModelId / fleet 必填**：不传 → `600406`「自带车需选择车型、车队并确认车牌」。
+- **plate**：默认用司机申请填的车牌，车管可在抽屉里确认/修正。
+- **座位不用前端填**：从所选车型自动带出。
+- **行驶证/外观/内饰照、年检到期**：后端自动从申请记录搬进车辆附件，前端无需传。
+
+## 2. 审核抽屉「自带车」区建议（前端）
+
+mode=new & hasOwnVehicle=true 时显示：
+- **车型库下拉**（必选）—— 旁边可展示 H5 自报的车型文本「丰田普拉多」+ 座位作参考
+- **车队归属下拉**（必选，取字典 fleet_attribution）
+- **车牌确认框**（默认填入申请车牌，可改）
+- （展示）申请上传的行驶证/外观/内饰照，供车管核对
+
+## 3. 审核通过后的效果
+
+- 车辆档案（车辆列表）出现这台车，车型/座位/车队正确，行驶证照在车辆附件里。
+- 这台车的常驻司机 = 该司机；司机列表常驻车与车辆档案一致（不再空挂）。
+- 个人车常驻生命周期联动正常。
+
+## 4. 报错（前端容错）
+
+- `600406`：自带车没选车型/车队/车牌 → 提示车管在抽屉补齐。
+- `600100`：车牌已存在车辆档案 → 提示车管手动处理（不自动合并，避免误绑别人的车）。
+- `600108`：选的车型不存在。
+
+## 验证
+
+- 后端单测覆盖建车设常驻/缺要件 600406/非自带车不建车，单测 30 全绿；部署双实例（14:04 新 jar）；端点接受 ownVehicle 入参实测正常。
+- 注：**前端审核抽屉「自带车」区加好前**，自带车记录审核通过会因缺 vehicleModelId/fleet 返 600406——请前端配合本期一起上。