diff --git a/changelogs-v2/2026-06/12_前端缺口_车辆档案列表缺关键词搜索框-接口已支持keyword-管理后台.md b/changelogs-v2/2026-06/12_前端缺口_车辆档案列表缺关键词搜索框-接口已支持keyword-管理后台.md new file mode 100644 index 0000000..57d5f1f --- /dev/null +++ b/changelogs-v2/2026-06/12_前端缺口_车辆档案列表缺关键词搜索框-接口已支持keyword-管理后台.md @@ -0,0 +1,46 @@ +# 【前端缺口·管理后台】车辆档案列表缺「关键词搜索框」——后端 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 密文等值,不支持手机模糊),若司机列表也要加搜索框照此说明。