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