docs(changelog): 司机审核通过附件搬运修复 + 司机删除按钮后端就绪告知

这个提交包含在:
API Changelog Bot 2026-06-16 11:32:28 +08:00
父节点 6bebad8b50
当前提交 09ac87b11c
共有 2 个文件被更改,包括 53 次插入0 次删除

查看文件

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

查看文件

@ -0,0 +1,27 @@
# 【行为修复·管理后台】司机审核通过后,编辑抽屉的证件照附件不再为空
> 端hl-ui 管理后台(车务 · 司机档案 · 编辑抽屉「附件」区)| 服务hl-fleet-service | PR #3861 | 已合并 dev-v3 + 部署测试服 | 2026-06-16
## ⚠️ 关键说明
车管在「待审核」点**审核通过**新建司机后,进「编辑司机」抽屉,附件区(身份证 / 驾驶证 / 肖像照)原来**全部显示「上传图片」空位**——司机在 H5 上传的证件照没带过来。本次后端修复,建档时会把待审核记录里的证件照搬进司机附件表。
**前端无需改动**:附件区本来就读 `GET /admin/fleet/drivers/{driverId}` 详情里的附件列表,之前是后端没落数据导致为空,现在会有值。
## 1. 修复内容(后端)
审核通过mode=new 新建司机)落库时,把 `fleet_driver_pending` 里的证件照按类目搬进 `fleet_driver_attachment`
| 待审核照片 | 落入附件类目 |
|---|---|
| 身份证正面 + 背面 | `id_card`2 张) |
| 驾驶证正页 + 副页 | `driver_license`2 张) |
| 本人正脸照 | `portrait`1 张) |
- 健康证 / 培训证书等:待审核阶段未采集,仍为空,需车管在档案里手动补传。
- 某张照片 URL 为空则跳过,不占位。
## 2. 注意
- **本次修复对「本次修复后新审核通过的司机」生效**。修复前已审核通过、附件区为空的存量司机,证件照不会自动补回(其待审核记录里仍有图,如需可在档案编辑里手动补传,或后续做一次性回填脚本)。
- 续签mode=renew暂不在本次搬运范围老档案已有附件,避免重复,如有需要再单独处理。