chore: regenerate swagger docs

This commit is contained in:
2026-01-12 15:44:15 +08:00
parent 4022a776a6
commit 2cf4d379a8
3 changed files with 738 additions and 96 deletions

View File

@@ -1908,7 +1908,7 @@
{
"type": "integer",
"format": "int64",
"description": "Tenant ID",
"description": "Creator User ID",
"name": "id",
"in": "path",
"required": true
@@ -3294,15 +3294,31 @@
"type": "object",
"properties": {
"content": {
"$ref": "#/definitions/dto.ContentItem"
"description": "Content 内容摘要信息。",
"allOf": [
{
"$ref": "#/definitions/dto.ContentItem"
}
]
},
"owner": {
"$ref": "#/definitions/dto.AdminContentOwnerLite"
"description": "Owner 内容作者用户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.AdminContentOwnerLite"
}
]
},
"price": {
"$ref": "#/definitions/dto.ContentPrice"
"description": "Price 内容价格信息。",
"allOf": [
{
"$ref": "#/definitions/dto.ContentPrice"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述(用于展示)。",
"type": "string"
},
"tenant": {
@@ -3314,6 +3330,7 @@
]
},
"visibility_description": {
"description": "VisibilityDescription 可见性描述(用于展示)。",
"type": "string"
}
}
@@ -3322,18 +3339,26 @@
"type": "object",
"properties": {
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"roles": {
"description": "Roles 用户角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.Role"
}
},
"status": {
"$ref": "#/definitions/consts.UserStatus"
"description": "Status 用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
@@ -4011,9 +4036,11 @@
"type": "object",
"properties": {
"id": {
"description": "ID 买家用户ID。",
"type": "integer"
},
"username": {
"description": "Username 买家用户名。",
"type": "string"
}
}
@@ -4074,15 +4101,18 @@
"type": "object",
"properties": {
"by_status": {
"description": "ByStatus 按状态聚合统计。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.OrderStatisticsRow"
}
},
"total_amount_paid_sum": {
"description": "TotalAmountPaidSum 实付总额(分)。",
"type": "integer"
},
"total_count": {
"description": "TotalCount 订单总数。",
"type": "integer"
}
}
@@ -4091,15 +4121,23 @@
"type": "object",
"properties": {
"amount_paid_sum": {
"description": "AmountPaidSum 该状态实付总额(分)。",
"type": "integer"
},
"count": {
"description": "Count 该状态订单数量。",
"type": "integer"
},
"status": {
"$ref": "#/definitions/consts.OrderStatus"
"description": "Status 订单状态。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述(用于展示)。",
"type": "string"
}
}
@@ -4117,12 +4155,15 @@
"type": "object",
"properties": {
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"id": {
"description": "ID 租户ID。",
"type": "integer"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
}
}
@@ -4254,12 +4295,15 @@
"type": "object",
"properties": {
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"id": {
"description": "ID 租户ID。",
"type": "integer"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
}
}
@@ -4268,10 +4312,15 @@
"type": "object",
"properties": {
"buyer": {
"$ref": "#/definitions/dto.OrderBuyerLite"
"description": "Buyer 订单买家信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderBuyerLite"
}
]
},
"order": {
"description": "Using SuperOrderItem as base, extend if needed",
"description": "Order 订单详细信息。",
"allOf": [
{
"$ref": "#/definitions/dto.SuperOrderItem"
@@ -4279,7 +4328,12 @@
]
},
"tenant": {
"$ref": "#/definitions/dto.OrderTenantLite"
"description": "Tenant 订单所属租户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderTenantLite"
}
]
}
}
},
@@ -4287,24 +4341,39 @@
"type": "object",
"properties": {
"amount_discount": {
"description": "AmountDiscount 优惠金额(分)。",
"type": "integer"
},
"amount_original": {
"description": "AmountOriginal 原价金额(分)。",
"type": "integer"
},
"amount_paid": {
"description": "AmountPaid 实付金额(分)。",
"type": "integer"
},
"buyer": {
"$ref": "#/definitions/dto.OrderBuyerLite"
"description": "Buyer 订单买家信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderBuyerLite"
}
]
},
"created_at": {
"description": "CreatedAt 创建时间RFC3339。",
"type": "string"
},
"currency": {
"$ref": "#/definitions/consts.Currency"
"description": "Currency 币种。",
"allOf": [
{
"$ref": "#/definitions/consts.Currency"
}
]
},
"id": {
"description": "ID 订单ID。",
"type": "integer"
},
"items": {
@@ -4315,27 +4384,46 @@
}
},
"paid_at": {
"description": "PaidAt 支付时间RFC3339。",
"type": "string"
},
"refunded_at": {
"description": "RefundedAt 退款时间RFC3339。",
"type": "string"
},
"snapshot": {
"description": "Snapshot 订单快照,包含下单时的关键参数与定价信息,便于审计回溯。"
},
"status": {
"$ref": "#/definitions/consts.OrderStatus"
"description": "Status 订单状态。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述(用于展示)。",
"type": "string"
},
"tenant": {
"$ref": "#/definitions/dto.OrderTenantLite"
"description": "Tenant 订单所属租户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.OrderTenantLite"
}
]
},
"type": {
"$ref": "#/definitions/consts.OrderType"
"description": "Type 订单类型。",
"allOf": [
{
"$ref": "#/definitions/consts.OrderType"
}
]
},
"updated_at": {
"description": "UpdatedAt 更新时间RFC3339。",
"type": "string"
}
}
@@ -4364,12 +4452,15 @@
"type": "object",
"properties": {
"force": {
"description": "Force 是否强制退款(忽略部分约束)。",
"type": "boolean"
},
"idempotency_key": {
"description": "IdempotencyKey 幂等键(防止重复提交)。",
"type": "string"
},
"reason": {
"description": "Reason 退款原因说明。",
"type": "string"
}
}
@@ -4381,6 +4472,7 @@
],
"properties": {
"status": {
"description": "Status 目标内容状态。",
"enum": [
"unpublished",
"blocked"
@@ -4397,10 +4489,20 @@
"type": "object",
"properties": {
"tenant_user": {
"$ref": "#/definitions/dto.TenantUser"
"description": "TenantUser 租户成员关系信息。",
"allOf": [
{
"$ref": "#/definitions/dto.TenantUser"
}
]
},
"user": {
"$ref": "#/definitions/dto.SuperUserLite"
"description": "User 用户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.SuperUserLite"
}
]
}
}
},
@@ -4408,30 +4510,42 @@
"type": "object",
"properties": {
"created_at": {
"description": "CreatedAt 创建时间RFC3339。",
"type": "string"
},
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"roles": {
"description": "Roles 用户角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.Role"
}
},
"status": {
"$ref": "#/definitions/consts.UserStatus"
"description": "Status 用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述(用于展示)。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间RFC3339。",
"type": "string"
},
"username": {
"description": "Username 用户名(用于识别/展示)。",
"type": "string"
},
"verified_at": {
"description": "VerifiedAt 实名认证时间RFC3339。",
"type": "string"
}
}
@@ -4440,9 +4554,11 @@
"type": "object",
"properties": {
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
@@ -4457,13 +4573,16 @@
],
"properties": {
"admin_user_id": {
"description": "AdminUserID 租户管理员用户ID。",
"type": "integer"
},
"code": {
"description": "Code 租户编码(唯一)。",
"type": "string",
"maxLength": 64
},
"duration": {
"description": "Duration 租户有效期(天)。",
"type": "integer",
"enum": [
7,
@@ -4474,6 +4593,7 @@
]
},
"name": {
"description": "Name 租户名称。",
"type": "string",
"maxLength": 128
}
@@ -4486,6 +4606,7 @@
],
"properties": {
"duration": {
"description": "Duration 延长有效期(天)。",
"type": "integer",
"enum": [
7,
@@ -4501,61 +4622,84 @@
"type": "object",
"properties": {
"admin_users": {
"description": "AdminUsers 租户管理员列表。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.TenantAdminUserLite"
}
},
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"config": {
"description": "Replace with actual config struct if needed",
"description": "Config 租户配置项(占位/需要结构化时替换)。",
"type": "array",
"items": {
"type": "integer"
}
},
"created_at": {
"description": "CreatedAt 创建时间RFC3339。",
"type": "string"
},
"expired_at": {
"description": "ExpiredAt 租户过期时间RFC3339。",
"type": "string"
},
"id": {
"description": "ID 租户ID。",
"type": "integer"
},
"income_amount_paid_sum": {
"description": "IncomeAmountPaidSum 累计实收金额(分)。",
"type": "integer"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
},
"owner": {
"$ref": "#/definitions/dto.TenantOwnerUserLite"
"description": "Owner 租户所有者信息。",
"allOf": [
{
"$ref": "#/definitions/dto.TenantOwnerUserLite"
}
]
},
"status": {
"$ref": "#/definitions/consts.TenantStatus"
"description": "Status 租户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantStatus"
}
]
},
"status_description": {
"description": "StatusDescription 租户状态描述。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间RFC3339。",
"type": "string"
},
"user_count": {
"description": "UserCount 租户成员数量。",
"type": "integer"
},
"user_id": {
"description": "UserID 创建者用户ID。",
"type": "integer"
},
"users": {
"description": "Users 租户成员列表(用于详情展示)。",
"type": "array",
"items": {
"$ref": "#/definitions/dto.SuperUserLite"
}
},
"uuid": {
"description": "UUID 租户UUID。",
"type": "string"
}
}
@@ -4564,9 +4708,11 @@
"type": "object",
"properties": {
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"username": {
"description": "Username 用户名。",
"type": "string"
}
}
@@ -4623,7 +4769,12 @@
],
"properties": {
"status": {
"$ref": "#/definitions/consts.TenantStatus"
"description": "Status 目标租户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantStatus"
}
]
}
}
},
@@ -4631,27 +4782,38 @@
"type": "object",
"properties": {
"created_at": {
"description": "CreatedAt 创建时间RFC3339。",
"type": "string"
},
"id": {
"description": "ID 成员记录ID。",
"type": "integer"
},
"role": {
"description": "Role 成员角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.TenantUserRole"
}
},
"status": {
"$ref": "#/definitions/consts.UserStatus"
"description": "Status 成员状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"updated_at": {
"description": "UpdatedAt 更新时间RFC3339。",
"type": "string"
},
"user_id": {
"description": "UserID 用户ID。",
"type": "integer"
}
}
@@ -4831,42 +4993,58 @@
"type": "object",
"properties": {
"balance": {
"description": "Balance 账户可用余额(分)。",
"type": "integer"
},
"balance_frozen": {
"description": "BalanceFrozen 账户冻结余额(分)。",
"type": "integer"
},
"created_at": {
"description": "CreatedAt 创建时间RFC3339。",
"type": "string"
},
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"joined_tenant_count": {
"description": "JoinedTenantCount 加入的租户数量。",
"type": "integer"
},
"owned_tenant_count": {
"description": "OwnedTenantCount 拥有的租户数量。",
"type": "integer"
},
"roles": {
"description": "Roles 用户角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.Role"
}
},
"status": {
"$ref": "#/definitions/consts.UserStatus"
"description": "Status 用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述(用于展示)。",
"type": "string"
},
"updated_at": {
"description": "UpdatedAt 更新时间RFC3339。",
"type": "string"
},
"username": {
"description": "Username 用户名(用于识别/展示)。",
"type": "string"
},
"verified_at": {
"description": "VerifiedAt 实名认证时间RFC3339。",
"type": "string"
}
}
@@ -4878,6 +5056,7 @@
],
"properties": {
"roles": {
"description": "Roles 目标角色列表(至少包含 1 个)。",
"type": "array",
"minItems": 1,
"items": {
@@ -4890,12 +5069,19 @@
"type": "object",
"properties": {
"count": {
"description": "Count 该状态用户数量。",
"type": "integer"
},
"status": {
"$ref": "#/definitions/consts.UserStatus"
"description": "Status 用户状态枚举。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"status_description": {
"description": "StatusDescription 状态描述(用于展示)。",
"type": "string"
}
}
@@ -4907,7 +5093,12 @@
],
"properties": {
"status": {
"$ref": "#/definitions/consts.UserStatus"
"description": "Status 目标用户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
}
}
},
@@ -4915,39 +5106,62 @@
"type": "object",
"properties": {
"code": {
"description": "Code 租户编码。",
"type": "string"
},
"expired_at": {
"description": "ExpiredAt 租户过期时间RFC3339。",
"type": "string"
},
"joined_at": {
"description": "JoinedAt 加入时间RFC3339。",
"type": "string"
},
"member_status": {
"$ref": "#/definitions/consts.UserStatus"
"description": "MemberStatus 成员状态。",
"allOf": [
{
"$ref": "#/definitions/consts.UserStatus"
}
]
},
"member_status_description": {
"description": "MemberStatusDescription 成员状态描述。",
"type": "string"
},
"name": {
"description": "Name 租户名称。",
"type": "string"
},
"owner": {
"$ref": "#/definitions/dto.TenantOwnerUserLite"
"description": "Owner 租户所有者用户信息。",
"allOf": [
{
"$ref": "#/definitions/dto.TenantOwnerUserLite"
}
]
},
"role": {
"description": "Role 用户在该租户内的角色列表。",
"type": "array",
"items": {
"$ref": "#/definitions/consts.TenantUserRole"
}
},
"tenant_id": {
"description": "TenantID 租户ID。",
"type": "integer"
},
"tenant_status": {
"$ref": "#/definitions/consts.TenantStatus"
"description": "TenantStatus 租户状态。",
"allOf": [
{
"$ref": "#/definitions/consts.TenantStatus"
}
]
},
"tenant_status_description": {
"description": "TenantStatusDescription 租户状态描述。",
"type": "string"
}
}
@@ -5026,9 +5240,11 @@
"type": "object",
"properties": {
"city": {
"description": "City 城市名称。",
"type": "string"
},
"province": {
"description": "Province 省份名称。",
"type": "string"
}
}
@@ -5037,9 +5253,11 @@
"type": "object",
"properties": {
"password": {
"description": "Password 登录密码(加密传输)。",
"type": "string"
},
"username": {
"description": "Username 登录用户名。",
"type": "string"
}
}
@@ -5048,10 +5266,16 @@
"type": "object",
"properties": {
"token": {
"description": "Token 登录后签发的 JWT。",
"type": "string"
},
"user": {
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.User"
"description": "User 当前登录用户信息。",
"allOf": [
{
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.User"
}
]
}
}
},
@@ -5059,37 +5283,55 @@
"type": "object",
"properties": {
"avatar": {
"description": "Avatar 头像URL。",
"type": "string"
},
"balance": {
"description": "Balance 账户余额(元)。",
"type": "number"
},
"bio": {
"description": "Bio 用户简介。",
"type": "string"
},
"birthday": {
"description": "YYYY-MM-DD",
"description": "Birthday 生日(YYYY-MM-DD)。",
"type": "string"
},
"gender": {
"$ref": "#/definitions/consts.Gender"
"description": "Gender 性别male/female/secret。",
"allOf": [
{
"$ref": "#/definitions/consts.Gender"
}
]
},
"id": {
"description": "ID 用户ID。",
"type": "integer"
},
"is_real_name_verified": {
"description": "IsRealNameVerified 是否已实名认证。",
"type": "boolean"
},
"location": {
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.Location"
"description": "Location 所在地(省/市)。",
"allOf": [
{
"$ref": "#/definitions/quyun_v2_app_http_super_v1_dto.Location"
}
]
},
"nickname": {
"description": "Nickname 用户昵称。",
"type": "string"
},
"phone": {
"description": "Phone 手机号。",
"type": "string"
},
"points": {
"description": "Points 用户积分。",
"type": "integer"
}
}