设备新增搜索条件

docs/admin-openapi.yaml

@@ -13162,6 +13162,13 @@ paths:
                     description: 虚拟号(模糊查询)
                     maxLength: 100
                     type: string
+                - description: 设备IMEI(模糊查询)
+                  in: query
+                  name: imei
+                  schema:
+                    description: 设备IMEI(模糊查询)
+                    maxLength: 20
+                    type: string
                 - description: 设备名称(模糊查询)
                   in: query
                   name: device_name

docs/device-imei-search/功能总结.md

@@ -0,0 +1,16 @@
+# 设备列表 IMEI 搜索功能总结
+
+## 功能说明
+
+后台设备列表接口 `GET /api/admin/devices` 支持通过 `imei` 查询参数按设备 IMEI 模糊搜索设备。
+
+## 影响范围
+
+- 请求参数新增 `imei`，最大长度 20。
+- 查询链路从 Handler 解析参数后，经 Service 传递到 Store 层过滤条件。
+- OpenAPI 文档已同步新增 `imei` 查询参数。
+
+## 验证方式
+
+- 执行 `go run cmd/gendocs/main.go` 重新生成 OpenAPI 文档。
+- 执行 `go build ./...` 验证编译通过。