实现资产双向换货链路查询

docs/admin-openapi.yaml

@@ -981,6 +981,34 @@ components:
                     description: 目标所有者类型
                     type: string
             type: object
+        DtoAssetExchangeTrace:
+            properties:
+                next_asset:
+                    $ref: '#/components/schemas/DtoAssetExchangeTraceItem'
+                previous_asset:
+                    $ref: '#/components/schemas/DtoAssetExchangeTraceItem'
+            type: object
+        DtoAssetExchangeTraceItem:
+            nullable: true
+            properties:
+                asset_id:
+                    description: 关联资产数据库 ID；无权限时为 null
+                    minimum: 0
+                    nullable: true
+                    type: integer
+                asset_type:
+                    description: 资产类型 (iot_card:物联网卡, device:设备)
+                    type: string
+                can_view:
+                    description: 是否有权跳转查看关联资产
+                    type: boolean
+                exchange_no:
+                    description: 换货单号
+                    type: string
+                identifier:
+                    description: 换货单保存的不可变资产标识快照
+                    type: string
+            type: object
         DtoAssetInfoResponse:
             properties:
                 activated_at:
@@ -1643,6 +1671,8 @@ components:
                 enable_virtual_data:
                     description: 当前主套餐是否启用虚流量（按套餐使用记录快照返回）
                     type: boolean
+                exchange_trace:
+                    $ref: '#/components/schemas/DtoAssetExchangeTrace'
                 gateway_card_imei:
                     description: 插拔卡业务 IMEI（由 Gateway 卡状态接口同步，非设备自身 IMEI，无业务含义，仅供查看）
                     type: string
@@ -12264,7 +12294,7 @@ paths:
                 - 资产管理
     /api/admin/assets/resolve/{identifier}:
         get:
-            description: 通过虚拟号/ICCID/IMEI/SN/MSISDN 解析设备或卡的完整详情。企业账号禁止调用。
+            description: 通过虚拟号/ICCID/IMEI/SN/MSISDN 解析设备或卡的完整详情。exchange_trace 始终存在，previous_asset/next_asset 无关系时为 null；关联项仅在 can_view=true 且 asset_id 非空时允许跳转。企业账号禁止调用。
             parameters:
                 - description: 是否返回当前世代流量汇总字段（total_virtual_used_mb / total_virtual_remaining_mb），默认 false
                   in: query