diff --git a/changelogs-v2/2026-06/16_司机待审核详情-驾驶证图补进photos块-管理后台.md b/changelogs-v2/2026-06/16_司机待审核详情-驾驶证图补进photos块-管理后台.md new file mode 100644 index 0000000..7448dcd --- /dev/null +++ b/changelogs-v2/2026-06/16_司机待审核详情-驾驶证图补进photos块-管理后台.md @@ -0,0 +1,18 @@ +# 【缺陷修复·管理后台】司机待审核详情:驾驶证正副页图补进 photos 块(修「未上传」误显) + +> 端:hl-ui(车管 → 司机待审核 → 审核详情抽屉)| 服务:hl-fleet-service driver/review | PR #3855 | 已合并 dev-v3 + 部署 + 实测 | 2026-06-16 + +## ⚠️ 关键说明 + +司机详情 `GET /admin/fleet/drivers/pending/{pendingId}` 的 `photos` 块原来**缺 `licenseFrontUrl` / `licenseBackUrl`**,驾驶证正副页图只在 `license.frontUrl` / `license.backUrl` 下。前端按 API §5.4 读 `photos.licenseFrontUrl`(身份证就是这么读、正常显示)→ 读不到 → 驾驶证正副页错误显示「未上传」(**图其实已上传到 OSS,只是字段位置不对**)。 + +已修复:`photos` 块补 `licenseFrontUrl` / `licenseBackUrl`,对齐 §5.4「证件照统一在 photos 块」。 + +## 前端 + +- **无需改代码**,按 §5.4 读 `photos.licenseFrontUrl` / `photos.licenseBackUrl` 即可(与 idCardFrontUrl 同口径)。刷新审核详情即可看到驾驶证图。 +- `license.frontUrl` / `license.backUrl` 保留(向后兼容),但建议统一读 `photos.*`。 + +## 验证(测试服实测) + +- 真实提交记录详情 photos 块:idCardFrontUrl / idCardBackUrl / **licenseFrontUrl** / **licenseBackUrl** / portraitUrl 全部有 URL ✅