1.9 KiB
1.9 KiB
【契约收紧·管理后台】司机待审核列表 reviewStatus 删除已废弃幽灵态 reviewing
端：hl-ui（车管 → 司机待审核列表）| 服务：hl-fleet-service driver/review | PR #3840 已合并 dev-v3 + 部署测试服 + 实测 | 2026-06-15
⚠️ 关键说明
待审核列表 GET /admin/fleet/drivers/pending 的 reviewStatus 入参枚举收紧：
- 旧：
@Pattern放行pending / reviewing / approved / rejected四值。但reviewing（审核中）是设计已删除的幽灵态——状态机里从不写入该值，库中永无reviewing行。传reviewStatus=reviewing会通过校验却恒返空列表（total=0），误导排查。 - 新：
reviewStatus仅接受pending / approved / rejected三值。传reviewing直接返code=400参数校验失败。
1. 前端需要确认的点
| 点 | 说明 |
|---|---|
| 审核状态 Tab | 列表页 Tab 应只有 待审核(pending) / 已通过(approved) / 已驳回(rejected) 三个。若前端任何地方还会传 reviewStatus=reviewing，需移除——否则该请求现在返 400。 |
| 正常三值不受影响 | pending / approved / rejected 行为完全不变。 |
| 不传 = 全部 | reviewStatus 不传时返回全部（含两条隐式基线过滤：已提交 + 未作废），不变。 |
2. 契约不变项
- 路径 / 出参结构 / 分页参数 / 其余字段（modeLabel / reviewStatusLabel / photos 等）完全不变。
- 本次仅为入参枚举校验收紧，对齐 API §5.1 修正契约（审计 §17 条目2）。
验证（测试服实测，过网关 9443 + 真 admin token）
| 入参 | 结果 |
|---|---|
reviewStatus=reviewing |
code=400 参数校验失败 ✅ |
reviewStatus=pending |
code=200 total=0 ✅ |
reviewStatus=approved |
code=200 total=1 ✅ |
| 无 filter | code=200 total=6 ✅ |