docs(changelog): 前端缺口 车辆档案列表缺关键词搜索框 后端keyword已支持 通知 mmg

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 密文等值，不支持手机模糊），若司机列表也要加搜索框照此说明。