rogee/quyun-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add payout account review flow

Browse Source
This commit is contained in:
Rogee
2026-01-16 15:17:43 +08:00
parent daaacc3fa4
commit 028c462eaa
21 changed files with 1100 additions and 151 deletions
Download Patch File Download Diff File Expand all files Collapse all files

119
backend/docs/docs.go
View File

@@ -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": {

119
backend/docs/swagger.json
View File

@@ -1588,6 +1588,48 @@
}
}
},
"/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",
@@ -6272,6 +6314,19 @@
"OrderTypeWithdrawal"
]
},
"consts.PayoutAccountStatus": {
"type": "string",
"enum": [
"pending",
"approved",
"rejected"
],
"x-enum-varnames": [
"PayoutAccountStatusPending",
"PayoutAccountStatusApproved",
"PayoutAccountStatusRejected"
]
},
"consts.Role": {
"type": "string",
"enum": [
@@ -7426,6 +7481,26 @@
"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"
@@ -9088,6 +9163,30 @@
"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"
@@ -9118,6 +9217,26 @@
}
}
},
"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": {

81
backend/docs/swagger.yaml
View File

@@ -118,6 +118,16 @@ definitions:
- OrderTypeContentPurchase
- OrderTypeRecharge
- OrderTypeWithdrawal
consts.PayoutAccountStatus:
enum:
- pending
- approved
- rejected
type: string
x-enum-varnames:
- PayoutAccountStatusPending
- PayoutAccountStatusApproved
- PayoutAccountStatusRejected
consts.Role:
enum:
- user
@@ -940,6 +950,19 @@ definitions:
realname:
description: Realname 收款人姓名。
type: string
review_reason:
description: ReviewReason 审核说明/驳回原因。
type: string
reviewed_at:
description: ReviewedAt 审核时间（RFC3339）。
type: string
status:
allOf:
- $ref: '#/definitions/consts.PayoutAccountStatus'
description: Status 审核状态（pending/approved/rejected）。
status_description:
description: StatusDescription 审核状态描述（用于展示）。
type: string
type:
description: Type 账户类型（bank/alipay）。
type: string
@@ -2100,6 +2123,22 @@ definitions:
realname:
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:
allOf:
- $ref: '#/definitions/consts.PayoutAccountStatus'
description: Status 审核状态。
status_description:
description: StatusDescription 审核状态描述（用于展示）。
type: string
tenant_code:
description: TenantCode 租户编码。
type: string
@@ -2122,6 +2161,20 @@ definitions:
description: Username 用户名。
type: string
type: object
dto.SuperPayoutAccountReviewForm:
properties:
action:
description: Action 审核动作（approve/reject）。
enum:
- approve
- reject
type: string
reason:
description: Reason 审核说明（驳回时必填）。
type: string
required:
- action
type: object
dto.SuperReportExportForm:
properties:
end_at:
@@ -4266,6 +4319,34 @@ paths:
summary: Remove payout account
tags:
- Finance
/super/v1/payout-accounts/{id}/review:
post:
consumes:
- application/json
description: Review payout account across tenants
parameters:
- description: Payout account ID
format: int64
in: path
name: id
required: true
type: integer
- description: Review form
in: body
name: form
required: true
schema:
$ref: '#/definitions/dto.SuperPayoutAccountReviewForm'
produces:
- application/json
responses:
"200":
description: Reviewed
schema:
type: string
summary: Review payout account
tags:
- Finance
/super/v1/reports/export:
post:
consumes: