tenant: admin batch topup

backend/docs/swagger.yaml

@@ -180,6 +180,75 @@ definitions:
     - UserStatusPendingVerify
     - UserStatusVerified
     - UserStatusBanned
+  dto.AdminBatchTopupForm:
+    properties:
+      batch_idempotency_key:
+        description: BatchIdempotencyKey 批次幂等键：必须填写；用于重试同一批次时保证不会重复入账。
+        type: string
+      items:
+        description: Items 充值明细列表：至少 1 条；单批次条数在业务侧限制（避免拖垮系统）。
+        items:
+          $ref: '#/definitions/dto.AdminBatchTopupItem'
+        type: array
+    type: object
+  dto.AdminBatchTopupItem:
+    properties:
+      amount:
+        description: Amount 充值金额：单位分；必须 > 0。
+        type: integer
+      idempotency_key:
+        description: |-
+          IdempotencyKey 幂等键（可选）：为空时后端会用 batch_idempotency_key 派生生成；
+          建议前端/调用方提供稳定值，便于重试时保持结果一致。
+        type: string
+      reason:
+        description: Reason 充值原因（可选）：用于审计与追溯。
+        type: string
+      user_id:
+        description: UserID 目标用户ID：必须属于当前租户，否则该条充值失败。
+        type: integer
+    type: object
+  dto.AdminBatchTopupResponse:
+    properties:
+      failed:
+        description: Failed 失败条数。
+        type: integer
+      items:
+        description: Items 明细结果列表：与请求 items 顺序一致，便于前端逐条展示。
+        items:
+          $ref: '#/definitions/dto.AdminBatchTopupResultItem'
+        type: array
+      success:
+        description: Success 成功条数。
+        type: integer
+      total:
+        description: Total 总条数：等于 items 长度。
+        type: integer
+    type: object
+  dto.AdminBatchTopupResultItem:
+    properties:
+      amount:
+        description: Amount 充值金额（单位分）。
+        type: integer
+      error_code:
+        description: ErrorCode 错误码：失败时返回；成功时为 0。
+        type: integer
+      error_message:
+        description: ErrorMessage 错误信息：失败时返回；成功时为空。
+        type: string
+      idempotency_key:
+        description: IdempotencyKey 实际使用的幂等键：可能为客户端传入，也可能为后端派生生成。
+        type: string
+      ok:
+        description: OK 是否成功：true 表示该条充值已成功入账或命中幂等成功结果。
+        type: boolean
+      order_id:
+        description: OrderID 生成的订单ID：成功时返回；失败时为 0。
+        type: integer
+      user_id:
+        description: UserID 目标用户ID。
+        type: integer
+    type: object
   dto.AdminOrderDetail:
     properties:
       order:
@@ -2224,6 +2293,32 @@ paths:
       summary: 为租户成员充值（租户管理）
       tags:
       - Tenant
+  /t/{tenantCode}/v1/admin/users/topup/batch:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: Tenant Code
+        in: path
+        name: tenantCode
+        required: true
+        type: string
+      - description: Form
+        in: body
+        name: form
+        required: true
+        schema:
+          $ref: '#/definitions/dto.AdminBatchTopupForm'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.AdminBatchTopupResponse'
+      summary: 批量为租户成员充值（租户管理）
+      tags:
+      - Tenant
   /t/{tenantCode}/v1/contents:
     get:
       consumes: