实现换货资产快照与新旧独立搜索

docs/admin-openapi.yaml

@@ -3323,7 +3323,7 @@ components:
                     nullable: true
                     type: boolean
                 new_identifier:
-                    description: 新资产标识符，direct 流程必填(ICCID/虚拟号/IMEI/SN)
+                    description: 新资产输入标识，direct 流程必填；卡支持 ICCID、接入号、虚拟号，设备支持虚拟号、IMEI、SN
                     maxLength: 100
                     minLength: 1
                     type: string
@@ -3331,7 +3331,7 @@ components:
                     description: 旧资产类型 (iot_card:物联网卡, device:设备)
                     type: string
                 old_identifier:
-                    description: 旧资产标识符(ICCID/虚拟号/IMEI/SN)
+                    description: 旧资产输入标识，卡支持 ICCID、接入号、虚拟号，设备支持虚拟号、IMEI、SN；响应快照使用权威标识
                     maxLength: 100
                     minLength: 1
                     type: string
@@ -5175,7 +5175,7 @@ components:
                     nullable: true
                     type: integer
                 new_asset_identifier:
-                    description: 新资产标识符
+                    description: 新资产权威快照，卡为完整 ICCID，设备按虚拟号、IMEI、SN 优先级取值；历史记录保持原值
                     type: string
                 new_asset_type:
                     description: 新资产类型 (iot_card:物联网卡, device:设备)
@@ -5185,7 +5185,7 @@ components:
                     minimum: 0
                     type: integer
                 old_asset_identifier:
-                    description: 旧资产标识符
+                    description: 旧资产权威快照，卡为完整 ICCID，设备按虚拟号、IMEI、SN 优先级取值；历史记录保持原值
                     type: string
                 old_asset_type:
                     description: 旧资产类型 (iot_card:物联网卡, device:设备)
@@ -5247,7 +5247,7 @@ components:
                     description: 是否执行全量迁移 (true:执行, false:不执行)
                     type: boolean
                 new_identifier:
-                    description: 新资产标识符(ICCID/虚拟号/IMEI/SN)
+                    description: 新资产输入标识，卡支持 ICCID、接入号、虚拟号，设备支持虚拟号、IMEI、SN；保存快照使用权威标识
                     maxLength: 100
                     minLength: 1
                     type: string
@@ -16195,6 +16195,7 @@ paths:
                   schema:
                     description: 页码
                     minimum: 1
+                    nullable: true
                     type: integer
                 - description: 每页数量
                   in: query
@@ -16203,6 +16204,7 @@ paths:
                     description: 每页数量
                     maximum: 100
                     minimum: 1
+                    nullable: true
                     type: integer
                 - description: 换货状态 (1:待填写信息, 2:待发货, 3:已发货待确认, 4:已完成, 5:已取消)
                   in: query
@@ -16222,11 +16224,18 @@ paths:
                         - shipping
                         - direct
                     type: string
-                - description: 资产标识符搜索(旧资产/新资产标识符模糊匹配)
+                - description: 旧资产关键词，支持卡 ICCID、接入号、虚拟号或设备虚拟号、IMEI、SN；与新资产关键词按 AND 组合
                   in: query
-                  name: identifier
+                  name: old_asset_keyword
                   schema:
-                    description: 资产标识符搜索(旧资产/新资产标识符模糊匹配)
+                    description: 旧资产关键词，支持卡 ICCID、接入号、虚拟号或设备虚拟号、IMEI、SN；与新资产关键词按 AND 组合
+                    maxLength: 100
+                    type: string
+                - description: 新资产关键词，支持卡 ICCID、接入号、虚拟号或设备虚拟号、IMEI、SN；与旧资产关键词按 AND 组合
+                  in: query
+                  name: new_asset_keyword
+                  schema:
+                    description: 新资产关键词，支持卡 ICCID、接入号、虚拟号或设备虚拟号、IMEI、SN；与旧资产关键词按 AND 组合
                     maxLength: 100
                     type: string
                 - description: 创建时间起始