59 行
3.2 KiB
Markdown
59 行
3.2 KiB
Markdown
# 【新功能·管理后台】自带车审核通过自动建车辆档案，审核抽屉需新增「自带车」区（前端待加）
|
||
|
||
> 端：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——请前端配合本期一起上。
|