3.2 KiB
3.2 KiB
【新功能·管理后台】自带车审核通过自动建车辆档案,审核抽屉需新增「自带车」区(前端待加)
端: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:
{
"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——请前端配合本期一起上。