docs(changelog): 司机待审核列表 reviewStatus 删除幽灵态 reviewing (PR #3840)

changelogs-v2/2026-06/15_司机待审核列表-reviewStatus删除废弃幽灵态reviewing-管理后台.md

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