hl-api-changelog/changelogs-v2/2026-06/16_司机审核通过附件搬运修复-编辑抽屉证件照-管理后台.md

28 行
1.7 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 【行为修复·管理后台】司机审核通过后,编辑抽屉的证件照附件不再为空
> 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暂不在本次搬运范围老档案已有附件,避免重复,如有需要再单独处理。