wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态
hl-api-changelog/changelogs-v2/2026-06/13_3791_待审核列表过滤未提交空壳和作废链接-行为变更-管理后台.md

2.0 KiB
原始文件 永久链接 Blame 文件历史

【行为变更·管理后台】司机待审核列表只回真正提交的记录——过滤未提交空壳 + 已作废链接

服务:hl-fleet-service(8087/8187) | 分支:dev-v3 | PR:#3791 | 已部署测试服并 API 实测通过(2026-06-13) 背景:wx 反馈「待审核页数据全空」——卡片姓名/身份证/提交时间/照片全空。根因=列表把「司机点了 H5 链接但还没填写提交」的占位空壳、以及已作废链接也捞进了审核队列。

⚠️ 关键说明(前端动作)

  1. GET /admin/fleet/drivers/pending 行为变更(无需改前端代码,数据自动变干净):列表现在只返回真正提交过且链接未作废的记录,与「我的链接」派生态 SUBMITTED 同口径。两条恒生效基线过滤:
    • submitted_at IS NOT NULL——排除「生成链接但司机未填写提交」的占位空壳(生成链接那一刻就落了一行 pending+未提交的占位行)
    • void_status='NORMAL'——排除已作废链接(作废与审核正交,死链不进审核队列)
  2. 现象解释:测试服修复前待审核 tab 有 8 张全空卡片(全是未提交空壳),修复后为 0 条(当前确实没有真正提交待审的司机);已驳回 tab 从 6 条(含 1 条异常空壳)变 5 条真实记录。待审核 tab 看起来"变空"是正确的——空壳本就不该出现。
  3. 「申请详情页」后端已就绪:审核详情端点 GET /admin/fleet/drivers/pending/{pendingId}(PR#3785 已落)返回证件原图 URL / 驾照正副页 / 紧急联系人 / 自带车实拍照 / 备注(PII 脱敏),不存在返 600402。审核卡片的「查看详情」抽屉可以接这个端点看全量明细。

实测(测试服)

修复前: 待审核 8 条全 submittedAt=null 空壳 / 全部状态 15 条含空壳。 修复后: 待审核 0 条 / 全部状态 6 条(approved 1+rejected 5)全部 submittedAt 非空 / 已驳回 5 条真实记录(姓名+提交时间齐全)。

影响面

仅列表查询行为变更,approve/reject/详情端点不受影响;零接口签名变化、零 DDL、零路由。