docs: 更新 OpenAPI 文档，新增 realname-mode 更新接口文档

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

docs/admin-openapi.yaml

@@ -711,6 +711,9 @@ components:
                 real_name_status_name:
                     description: 实名状态名称（中文）
                     type: string
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 sn:
                     description: 设备序列号
                     type: string
@@ -941,6 +944,9 @@ components:
                 real_name_status:
                     description: 实名状态（asset_type=card时有效）：0未实名 1已实名
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
             type: object
         DtoAssetRefreshRequest:
             properties:
@@ -1092,6 +1098,9 @@ components:
                 real_name_status:
                     description: 实名状态：0未实名 1已实名
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 series_id:
                     description: 套餐系列ID
                     minimum: 0
@@ -1587,6 +1596,9 @@ components:
                 real_name_status:
                     description: 实名状态：0未实名 1已实名
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 slot_position:
                     description: 插槽位置
                     type: integer
@@ -3204,6 +3216,9 @@ components:
                 msisdn:
                     description: 接入号
                     type: string
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 slot_position:
                     description: 插槽位置 (1-4)
                     type: integer
@@ -3241,6 +3256,9 @@ components:
                 real_name_status:
                     description: 实名状态 (0:未实名, 1:已实名)
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 slot_position:
                     description: 插槽位置
                     type: integer
@@ -3448,6 +3466,9 @@ components:
                     description: 任务ID
                     minimum: 0
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 skip_count:
                     description: 跳过数
                     type: integer
@@ -3514,6 +3535,9 @@ components:
                     description: 任务ID
                     minimum: 0
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 skip_count:
                     description: 跳过数
                     type: integer
@@ -3759,6 +3783,9 @@ components:
                 online_status:
                     description: 在线状态：0未知 1在线 2离线
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 series_id:
                     description: 套餐系列ID
                     minimum: 0
@@ -4308,6 +4335,9 @@ components:
                     maxLength: 500
                     minLength: 1
                     type: string
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)，默认 none
+                    type: string
             required:
                 - file_key
             type: object
@@ -4342,6 +4372,9 @@ components:
                     maxLength: 500
                     minLength: 1
                     type: string
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)，默认 none
+                    type: string
             required:
                 - carrier_id
                 - file_key
@@ -4420,6 +4453,9 @@ components:
                     description: 任务ID
                     minimum: 0
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 skip_count:
                     description: 跳过数
                     type: integer
@@ -4490,6 +4526,9 @@ components:
                     description: 任务ID
                     minimum: 0
                     type: integer
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 skip_count:
                     description: 跳过数
                     type: integer
@@ -6819,6 +6858,9 @@ components:
                 real_name_status_name:
                     description: 实名状态名称（中文）
                     type: string
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
                 series_id:
                     description: 套餐系列ID
                     minimum: 0
@@ -6975,6 +7017,31 @@ components:
                     description: 更新后的轮询状态 (true:已启用, false:已禁用)
                     type: boolean
             type: object
+        DtoUpdateAssetRealnamePolicyRequest:
+            properties:
+                realname_policy:
+                    description: 实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    enum:
+                        - none
+                        - before_order
+                        - after_order
+                    type: string
+            required:
+                - realname_policy
+            type: object
+        DtoUpdateAssetRealnamePolicyResponse:
+            properties:
+                asset_id:
+                    description: 资产ID
+                    minimum: 0
+                    type: integer
+                asset_type:
+                    description: 资产类型 (card:IoT卡, device:设备)
+                    type: string
+                realname_policy:
+                    description: 更新后的实名认证策略 (none:无需实名, before_order:先实名后充值/购买, after_order:先充值/购买后实名)
+                    type: string
+            type: object
         DtoUpdateAuthorizationRemarkReq:
             properties:
                 remark:
@@ -9618,6 +9685,78 @@ paths:
             summary: 更新资产轮询状态
             tags:
                 - 资产管理
+    /api/admin/assets/{identifier}/realname-mode:
+        patch:
+            description: 更新指定资产（IoT卡或设备）的实名认证策略，支持 none/before_order/after_order 三种模式。
+            parameters:
+                - description: 资产标识符（ICCID 或 VirtualNo）
+                  in: path
+                  name: identifier
+                  required: true
+                  schema:
+                    description: 资产标识符（ICCID 或 VirtualNo）
+                    type: string
+            requestBody:
+                content:
+                    application/json:
+                        schema:
+                            $ref: '#/components/schemas/DtoUpdateAssetRealnamePolicyRequest'
+            responses:
+                "200":
+                    content:
+                        application/json:
+                            schema:
+                                properties:
+                                    code:
+                                        description: 响应码
+                                        example: 0
+                                        type: integer
+                                    data:
+                                        $ref: '#/components/schemas/DtoUpdateAssetRealnamePolicyResponse'
+                                    msg:
+                                        description: 响应消息
+                                        example: success
+                                        type: string
+                                    timestamp:
+                                        description: 时间戳
+                                        format: date-time
+                                        type: string
+                                required:
+                                    - code
+                                    - msg
+                                    - data
+                                    - timestamp
+                                type: object
+                    description: 成功
+                "400":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/ErrorResponse'
+                    description: 请求参数错误
+                "401":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/ErrorResponse'
+                    description: 未认证或认证已过期
+                "403":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/ErrorResponse'
+                    description: 无权访问
+                "500":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/ErrorResponse'
+                    description: 服务器内部错误
+            security:
+                - BearerAuth: []
+            summary: 更新资产实名认证策略
+            tags:
+                - 资产管理
     /api/admin/assets/{identifier}/realtime-status:
         get:
             description: 查询资产实时状态。卡类型：读取 DB/Redis 持久化状态；设备类型：实时调用 Gateway sync-info 接口获取最新数据，Gateway 失败不阻断主流程（DeviceRealtime.gateway_msg 返回失败原因）。

pkg/openapi/handlers.go

@@ -56,7 +56,7 @@ func BuildDocHandlers() *bootstrap.Handlers {
 		PollingAlert:                admin.NewPollingAlertHandler(nil),
 		PollingCleanup:              admin.NewPollingCleanupHandler(nil),
 		PollingManualTrigger:        admin.NewPollingManualTriggerHandler(nil),
-		Asset:                       admin.NewAssetHandler(nil, nil, nil, nil),
+		Asset:                       admin.NewAssetHandler(nil, nil, nil, nil, nil),
 		AssetLifecycle:              admin.NewAssetLifecycleHandler(nil),
 		AssetWallet:                 admin.NewAssetWalletHandler(nil),
 		WechatConfig:                admin.NewWechatConfigHandler(nil),