47 行
2.6 KiB
Markdown
47 行
2.6 KiB
Markdown
# 【前端缺口·管理后台】车辆档案列表缺「关键词搜索框」——后端 keyword 早已支持，前端补输入框即可
|
||
|
||
> 页面:车务管理 → 车辆档案 → 车辆列表 | 接口:`GET /admin/fleet/vehicles/page`（已上线，无需改动） | 负责:mmg
|
||
> 类型:前端补 UI（纯前端，后端零改动）
|
||
|
||
## 现象 / 诉求（wx）
|
||
|
||
车辆列表筛选区现在只有 4 个下拉框（所属车队 / 车型大类 / 所有权性质 / 生命周期），**没有文本搜索框**，车多了没法按车牌快速定位。诉求:至少能按车牌搜索。
|
||
|
||
## 结论:后端早就支持，是前端没放输入框
|
||
|
||
`GET /admin/fleet/vehicles/page` 的 **`keyword`** 入参已上线（API §2.1，v1.5.51 落地）：**车牌 OR 车型名称 模糊匹配**（一个框同时搜车牌和车型）。前端只需在筛选区加一个搜索输入框，绑定到 `keyword` 查询参数即可，**后端不用任何改动**。
|
||
|
||
测试服实测（admin token 经网关）：
|
||
|
||
| keyword | 命中 | 说明 |
|
||
|---|---|---|
|
||
| `蒙AD2001` | 1 条（蒙AD2001） | 车牌精确 |
|
||
| `蒙AD1` | 5 条（蒙AD1001~1005） | 车牌前缀 |
|
||
| `别克` | 5 条（含蒙AD2002/蒙C09E09 等别克GL8） | 车型名模糊 |
|
||
|
||
## 前端改法
|
||
|
||
筛选区加一个文本输入框（建议放在「所属车队」下拉前，或筛选区最左），placeholder 例如「车牌 / 车型」，绑定 `keyword`：
|
||
|
||
```
|
||
GET /admin/fleet/vehicles/page?pageNo=1&pageSize=24&keyword=蒙AD2001
|
||
```
|
||
|
||
- `keyword` 可选，传空 / 不传 = 不参与过滤（与现有 4 个下拉同口径，一起拼进 query）
|
||
- 与现有「搜索 / 重置」按钮联动:点搜索带上 keyword，点重置清空
|
||
- 后端已做 trim + 空白忽略，前端不必额外处理
|
||
|
||
## 入参全集（§2.1，供前端对照）
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|---|---|---|---|
|
||
| keyword | string | 否 | **车牌 / 车型 模糊搜索（本次要加的输入框）** |
|
||
| fleet | string | 否 | 车队 own/coopA/coopB（已有下拉） |
|
||
| ownerType | string | 否 | 所有权 company/personal（已有下拉） |
|
||
| typeKey | string | 否 | 车型大类 key（已有下拉） |
|
||
| serviceStatus | string | 否 | 生命周期 ACTIVE/DISABLED（已有下拉） |
|
||
| vehicleStatus | string | 否 | 车辆状态 idle/busy/maint（对应「空闲/在用/维保中」tab） |
|
||
| pageNo / pageSize | int | 否 | 分页 |
|
||
|
||
> 注:司机档案列表（`/admin/fleet/drivers/page`）的 `keyword` 口径不同——姓名模糊 + 手机 11 位全号精确（AES 密文等值，不支持手机模糊），若司机列表也要加搜索框照此说明。
|