批量收回功能

2026-07-28 10:53:15 +08:00
parent 7c5b6ee036
commit 178cc45bc2
16 changed files with 117 additions and 71 deletions
--- a/docs/admin-openapi.yaml
+++ b/docs/admin-openapi.yaml
@@ -3784,19 +3784,19 @@ components:
                    minLength: 1
                    type: string
                operation_type:
-                    description: 操作类型 (assign_shop:分配目标代理, assign_series:设置套餐系列)
+                    description: 操作类型 (assign_shop:分配目标代理, assign_series:设置套餐系列, recall:回收设备)
                    enum:
                        - assign_shop
                        - assign_series
+                        - recall
                    type: string
                target_id:
-                    description: 目标代理店铺ID或套餐系列ID，由 operation_type 决定
+                    description: 目标代理店铺ID或套餐系列ID；recall 时不传
                    minimum: 1
                    type: integer
            required:
                - file_key
                - operation_type
-                - target_id
            type: object
        DtoCreateDeviceBatchAllocationResponse:
            properties:
@@ -5051,7 +5051,7 @@ components:
                    description: 任务业务类型名称（中文）
                    type: string
                operation_type:
-                    description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列)
+                    description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列, recall:回收设备)
                    type: string
                realname_policy:
                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
@@ -5083,7 +5083,7 @@ components:
                    description: 成功数
                    type: integer
                target_id:
-                    description: 批量分配目标店铺或套餐系列ID
+                    description: 批量分配目标店铺或套餐系列ID，回收任务为空
                    minimum: 0
                    nullable: true
                    type: integer
@@ -5137,7 +5137,7 @@ components:
                    description: 任务业务类型名称（中文）
                    type: string
                operation_type:
-                    description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列)
+                    description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列, recall:回收设备)
                    type: string
                realname_policy:
                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
@@ -5163,7 +5163,7 @@ components:
                    description: 成功数
                    type: integer
                target_id:
-                    description: 批量分配目标店铺或套餐系列ID
+                    description: 批量分配目标店铺或套餐系列ID，回收任务为空
                    minimum: 0
                    nullable: true
                    type: integer
@@ -6296,7 +6296,7 @@ components:
                    minLength: 1
                    type: string
                purpose:
-                    description: 文件用途 (iot_import:ICCID导入, export:数据导出, attachment:附件, batch_purchase:资产套餐批量订购CSV, device_batch_allocation:设备批量分配CSV)
+                    description: 文件用途 (iot_import:ICCID导入, export:数据导出, attachment:附件, batch_purchase:资产套餐批量订购CSV, device_batch_allocation:设备批量分配或回收CSV)
                    enum:
                        - iot_import
                        - export
@@ -17181,7 +17181,7 @@ paths:
                - 设备管理
    /api/admin/devices/import/allocations:
        post:
-            description: 复用设备导入任务。CSV只能包含一列设备标识，每行支持VirtualNo、IMEI或SN；整批选择分配目标代理或设置目标套餐系列。
+            description: 复用设备导入任务。CSV只能包含一列设备标识，每行支持VirtualNo、IMEI或SN；整批可分配目标代理、设置目标套餐系列或回收设备。
            requestBody:
                content:
                    application/json:
@@ -17240,7 +17240,7 @@ paths:
                    description: 服务器内部错误
            security:
                - BearerAuth: []
-            summary: 创建CSV设备批量分配任务
+            summary: 创建CSV设备批量分配或回收任务
            tags:
                - 设备管理
    /api/admin/devices/import/tasks:
@@ -17271,15 +17271,16 @@ paths:
                    minimum: 1
                    nullable: true
                    type: integer
-                - description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列)
+                - description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列, recall:回收设备)
                  in: query
                  name: operation_type
                  schema:
-                    description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列)
+                    description: 任务业务类型 (import:导入设备, assign_shop:分配目标代理, assign_series:设置套餐系列, recall:回收设备)
                    enum:
                        - import
                        - assign_shop
                        - assign_series
+                        - recall
                    type: string
                - description: 批次号(模糊查询)
                  in: query
@@ -27501,7 +27502,7 @@ paths:
                |---|------|-------------|
                | iot_import | ICCID/设备导入 (Excel) | imports/YYYY/MM/DD/uuid.xlsx |
                | batch_purchase | 资产套餐批量订购 (CSV) | batch-purchases/YYYY/MM/DD/uuid.csv |
-                | device_batch_allocation | 设备批量分配代理或套餐系列 (CSV) | device-batch-allocations/YYYY/MM/DD/uuid.csv |
+                | device_batch_allocation | 设备批量分配、设置套餐系列或回收 (CSV) | device-batch-allocations/YYYY/MM/DD/uuid.csv |
                | export | 数据导出 | exports/YYYY/MM/DD/uuid.xlsx |
                | attachment | 附件上传 | attachments/YYYY/MM/DD/uuid.ext |