From 150e10f8b9d94c37e3ace8313206dd6515827495 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 16 Jun 2026 10:41:05 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=8F=B8=E6=9C=BA=E5=BE=85?= =?UTF-8?q?=E5=AE=A1=E6=A0=B8=E8=AF=A6=E6=83=85=E9=A9=BE=E9=A9=B6=E8=AF=81?= =?UTF-8?q?=E5=9B=BE=E8=A1=A5=E8=BF=9Bphotos=E5=9D=97=20(PR=20#3855)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...待审核详情-驾驶证图补进photos块-管理后台.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 changelogs-v2/2026-06/16_司机待审核详情-驾驶证图补进photos块-管理后台.md 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 ✅