hl-api-changelog/changelogs-v2/2026-06/16_自带车审核通过自动建车-审核抽屉加自带车区-管理后台.md

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——请前端配合本期一起上。