hl-api-changelog/changelogs-v2/2026-06/12_前端缺口_车辆档案列表缺关键词搜索框-接口已支持keyword-管理后台.md

【前端缺口·管理后台】车辆档案列表缺「关键词搜索框」——后端 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 密文等值，不支持手机模糊），若司机列表也要加搜索框照此说明。