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