27 行
1.3 KiB
Markdown
27 行
1.3 KiB
Markdown
# 【前端待办·管理后台】司机列表「删除」按钮：后端接口已就绪，前端可放按钮
|
||
|
||
> 端：hl-ui 管理后台（车务 · 司机档案 · 司机列表卡片）| 服务：hl-fleet-service | 2026-06-16 | 无代码改动，纯能力告知
|
||
|
||
## ⚠️ 关键说明
|
||
|
||
司机列表卡片当前只有 **详情 / 派活 / 编辑 / 拉黑** 四个按钮，没有「删除」。后端**删除司机接口早已实现并在线**，前端可以放删除按钮直接调用。
|
||
|
||
## 接口契约
|
||
|
||
```
|
||
DELETE /admin/fleet/drivers/{driverId}
|
||
```
|
||
|
||
- **行为**：软删司机（不是物理删除）；若该司机是 annual 年保司机，联动作废其 MANUAL 年保台账单；发域事件让车辆域解绑其常驻车（释放占位）。
|
||
- **返回**：`Result<Void>`，成功 `code=0`。
|
||
- **错误码**：`600205` 司机不存在。
|
||
|
||
## 前端建议
|
||
|
||
- 删除是危险操作，按钮建议**二次确认弹窗**（如「确认删除司机 张三？删除后不可恢复」）。
|
||
- 拉黑（`/blacklist`）与删除语义不同：拉黑是赛季状态流转、保留档案；删除是软删除整条档案。两个按钮可并存。
|
||
|
||
## 备注
|
||
|
||
- 后端尚有一条 TODO：派单模块落地后会补「该司机有未完成派单则拒删（600204）」的校验。当前阶段无此拦截，删除即生效。
|