订单相关以及佣金相关修复

docs/admin-openapi.yaml

@@ -1123,7 +1123,7 @@ components:
         DtoAssetResolveResponse:
             properties:
                 activated_at:
-                    description: 激活时间
+                    description: 激活时间（未来准备移除，请勿依赖）
                     format: date-time
                     nullable: true
                     type: string
@@ -3440,6 +3440,12 @@ components:
                 network_status:
                     description: 网络状态：0停机 1开机（asset_type=card时有效）
                     type: integer
+                real_name_status:
+                    description: 实名状态 (0:未实名, 1:已实名)
+                    type: integer
+                real_name_status_name:
+                    description: 实名状态名称（中文）
+                    type: string
                 realname_policy:
                     description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
                     type: string
@@ -5449,11 +5455,17 @@ components:
                 commission_config_version:
                     description: 佣金配置版本
                     type: integer
+                commission_result:
+                    description: 佣金业务结果 (0:未知, 1:有佣金, 2:无佣金, 3:链路异常)
+                    type: integer
+                commission_result_name:
+                    description: 佣金业务结果名称（中文）
+                    type: string
                 commission_status:
-                    description: 佣金状态 (1:待计算, 2:已计算)
+                    description: 佣金流程状态 (1:待计算, 2:已完成, 3:待人工处理)
                     type: integer
                 commission_status_name:
-                    description: 佣金状态名称（中文）
+                    description: 佣金流程状态名称（中文）
                     type: string
                 created_at:
                     description: 创建时间
@@ -5494,15 +5506,15 @@ components:
                     nullable: true
                     type: array
                 operator_id:
-                    description: 操作者ID
+                    description: 操作者账号ID（真实发起操作的账号/主体ID）
                     minimum: 0
                     nullable: true
                     type: integer
                 operator_name:
-                    description: 操作者名称
+                    description: 操作者名称（按账号语义展示）
                     type: string
                 operator_type:
-                    description: 操作者类型 (platform:平台, agent:代理)
+                    description: 操作者账号类型 (platform:平台, agent:代理, enterprise:企业, personal_customer:个人客户)
                     type: string
                 order_no:
                     description: 订单号
@@ -5533,6 +5545,14 @@ components:
                 purchase_role:
                     description: 订单角色 (self_purchase:自己购买, purchased_by_parent:上级代理购买, purchased_by_platform:平台代购, purchase_for_subordinate:给下级购买)
                     type: string
+                seller_shop_id:
+                    description: 销售店铺ID（业务归属字段）
+                    minimum: 0
+                    nullable: true
+                    type: integer
+                seller_shop_name:
+                    description: 销售店铺名称（业务归属展示）
+                    type: string
                 total_amount:
                     description: 订单总金额(分)
                     type: integer
@@ -6741,11 +6761,17 @@ components:
             type: object
         DtoSetSwitchModeRequest:
             properties:
+                iot_card_id:
+                    description: 目标卡资产ID（必须是系统内状态正常且已实名的卡）
+                    minimum: 1
+                    type: integer
                 switch_mode:
                     description: 切卡模式 (0:自动切卡, 1:手动切卡)
+                    nullable: true
                     type: integer
             required:
                 - switch_mode
+                - iot_card_id
             type: object
         DtoSetWiFiRequest:
             properties:
@@ -13385,7 +13411,7 @@ paths:
                 - 设备管理
     /api/admin/devices/by-identifier/{identifier}/switch-mode:
         post:
-            description: 通过虚拟号/IMEI/SN 设置设备切卡模式（0:自动切卡, 1:手动切卡）。设备必须已配置 IMEI。
+            description: 通过虚拟号/IMEI/SN 设置设备切卡模式（0:自动切卡, 1:手动切卡）。设备必须已配置 IMEI，且必须指定一张系统内状态正常并已实名的目标卡资产ID。
             parameters:
                 - description: 设备标识符(支持虚拟号/IMEI/SN)
                   in: path