hl-api-changelog/changelogs-v2/2026-06/16_司机列表删除按钮-后端接口已就绪待前端放按钮-管理后台.md

1.3 KiB

【前端待办·管理后台】司机列表「删除」按钮:后端接口已就绪,前端可放按钮

hl-ui 管理后台(车务 · 司机档案 · 司机列表卡片)| 服务hl-fleet-service | 2026-06-16 | 无代码改动,纯能力告知

⚠️ 关键说明

司机列表卡片当前只有 详情 / 派活 / 编辑 / 拉黑 四个按钮,没有「删除」。后端删除司机接口早已实现并在线,前端可以放删除按钮直接调用。

接口契约

DELETE /admin/fleet/drivers/{driverId}
  • 行为:软删司机(不是物理删除);若该司机是 annual 年保司机,联动作废其 MANUAL 年保台账单;发域事件让车辆域解绑其常驻车(释放占位)。
  • 返回Result<Void>,成功 code=0
  • 错误码600205 司机不存在。

前端建议

  • 删除是危险操作,按钮建议二次确认弹窗(如「确认删除司机 张三?删除后不可恢复」)。
  • 拉黑(/blacklist)与删除语义不同:拉黑是赛季状态流转、保留档案;删除是软删除整条档案。两个按钮可并存。

备注

  • 后端尚有一条 TODO派单模块落地后会补「该司机有未完成派单则拒删600204」的校验。当前阶段无此拦截,删除即生效。