chore: stabilize lint and verify builds

This commit is contained in:
2026-02-06 11:51:32 +08:00
parent edede17880
commit 1782f64417
114 changed files with 3032 additions and 1345 deletions

View File

@@ -1268,6 +1268,40 @@ const docTemplate = `{
}
}
},
"/super/v1/finance/recharge-codes/activate": {
"post": {
"description": "Batch activate recharge codes",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Activate recharge codes",
"parameters": [
{
"description": "Activate form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RechargeCodeActivateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.RechargeCodeActivateResponse"
}
}
}
}
},
"/super/v1/health/overview": {
"get": {
"description": "Platform health overview",
@@ -3622,6 +3656,48 @@ const docTemplate = `{
}
}
},
"/super/v1/users/{id}/wallet/credit": {
"post": {
"description": "Credit user wallet balance",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Credit user wallet",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Credit form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperWalletCreditForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/withdrawals": {
"get": {
"description": "List withdrawal orders across tenants",
@@ -5305,40 +5381,6 @@ const docTemplate = `{
}
}
}
},
"/v1/t/{tenantCode}/webhook/payment/notify": {
"post": {
"description": "Payment Webhook",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Payment Webhook",
"parameters": [
{
"description": "Webhook Data",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.PaymentWebhookForm"
}
}
],
"responses": {
"200": {
"description": "success",
"schema": {
"type": "string"
}
}
}
}
}
},
"definitions": {
@@ -6321,7 +6363,6 @@ const docTemplate = `{
"type": "object",
"properties": {
"method": {
"description": "Method 支付方式alipay/balance。",
"type": "string"
}
}
@@ -6329,8 +6370,7 @@ const docTemplate = `{
"dto.OrderPayResponse": {
"type": "object",
"properties": {
"pay_params": {
"description": "PayParams 支付参数(透传给前端)。",
"status": {
"type": "string"
}
}
@@ -6406,19 +6446,6 @@ const docTemplate = `{
}
}
},
"dto.PaymentWebhookForm": {
"type": "object",
"properties": {
"external_id": {
"description": "ExternalID 第三方支付流水号。",
"type": "string"
},
"order_id": {
"description": "OrderID 订单ID。",
"type": "integer"
}
}
},
"dto.RealNameForm": {
"type": "object",
"properties": {
@@ -6432,15 +6459,87 @@ const docTemplate = `{
}
}
},
"dto.RechargeCodeActivateForm": {
"type": "object",
"required": [
"amount"
],
"properties": {
"amount": {
"description": "Amount 单码充值金额(元)。",
"type": "number"
},
"quantity": {
"description": "Quantity 生成数量(默认 1最大 500。",
"type": "integer"
},
"remark": {
"description": "Remark 备注信息(用于审计展示)。",
"type": "string"
}
}
},
"dto.RechargeCodeActivateResponse": {
"type": "object",
"properties": {
"items": {
"description": "Items 本次生成的充值码列表。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.RechargeCodeItem"
}
}
}
},
"dto.RechargeCodeItem": {
"type": "object",
"properties": {
"activated_at": {
"description": "ActivatedAt 激活时间RFC3339。",
"type": "string"
},
"activated_by": {
"description": "ActivatedBy 激活操作者ID。",
"type": "integer"
},
"amount": {
"description": "Amount 充值金额(元)。",
"type": "number"
},
"code": {
"description": "Code 充值码明文。",
"type": "string"
},
"id": {
"description": "ID 充值码ID。",
"type": "integer"
},
"redeemed_at": {
"description": "RedeemedAt 兑换时间RFC3339。",
"type": "string"
},
"redeemed_by": {
"description": "RedeemedBy 兑换用户ID。",
"type": "integer"
},
"redeemed_order_id": {
"description": "RedeemedOrderID 兑换生成的充值订单ID。",
"type": "integer"
},
"remark": {
"description": "Remark 激活备注信息。",
"type": "string"
},
"status": {
"description": "Status 充值码状态active/redeemed。",
"type": "string"
}
}
},
"dto.RechargeForm": {
"type": "object",
"properties": {
"amount": {
"description": "Amount 充值金额(单位元)。",
"type": "number"
},
"method": {
"description": "Method 充值方式alipay。",
"code": {
"type": "string"
}
}
@@ -6448,13 +6547,11 @@ const docTemplate = `{
"dto.RechargeResponse": {
"type": "object",
"properties": {
"order_id": {
"description": "OrderID 充值订单ID。",
"type": "integer"
"amount": {
"type": "number"
},
"pay_params": {
"description": "PayParams 支付参数(透传给前端)。",
"type": "string"
"order_id": {
"type": "integer"
}
}
},
@@ -8901,6 +8998,22 @@ const docTemplate = `{
}
}
},
"dto.SuperWalletCreditForm": {
"type": "object",
"required": [
"amount"
],
"properties": {
"amount": {
"description": "Amount 充值金额(元)。",
"type": "number"
},
"remark": {
"description": "Remark 备注信息(用于审计展示)。",
"type": "string"
}
}
},
"dto.SuperWalletResponse": {
"type": "object",
"properties": {

View File

@@ -1,10 +1,8 @@
package docs
import (
_ "embed"
_ "github.com/rogeecn/swag"
)
import "embed"
//go:embed swagger.json
var SwaggerSpec string
var _ embed.FS

View File

@@ -1262,6 +1262,40 @@
}
}
},
"/super/v1/finance/recharge-codes/activate": {
"post": {
"description": "Batch activate recharge codes",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Finance"
],
"summary": "Activate recharge codes",
"parameters": [
{
"description": "Activate form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.RechargeCodeActivateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.RechargeCodeActivateResponse"
}
}
}
}
},
"/super/v1/health/overview": {
"get": {
"description": "Platform health overview",
@@ -3616,6 +3650,48 @@
}
}
},
"/super/v1/users/{id}/wallet/credit": {
"post": {
"description": "Credit user wallet balance",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"User"
],
"summary": "Credit user wallet",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "User ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "Credit form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperWalletCreditForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/withdrawals": {
"get": {
"description": "List withdrawal orders across tenants",
@@ -5299,40 +5375,6 @@
}
}
}
},
"/v1/t/{tenantCode}/webhook/payment/notify": {
"post": {
"description": "Payment Webhook",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Payment Webhook",
"parameters": [
{
"description": "Webhook Data",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.PaymentWebhookForm"
}
}
],
"responses": {
"200": {
"description": "success",
"schema": {
"type": "string"
}
}
}
}
}
},
"definitions": {
@@ -6315,7 +6357,6 @@
"type": "object",
"properties": {
"method": {
"description": "Method 支付方式alipay/balance。",
"type": "string"
}
}
@@ -6323,8 +6364,7 @@
"dto.OrderPayResponse": {
"type": "object",
"properties": {
"pay_params": {
"description": "PayParams 支付参数(透传给前端)。",
"status": {
"type": "string"
}
}
@@ -6400,19 +6440,6 @@
}
}
},
"dto.PaymentWebhookForm": {
"type": "object",
"properties": {
"external_id": {
"description": "ExternalID 第三方支付流水号。",
"type": "string"
},
"order_id": {
"description": "OrderID 订单ID。",
"type": "integer"
}
}
},
"dto.RealNameForm": {
"type": "object",
"properties": {
@@ -6426,15 +6453,87 @@
}
}
},
"dto.RechargeCodeActivateForm": {
"type": "object",
"required": [
"amount"
],
"properties": {
"amount": {
"description": "Amount 单码充值金额(元)。",
"type": "number"
},
"quantity": {
"description": "Quantity 生成数量(默认 1最大 500。",
"type": "integer"
},
"remark": {
"description": "Remark 备注信息(用于审计展示)。",
"type": "string"
}
}
},
"dto.RechargeCodeActivateResponse": {
"type": "object",
"properties": {
"items": {
"description": "Items 本次生成的充值码列表。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.RechargeCodeItem"
}
}
}
},
"dto.RechargeCodeItem": {
"type": "object",
"properties": {
"activated_at": {
"description": "ActivatedAt 激活时间RFC3339。",
"type": "string"
},
"activated_by": {
"description": "ActivatedBy 激活操作者ID。",
"type": "integer"
},
"amount": {
"description": "Amount 充值金额(元)。",
"type": "number"
},
"code": {
"description": "Code 充值码明文。",
"type": "string"
},
"id": {
"description": "ID 充值码ID。",
"type": "integer"
},
"redeemed_at": {
"description": "RedeemedAt 兑换时间RFC3339。",
"type": "string"
},
"redeemed_by": {
"description": "RedeemedBy 兑换用户ID。",
"type": "integer"
},
"redeemed_order_id": {
"description": "RedeemedOrderID 兑换生成的充值订单ID。",
"type": "integer"
},
"remark": {
"description": "Remark 激活备注信息。",
"type": "string"
},
"status": {
"description": "Status 充值码状态active/redeemed。",
"type": "string"
}
}
},
"dto.RechargeForm": {
"type": "object",
"properties": {
"amount": {
"description": "Amount 充值金额(单位元)。",
"type": "number"
},
"method": {
"description": "Method 充值方式alipay。",
"code": {
"type": "string"
}
}
@@ -6442,13 +6541,11 @@
"dto.RechargeResponse": {
"type": "object",
"properties": {
"order_id": {
"description": "OrderID 充值订单ID。",
"type": "integer"
"amount": {
"type": "number"
},
"pay_params": {
"description": "PayParams 支付参数(透传给前端)。",
"type": "string"
"order_id": {
"type": "integer"
}
}
},
@@ -8895,6 +8992,22 @@
}
}
},
"dto.SuperWalletCreditForm": {
"type": "object",
"required": [
"amount"
],
"properties": {
"amount": {
"description": "Amount 充值金额(元)。",
"type": "number"
},
"remark": {
"description": "Remark 备注信息(用于审计展示)。",
"type": "string"
}
}
},
"dto.SuperWalletResponse": {
"type": "object",
"properties": {

View File

@@ -714,13 +714,11 @@ definitions:
dto.OrderPayForm:
properties:
method:
description: Method 支付方式alipay/balance
type: string
type: object
dto.OrderPayResponse:
properties:
pay_params:
description: PayParams 支付参数(透传给前端)。
status:
type: string
type: object
dto.OrderStatisticsResponse:
@@ -771,15 +769,6 @@ definitions:
description: Name 租户名称。
type: string
type: object
dto.PaymentWebhookForm:
properties:
external_id:
description: ExternalID 第三方支付流水号。
type: string
order_id:
description: OrderID 订单ID。
type: integer
type: object
dto.RealNameForm:
properties:
id_card:
@@ -789,23 +778,72 @@ definitions:
description: Realname 真实姓名。
type: string
type: object
dto.RechargeForm:
dto.RechargeCodeActivateForm:
properties:
amount:
description: Amount 充值金额(单位元)。
description: Amount 单码充值金额(元)。
type: number
method:
description: Method 充值方式alipay)。
quantity:
description: Quantity 生成数量(默认 1最大 500)。
type: integer
remark:
description: Remark 备注信息(用于审计展示)。
type: string
required:
- amount
type: object
dto.RechargeCodeActivateResponse:
properties:
items:
description: Items 本次生成的充值码列表。
items:
$ref: '#/definitions/dto.RechargeCodeItem'
type: array
type: object
dto.RechargeCodeItem:
properties:
activated_at:
description: ActivatedAt 激活时间RFC3339
type: string
activated_by:
description: ActivatedBy 激活操作者ID。
type: integer
amount:
description: Amount 充值金额(元)。
type: number
code:
description: Code 充值码明文。
type: string
id:
description: ID 充值码ID。
type: integer
redeemed_at:
description: RedeemedAt 兑换时间RFC3339
type: string
redeemed_by:
description: RedeemedBy 兑换用户ID。
type: integer
redeemed_order_id:
description: RedeemedOrderID 兑换生成的充值订单ID。
type: integer
remark:
description: Remark 激活备注信息。
type: string
status:
description: Status 充值码状态active/redeemed
type: string
type: object
dto.RechargeForm:
properties:
code:
type: string
type: object
dto.RechargeResponse:
properties:
amount:
type: number
order_id:
description: OrderID 充值订单ID。
type: integer
pay_params:
description: PayParams 支付参数(透传给前端)。
type: string
type: object
dto.ReportExportResponse:
properties:
@@ -2511,6 +2549,17 @@ definitions:
description: VerifiedAt 实名认证时间RFC3339
type: string
type: object
dto.SuperWalletCreditForm:
properties:
amount:
description: Amount 充值金额(元)。
type: number
remark:
description: Remark 备注信息(用于审计展示)。
type: string
required:
- amount
type: object
dto.SuperWalletResponse:
properties:
balance:
@@ -4108,6 +4157,28 @@ paths:
summary: List ledgers
tags:
- Finance
/super/v1/finance/recharge-codes/activate:
post:
consumes:
- application/json
description: Batch activate recharge codes
parameters:
- description: Activate form
in: body
name: form
required: true
schema:
$ref: '#/definitions/dto.RechargeCodeActivateForm'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/dto.RechargeCodeActivateResponse'
summary: Activate recharge codes
tags:
- Finance
/super/v1/health/overview:
get:
consumes:
@@ -5583,6 +5654,34 @@ paths:
summary: Get user wallet
tags:
- User
/super/v1/users/{id}/wallet/credit:
post:
consumes:
- application/json
description: Credit user wallet balance
parameters:
- description: User ID
format: int64
in: path
name: id
required: true
type: integer
- description: Credit form
in: body
name: form
required: true
schema:
$ref: '#/definitions/dto.SuperWalletCreditForm'
produces:
- application/json
responses:
"200":
description: OK
schema:
type: string
summary: Credit user wallet
tags:
- User
/super/v1/users/statistics:
get:
consumes:
@@ -6715,28 +6814,6 @@ paths:
summary: Upload part
tags:
- Common
/v1/t/{tenantCode}/webhook/payment/notify:
post:
consumes:
- application/json
description: Payment Webhook
parameters:
- description: Webhook Data
in: body
name: form
required: true
schema:
$ref: '#/definitions/dto.PaymentWebhookForm'
produces:
- application/json
responses:
"200":
description: success
schema:
type: string
summary: Payment Webhook
tags:
- Transaction
securityDefinitions:
BasicAuth:
type: basic