feat: 添加设备IMEI和单卡ICCID查询接口

- 新增 GET /api/admin/devices/by-imei/:imei 接口，支持通过设备号查询设备详情
- 新增 GET /api/admin/iot-cards/by-iccid/:iccid 接口，支持通过ICCID查询单卡详情
- 添加对应的 Service 层方法和 Handler
- 更新 OpenAPI 文档
- 添加集成测试并修复测试环境配置（使用环境变量）
- 归档已完成的 OpenSpec 变更记录

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

openspec/specs/asset-allocation-record/spec.md

@@ -3,9 +3,7 @@
 ## Purpose
 
 管理资产（IoT 卡、设备）在平台与代理商之间的流转记录，支持分配和回收操作的完整追溯。
-
 ## Requirements
-
 ### Requirement: 资产分配记录查询
 
 系统 SHALL 提供资产分配记录的查询功能，支持查看卡和设备在平台与代理商之间的流转历史。
@@ -16,7 +14,7 @@
 
 **资产类型**:
 - `iot_card`: 物联网卡（单卡）
-- `device`: 设备（未来扩展）
+- `device`: 设备
 
 **查询条件**:
 - `allocation_type`（可选）: 分配类型，枚举值 "allocate" | "recall"
@@ -48,6 +46,8 @@
 - `asset_type_name`: 资产类型名称（物联网卡/设备）
 - `asset_id`: 资产 ID
 - `asset_identifier`: 资产标识符
+- `related_device_id`: 关联设备 ID（单卡分配时，如果卡绑定了设备）
+- `related_card_ids`: 关联卡 ID 列表（设备分配时，包含设备绑定的所有卡 ID）
 - `from_owner_type`: 来源所有者类型
 - `from_owner_id`: 来源所有者 ID
 - `from_owner_name`: 来源所有者名称
@@ -69,6 +69,11 @@
 - **WHEN** 管理员查询资产类型为 "iot_card" 的记录
 - **THEN** 系统只返回物联网卡的分配/回收记录，不包含设备记录
 
+#### Scenario: 按资产类型筛选设备记录
+
+- **WHEN** 管理员查询资产类型为 "device" 的记录
+- **THEN** 系统只返回设备的分配/回收记录，不包含单卡记录
+
 #### Scenario: 按分配类型筛选记录
 
 - **WHEN** 管理员查询分配类型为 "allocate" 的记录
@@ -79,6 +84,11 @@
 - **WHEN** 管理员输入 asset_identifier = "8986001"
 - **THEN** 系统返回 ICCID 包含 "8986001" 的所有分配记录
 
+#### Scenario: 按设备号模糊查询
+
+- **WHEN** 管理员输入 asset_identifier = "GPS"
+- **THEN** 系统返回设备号包含 "GPS" 的所有分配记录
+
 #### Scenario: 代理查询自己相关的记录
 
 - **WHEN** 代理用户（店铺 ID=10）查询分配记录
@@ -94,14 +104,20 @@
 
 **响应**:
 - 包含记录的所有字段
-- 关联卡 ID 列表（如果是设备分配，包含设备下的所有卡 ID）
+- `related_card_ids`: 关联卡 ID 列表（设备分配时，包含设备绑定的所有卡 ID）
 
 #### Scenario: 查询分配记录详情
 
 - **WHEN** 管理员查询分配记录详情（ID=1）
 - **THEN** 系统返回该记录的完整信息，包括来源/目标所有者名称、操作人名称等
 
+#### Scenario: 查询设备分配记录详情
+
+- **WHEN** 管理员查询设备分配记录详情
+- **THEN** 系统返回该记录的完整信息，包括 related_card_ids（设备绑定的所有卡 ID）
+
 #### Scenario: 查询不存在的记录
 
 - **WHEN** 管理员查询不存在的分配记录（ID=999）
 - **THEN** 系统返回 404 错误，提示"分配记录不存在"
+