feat: add payout account review flow

backend/docs/docs.go

@@ -1594,6 +1594,48 @@ const docTemplate = `{
                 }
             }
         },
+        "/super/v1/payout-accounts/{id}/review": {
+            "post": {
+                "description": "Review payout account across tenants",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Finance"
+                ],
+                "summary": "Review payout account",
+                "parameters": [
+                    {
+                        "type": "integer",
+                        "format": "int64",
+                        "description": "Payout account ID",
+                        "name": "id",
+                        "in": "path",
+                        "required": true
+                    },
+                    {
+                        "description": "Review form",
+                        "name": "form",
+                        "in": "body",
+                        "required": true,
+                        "schema": {
+                            "$ref": "#/definitions/dto.SuperPayoutAccountReviewForm"
+                        }
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "Reviewed",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        },
         "/super/v1/reports/export": {
             "post": {
                 "description": "Export platform report data",
@@ -6278,6 +6320,19 @@ const docTemplate = `{
                 "OrderTypeWithdrawal"
             ]
         },
+        "consts.PayoutAccountStatus": {
+            "type": "string",
+            "enum": [
+                "pending",
+                "approved",
+                "rejected"
+            ],
+            "x-enum-varnames": [
+                "PayoutAccountStatusPending",
+                "PayoutAccountStatusApproved",
+                "PayoutAccountStatusRejected"
+            ]
+        },
         "consts.Role": {
             "type": "string",
             "enum": [
@@ -7432,6 +7487,26 @@ const docTemplate = `{
                     "description": "Realname 收款人姓名。",
                     "type": "string"
                 },
+                "review_reason": {
+                    "description": "ReviewReason 审核说明/驳回原因。",
+                    "type": "string"
+                },
+                "reviewed_at": {
+                    "description": "ReviewedAt 审核时间（RFC3339）。",
+                    "type": "string"
+                },
+                "status": {
+                    "description": "Status 审核状态（pending/approved/rejected）。",
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/consts.PayoutAccountStatus"
+                        }
+                    ]
+                },
+                "status_description": {
+                    "description": "StatusDescription 审核状态描述（用于展示）。",
+                    "type": "string"
+                },
                 "type": {
                     "description": "Type 账户类型（bank/alipay）。",
                     "type": "string"
@@ -9094,6 +9169,30 @@ const docTemplate = `{
                     "description": "Realname 收款人姓名。",
                     "type": "string"
                 },
+                "review_reason": {
+                    "description": "ReviewReason 审核说明/驳回原因。",
+                    "type": "string"
+                },
+                "reviewed_at": {
+                    "description": "ReviewedAt 审核时间（RFC3339）。",
+                    "type": "string"
+                },
+                "reviewed_by": {
+                    "description": "ReviewedBy 审核操作者ID。",
+                    "type": "integer"
+                },
+                "status": {
+                    "description": "Status 审核状态。",
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/consts.PayoutAccountStatus"
+                        }
+                    ]
+                },
+                "status_description": {
+                    "description": "StatusDescription 审核状态描述（用于展示）。",
+                    "type": "string"
+                },
                 "tenant_code": {
                     "description": "TenantCode 租户编码。",
                     "type": "string"
@@ -9124,6 +9223,26 @@ const docTemplate = `{
                 }
             }
         },
+        "dto.SuperPayoutAccountReviewForm": {
+            "type": "object",
+            "required": [
+                "action"
+            ],
+            "properties": {
+                "action": {
+                    "description": "Action 审核动作（approve/reject）。",
+                    "type": "string",
+                    "enum": [
+                        "approve",
+                        "reject"
+                    ]
+                },
+                "reason": {
+                    "description": "Reason 审核说明（驳回时必填）。",
+                    "type": "string"
+                }
+            }
+        },
         "dto.SuperReportExportForm": {
             "type": "object",
             "properties": {