docs(changelog): 自带车审核通过自动建车+审核抽屉加自带车区(前端待加)
这个提交包含在:
父节点
75be110438
当前提交
f84deb7464
@ -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——请前端配合本期一起上。
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户