# 【契约收紧·管理后台】司机待审核列表 `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 ✅ |
