fix: regenerate api routes and swagger documentation

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

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
2026-02-04 14:58:01 +08:00
parent 0fe4344b3b
commit 33ad8c544e
4 changed files with 566 additions and 0 deletions

View File

@@ -163,6 +163,28 @@ func (r *Routes) Register(router fiber.Router) {
QueryParam[string]("expires"),
QueryParam[string]("sign"),
))
// Register routes for controller: Transaction
r.log.Debugf("Registering route: Get /v1/t/:tenantCode/orders/:id<int>/status -> transaction.Status")
router.Get("/v1/t/:tenantCode/orders/:id<int>/status"[len(r.Path()):], DataFunc1(
r.transaction.Status,
PathParam[int64]("id"),
))
r.log.Debugf("Registering route: Post /v1/t/:tenantCode/orders -> transaction.Create")
router.Post("/v1/t/:tenantCode/orders"[len(r.Path()):], DataFunc1(
r.transaction.Create,
Body[dto.OrderCreateForm]("form"),
))
r.log.Debugf("Registering route: Post /v1/t/:tenantCode/orders/:id<int>/pay -> transaction.Pay")
router.Post("/v1/t/:tenantCode/orders/:id<int>/pay"[len(r.Path()):], DataFunc2(
r.transaction.Pay,
PathParam[int64]("id"),
Body[dto.OrderPayForm]("form"),
))
r.log.Debugf("Registering route: Post /v1/t/:tenantCode/webhook/payment/notify -> transaction.Webhook")
router.Post("/v1/t/:tenantCode/webhook/payment/notify"[len(r.Path()):], DataFunc1(
r.transaction.Webhook,
Body[dto.PaymentWebhookForm]("form"),
))
// Register routes for controller: User
r.log.Debugf("Registering route: Delete /v1/t/:tenantCode/me/favorites/:contentId<int> -> user.RemoveFavorite")
router.Delete("/v1/t/:tenantCode/me/favorites/:contentId<int>"[len(r.Path()):], Func2(

View File

@@ -4871,6 +4871,115 @@ const docTemplate = `{
}
}
},
"/v1/t/{tenantCode}/orders": {
"post": {
"description": "创建订单",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Create Order",
"parameters": [
{
"description": "订单创建参数",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.OrderCreateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OrderCreateResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/orders/{id}/pay": {
"post": {
"description": "支付订单",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Pay Order",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "订单ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "支付参数",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.OrderPayForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OrderPayResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/orders/{id}/status": {
"get": {
"description": "查询订单状态",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Order Status",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "订单ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OrderStatusResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/storage/{any}": {
"get": {
"consumes": [
@@ -5196,6 +5305,40 @@ 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": {
@@ -6140,6 +6283,58 @@ const docTemplate = `{
}
}
},
"dto.OrderCreateForm": {
"type": "object",
"properties": {
"content_id": {
"description": "ContentID 内容ID。",
"type": "integer"
},
"idempotency_key": {
"description": "IdempotencyKey 幂等键(同一业务请求需保持一致)。",
"type": "string"
},
"quantity": {
"description": "Quantity 购买数量(默认 1。",
"type": "integer"
},
"sku": {
"description": "Sku 规格标识(可选)。",
"type": "string"
},
"user_coupon_id": {
"description": "UserCouponID 用户券ID可选。",
"type": "integer"
}
}
},
"dto.OrderCreateResponse": {
"type": "object",
"properties": {
"order_id": {
"description": "OrderID 创建成功的订单ID。",
"type": "integer"
}
}
},
"dto.OrderPayForm": {
"type": "object",
"properties": {
"method": {
"description": "Method 支付方式alipay/balance。",
"type": "string"
}
}
},
"dto.OrderPayResponse": {
"type": "object",
"properties": {
"pay_params": {
"description": "PayParams 支付参数(透传给前端)。",
"type": "string"
}
}
},
"dto.OrderStatisticsResponse": {
"type": "object",
"properties": {
@@ -6185,6 +6380,15 @@ const docTemplate = `{
}
}
},
"dto.OrderStatusResponse": {
"type": "object",
"properties": {
"status": {
"description": "Status 订单状态unpaid/paid/completed 等)。",
"type": "string"
}
}
},
"dto.OrderTenantLite": {
"type": "object",
"properties": {

View File

@@ -4865,6 +4865,115 @@
}
}
},
"/v1/t/{tenantCode}/orders": {
"post": {
"description": "创建订单",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Create Order",
"parameters": [
{
"description": "订单创建参数",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.OrderCreateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OrderCreateResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/orders/{id}/pay": {
"post": {
"description": "支付订单",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Pay Order",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "订单ID",
"name": "id",
"in": "path",
"required": true
},
{
"description": "支付参数",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.OrderPayForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OrderPayResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/orders/{id}/status": {
"get": {
"description": "查询订单状态",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Transaction"
],
"summary": "Order Status",
"parameters": [
{
"type": "integer",
"format": "int64",
"description": "订单ID",
"name": "id",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.OrderStatusResponse"
}
}
}
}
},
"/v1/t/{tenantCode}/storage/{any}": {
"get": {
"consumes": [
@@ -5190,6 +5299,40 @@
}
}
}
},
"/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": {
@@ -6134,6 +6277,58 @@
}
}
},
"dto.OrderCreateForm": {
"type": "object",
"properties": {
"content_id": {
"description": "ContentID 内容ID。",
"type": "integer"
},
"idempotency_key": {
"description": "IdempotencyKey 幂等键(同一业务请求需保持一致)。",
"type": "string"
},
"quantity": {
"description": "Quantity 购买数量(默认 1。",
"type": "integer"
},
"sku": {
"description": "Sku 规格标识(可选)。",
"type": "string"
},
"user_coupon_id": {
"description": "UserCouponID 用户券ID可选。",
"type": "integer"
}
}
},
"dto.OrderCreateResponse": {
"type": "object",
"properties": {
"order_id": {
"description": "OrderID 创建成功的订单ID。",
"type": "integer"
}
}
},
"dto.OrderPayForm": {
"type": "object",
"properties": {
"method": {
"description": "Method 支付方式alipay/balance。",
"type": "string"
}
}
},
"dto.OrderPayResponse": {
"type": "object",
"properties": {
"pay_params": {
"description": "PayParams 支付参数(透传给前端)。",
"type": "string"
}
}
},
"dto.OrderStatisticsResponse": {
"type": "object",
"properties": {
@@ -6179,6 +6374,15 @@
}
}
},
"dto.OrderStatusResponse": {
"type": "object",
"properties": {
"status": {
"description": "Status 订单状态unpaid/paid/completed 等)。",
"type": "string"
}
}
},
"dto.OrderTenantLite": {
"type": "object",
"properties": {

View File

@@ -687,6 +687,42 @@ definitions:
description: Username 买家用户名。
type: string
type: object
dto.OrderCreateForm:
properties:
content_id:
description: ContentID 内容ID。
type: integer
idempotency_key:
description: IdempotencyKey 幂等键(同一业务请求需保持一致)。
type: string
quantity:
description: Quantity 购买数量(默认 1
type: integer
sku:
description: Sku 规格标识(可选)。
type: string
user_coupon_id:
description: UserCouponID 用户券ID可选
type: integer
type: object
dto.OrderCreateResponse:
properties:
order_id:
description: OrderID 创建成功的订单ID。
type: integer
type: object
dto.OrderPayForm:
properties:
method:
description: Method 支付方式alipay/balance
type: string
type: object
dto.OrderPayResponse:
properties:
pay_params:
description: PayParams 支付参数(透传给前端)。
type: string
type: object
dto.OrderStatisticsResponse:
properties:
by_status:
@@ -717,6 +753,12 @@ definitions:
description: StatusDescription 状态描述(用于展示)。
type: string
type: object
dto.OrderStatusResponse:
properties:
status:
description: Status 订单状态unpaid/paid/completed 等)。
type: string
type: object
dto.OrderTenantLite:
properties:
code:
@@ -6387,6 +6429,78 @@ paths:
summary: Delete media asset
tags:
- Common
/v1/t/{tenantCode}/orders:
post:
consumes:
- application/json
description: 创建订单
parameters:
- description: 订单创建参数
in: body
name: form
required: true
schema:
$ref: '#/definitions/dto.OrderCreateForm'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/dto.OrderCreateResponse'
summary: Create Order
tags:
- Transaction
/v1/t/{tenantCode}/orders/{id}/pay:
post:
consumes:
- application/json
description: 支付订单
parameters:
- description: 订单ID
format: int64
in: path
name: id
required: true
type: integer
- description: 支付参数
in: body
name: form
required: true
schema:
$ref: '#/definitions/dto.OrderPayForm'
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/dto.OrderPayResponse'
summary: Pay Order
tags:
- Transaction
/v1/t/{tenantCode}/orders/{id}/status:
get:
consumes:
- application/json
description: 查询订单状态
parameters:
- description: 订单ID
format: int64
in: path
name: id
required: true
type: integer
produces:
- application/json
responses:
"200":
description: OK
schema:
$ref: '#/definitions/dto.OrderStatusResponse'
summary: Order Status
tags:
- Transaction
/v1/t/{tenantCode}/storage/{any}:
get:
consumes:
@@ -6601,6 +6715,28 @@ 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