quyun-v2/backend/docs/swagger.yaml

basePath: /
definitions:
  consts.ContentAccessStatus:
    enum:
    - active
    - revoked
    - expired
    type: string
    x-enum-varnames:
    - ContentAccessStatusActive
    - ContentAccessStatusRevoked
    - ContentAccessStatusExpired
  consts.ContentStatus:
    enum:
    - draft
    - reviewing
    - published
    - unpublished
    - blocked
    type: string
    x-enum-varnames:
    - ContentStatusDraft
    - ContentStatusReviewing
    - ContentStatusPublished
    - ContentStatusUnpublished
    - ContentStatusBlocked
  consts.CouponType:
    enum:
    - fix_amount
    - discount
    type: string
    x-enum-varnames:
    - CouponTypeFixAmount
    - CouponTypeDiscount
  consts.Currency:
    enum:
    - CNY
    type: string
    x-enum-varnames:
    - CurrencyCNY
  consts.Gender:
    enum:
    - male
    - female
    - secret
    type: string
    x-enum-varnames:
    - GenderMale
    - GenderFemale
    - GenderSecret
  consts.MediaAssetStatus:
    enum:
    - uploaded
    - processing
    - ready
    - failed
    - deleted
    type: string
    x-enum-varnames:
    - MediaAssetStatusUploaded
    - MediaAssetStatusProcessing
    - MediaAssetStatusReady
    - MediaAssetStatusFailed
    - MediaAssetStatusDeleted
  consts.MediaAssetType:
    enum:
    - video
    - audio
    - image
    type: string
    x-enum-varnames:
    - MediaAssetTypeVideo
    - MediaAssetTypeAudio
    - MediaAssetTypeImage
  consts.MediaAssetVariant:
    enum:
    - main
    - preview
    type: string
    x-enum-varnames:
    - MediaAssetVariantMain
    - MediaAssetVariantPreview
  consts.NotificationType:
    enum:
    - system
    - order
    - audit
    - interaction
    type: string
    x-enum-varnames:
    - NotificationTypeSystem
    - NotificationTypeOrder
    - NotificationTypeAudit
    - NotificationTypeInteraction
  consts.OrderStatus:
    enum:
    - created
    - paid
    - refunding
    - refunded
    - canceled
    - failed
    type: string
    x-enum-varnames:
    - OrderStatusCreated
    - OrderStatusPaid
    - OrderStatusRefunding
    - OrderStatusRefunded
    - OrderStatusCanceled
    - OrderStatusFailed
  consts.OrderType:
    enum:
    - content_purchase
    - recharge
    - withdrawal
    type: string
    x-enum-varnames:
    - OrderTypeContentPurchase
    - OrderTypeRecharge
    - OrderTypeWithdrawal
  consts.PayoutAccountStatus:
    enum:
    - pending
    - approved
    - rejected
    type: string
    x-enum-varnames:
    - PayoutAccountStatusPending
    - PayoutAccountStatusApproved
    - PayoutAccountStatusRejected
  consts.Role:
    enum:
    - user
    - super_admin
    - creator
    type: string
    x-enum-varnames:
    - RoleUser
    - RoleSuperAdmin
    - RoleCreator
  consts.TenantLedgerType:
    enum:
    - debit_purchase
    - credit_refund
    - credit_withdrawal
    - freeze
    - unfreeze
    - adjustment
    type: string
    x-enum-varnames:
    - TenantLedgerTypeDebitPurchase
    - TenantLedgerTypeCreditRefund
    - TenantLedgerTypeCreditWithdrawal
    - TenantLedgerTypeFreeze
    - TenantLedgerTypeUnfreeze
    - TenantLedgerTypeAdjustment
  consts.TenantStatus:
    enum:
    - pending_verify
    - verified
    - banned
    type: string
    x-enum-varnames:
    - TenantStatusPendingVerify
    - TenantStatusVerified
    - TenantStatusBanned
  consts.TenantUserRole:
    enum:
    - member
    - tenant_admin
    type: string
    x-enum-varnames:
    - TenantUserRoleMember
    - TenantUserRoleTenantAdmin
  consts.UserContentActionType:
    enum:
    - like
    - favorite
    type: string
    x-enum-varnames:
    - UserContentActionTypeLike
    - UserContentActionTypeFavorite
  consts.UserCouponStatus:
    enum:
    - unused
    - used
    - expired
    type: string
    x-enum-varnames:
    - UserCouponStatusUnused
    - UserCouponStatusUsed
    - UserCouponStatusExpired
  consts.UserStatus:
    enum:
    - active
    - inactive
    - pending_verify
    - verified
    - banned
    type: string
    x-enum-varnames:
    - UserStatusActive
    - UserStatusInactive
    - UserStatusPendingVerify
    - UserStatusVerified
    - UserStatusBanned
  dto.AdminContentItem:
    properties:
      content:
        allOf:
        - $ref: '#/definitions/dto.ContentItem'
        description: Content 内容摘要信息。
      owner:
        allOf:
        - $ref: '#/definitions/dto.AdminContentOwnerLite'
        description: Owner 内容作者用户信息。
      price:
        allOf:
        - $ref: '#/definitions/dto.ContentPrice'
        description: Price 内容价格信息。
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
      tenant:
        allOf:
        - $ref: '#/definitions/dto.SuperContentTenantLite'
        description: Tenant 内容所属租户信息，用于超管列表展示与跳转。
      visibility_description:
        description: VisibilityDescription 可见性描述（用于展示）。
        type: string
    type: object
  dto.AdminContentOwnerLite:
    properties:
      id:
        description: ID 用户ID。
        type: integer
      roles:
        description: Roles 用户角色列表。
        items:
          $ref: '#/definitions/consts.Role'
        type: array
      status:
        allOf:
        - $ref: '#/definitions/consts.UserStatus'
        description: Status 用户状态。
      username:
        description: Username 用户名。
        type: string
    type: object
  dto.Comment:
    properties:
      content:
        description: Content 评论内容。
        type: string
      create_time:
        description: CreateTime 评论创建时间（RFC3339）。
        type: string
      id:
        description: ID 评论ID。
        type: integer
      is_liked:
        description: IsLiked 当前用户是否点赞该评论。
        type: boolean
      likes:
        description: Likes 评论点赞数。
        type: integer
      reply_to:
        description: ReplyTo 回复的评论ID（0 表示一级评论）。
        type: integer
      user_avatar:
        description: UserAvatar 评论用户头像。
        type: string
      user_id:
        description: UserID 评论用户ID。
        type: integer
      user_nickname:
        description: UserNickname 评论用户昵称。
        type: string
    type: object
  dto.CommentCreateForm:
    properties:
      content:
        description: Content 评论正文，不能为空。
        type: string
      reply_to:
        description: ReplyTo 被回复评论ID（0 表示一级评论）。
        type: integer
    type: object
  dto.ContentDetail:
    properties:
      author_avatar:
        description: AuthorAvatar 作者头像URL。
        type: string
      author_id:
        description: AuthorID 作者用户ID。
        type: integer
      author_is_following:
        description: AuthorIsFollowing 当前用户是否关注作者（未登录默认 false）。
        type: boolean
      author_name:
        description: AuthorName 作者展示名（优先昵称）。
        type: string
      body:
        description: Body 详细正文/图文内容（文章类可为空）。
        type: string
      cover:
        description: Cover 封面URL（无封面时为空）。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339 格式）。
        type: string
      description:
        description: Description 内容描述（用于详情页摘要）。
        type: string
      genre:
        description: Genre 内容分类/风格标签。
        type: string
      id:
        description: ID 内容唯一ID。
        type: integer
      is_favorited:
        description: IsFavorited 当前用户是否收藏。
        type: boolean
      is_liked:
        description: IsLiked 当前用户是否点赞。
        type: boolean
      is_purchased:
        description: IsPurchased 是否已购买（用于内容列表快速判断）。
        type: boolean
      likes:
        description: Likes 点赞数统计。
        type: integer
      media_urls:
        description: MediaUrls 关联媒体资源（音频/视频/预览）。
        items:
          $ref: '#/definitions/dto.MediaURL'
        type: array
      meta:
        allOf:
        - $ref: '#/definitions/dto.Meta'
        description: Meta 内容元信息（曲风/调性/节拍等）。
      price:
        description: Price 价格（单位元，免费为 0）。
        type: number
      published_at:
        description: PublishedAt 发布时间，未发布为空。
        type: string
      status:
        description: Status 内容状态（如 published/unpublished）。
        type: string
      tenant_id:
        description: TenantID 内容所属租户ID。
        type: integer
      title:
        description: Title 内容标题。
        type: string
      type:
        description: Type 内容媒体类型（video/audio/article）。
        type: string
      user_id:
        description: UserID 内容作者用户ID（与 author_id 同义，便于后台展示）。
        type: integer
      views:
        description: Views 浏览量统计。
        type: integer
      visibility:
        description: Visibility 内容可见性（如 public/tenant_only/private）。
        type: string
    type: object
  dto.ContentItem:
    properties:
      author_avatar:
        description: AuthorAvatar 作者头像URL。
        type: string
      author_id:
        description: AuthorID 作者用户ID。
        type: integer
      author_is_following:
        description: AuthorIsFollowing 当前用户是否关注作者（未登录默认 false）。
        type: boolean
      author_name:
        description: AuthorName 作者展示名（优先昵称）。
        type: string
      cover:
        description: Cover 封面URL（无封面时为空）。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339 格式）。
        type: string
      genre:
        description: Genre 内容分类/风格标签。
        type: string
      id:
        description: ID 内容唯一ID。
        type: integer
      is_purchased:
        description: IsPurchased 是否已购买（用于内容列表快速判断）。
        type: boolean
      likes:
        description: Likes 点赞数统计。
        type: integer
      price:
        description: Price 价格（单位元，免费为 0）。
        type: number
      published_at:
        description: PublishedAt 发布时间，未发布为空。
        type: string
      status:
        description: Status 内容状态（如 published/unpublished）。
        type: string
      tenant_id:
        description: TenantID 内容所属租户ID。
        type: integer
      title:
        description: Title 内容标题。
        type: string
      type:
        description: Type 内容媒体类型（video/audio/article）。
        type: string
      user_id:
        description: UserID 内容作者用户ID（与 author_id 同义，便于后台展示）。
        type: integer
      views:
        description: Views 浏览量统计。
        type: integer
      visibility:
        description: Visibility 内容可见性（如 public/tenant_only/private）。
        type: string
    type: object
  dto.ContentPrice:
    properties:
      currency:
        description: Currency 币种（CNY 等）。
        type: string
      discount_end_at:
        description: DiscountEndAt 折扣结束时间（RFC3339）。
        type: string
      discount_start_at:
        description: DiscountStartAt 折扣开始时间（RFC3339）。
        type: string
      discount_type:
        description: DiscountType 折扣类型（amount/percent）。
        type: string
      discount_value:
        description: DiscountValue 折扣值（amount=元，percent=百分比）。
        type: number
      price_amount:
        description: PriceAmount 原价金额（单位元）。
        type: number
    type: object
  dto.CouponCreateForm:
    properties:
      description:
        description: Description 优惠券描述。
        type: string
      end_at:
        description: EndAt 过期时间（RFC3339，可为空）。
        type: string
      max_discount:
        description: MaxDiscount 折扣券最高抵扣金额（分）。
        type: integer
      min_order_amount:
        description: MinOrderAmount 使用门槛金额（分）。
        type: integer
      start_at:
        description: StartAt 生效时间（RFC3339，可为空）。
        type: string
      title:
        description: Title 优惠券标题。
        type: string
      total_quantity:
        description: TotalQuantity 发行总量（0 表示不限量）。
        type: integer
      type:
        description: Type 优惠券类型（fix_amount/discount）。
        type: string
      value:
        description: Value 优惠券面值（分/折扣百分比）。
        type: integer
    type: object
  dto.CouponGrantForm:
    properties:
      user_ids:
        description: UserIDs 领取用户ID集合。
        items:
          type: integer
        type: array
    type: object
  dto.CouponItem:
    properties:
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      description:
        description: Description 优惠券描述。
        type: string
      end_at:
        description: EndAt 过期时间（RFC3339）。
        type: string
      id:
        description: ID 券模板ID。
        type: integer
      max_discount:
        description: MaxDiscount 折扣券最高抵扣金额（分）。
        type: integer
      min_order_amount:
        description: MinOrderAmount 使用门槛金额（分）。
        type: integer
      start_at:
        description: StartAt 生效时间（RFC3339）。
        type: string
      title:
        description: Title 优惠券标题。
        type: string
      total_quantity:
        description: TotalQuantity 发行总量。
        type: integer
      type:
        description: Type 优惠券类型（fix_amount/discount）。
        type: string
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      used_quantity:
        description: UsedQuantity 已使用数量。
        type: integer
      value:
        description: Value 优惠券面值（分/折扣百分比）。
        type: integer
    type: object
  dto.CouponReceiveForm:
    properties:
      coupon_id:
        description: CouponID 券模板ID。
        type: integer
    type: object
  dto.CouponUpdateForm:
    properties:
      description:
        description: Description 优惠券描述（为空表示不修改）。
        type: string
      end_at:
        description: EndAt 过期时间（RFC3339，可为空）。
        type: string
      max_discount:
        description: MaxDiscount 折扣券最高抵扣金额（分）。
        type: integer
      min_order_amount:
        description: MinOrderAmount 使用门槛金额（分）。
        type: integer
      start_at:
        description: StartAt 生效时间（RFC3339，可为空）。
        type: string
      title:
        description: Title 优惠券标题（为空表示不修改）。
        type: string
      total_quantity:
        description: TotalQuantity 发行总量（0 表示不限量）。
        type: integer
      type:
        description: Type 优惠券类型（fix_amount/discount）。
        type: string
      value:
        description: Value 优惠券面值（分/折扣百分比）。
        type: integer
    type: object
  dto.MediaURL:
    properties:
      duration:
        description: Duration 媒体时长（秒），无时长则为 0。
        type: integer
      type:
        description: Type 媒体类型（audio/video/image/preview）。
        type: string
      url:
        description: URL 媒体资源地址。
        type: string
    type: object
  dto.Meta:
    properties:
      beat:
        description: Beat 节拍信息（如 4/4）。
        type: string
      key:
        description: Key 音乐调性或主音。
        type: string
      role:
        description: Role 内容角色/定位（如 demo/主稿）。
        type: string
    type: object
  dto.Notification:
    properties:
      content:
        description: Content 通知内容。
        type: string
      id:
        description: ID 通知ID。
        type: integer
      read:
        description: Read 是否已读。
        type: boolean
      time:
        description: Time 发送时间（RFC3339）。
        type: string
      title:
        description: Title 通知标题。
        type: string
      type:
        description: Type 通知类型（system/order/interaction）。
        type: string
    type: object
  dto.OptionsResponse:
    properties:
      content_genre:
        description: ContentGenre 内容类型/分类选项。
        items:
          $ref: '#/definitions/requests.KV'
        type: array
      content_status:
        description: ContentStatus 内容状态选项。
        items:
          $ref: '#/definitions/requests.KV'
        type: array
    type: object
  dto.Order:
    properties:
      amount:
        description: Amount 实付金额（单位元）。
        type: number
      buyer_avatar:
        description: BuyerAvatar 买家头像URL。
        type: string
      buyer_name:
        description: BuyerName 买家昵称。
        type: string
      cover:
        description: Cover 订单封面图。
        type: string
      create_time:
        description: CreateTime 创建时间（RFC3339）。
        type: string
      id:
        description: ID 订单ID。
        type: integer
      is_virtual:
        description: IsVirtual 是否虚拟订单。
        type: boolean
      items:
        description: Items 订单内容明细。
        items:
          $ref: '#/definitions/dto.ContentItem'
        type: array
      pay_time:
        description: PayTime 支付时间（RFC3339）。
        type: string
      quantity:
        description: Quantity 内容数量。
        type: integer
      status:
        description: Status 订单状态。
        type: string
      status_description:
        description: StatusDescription 订单状态描述。
        type: string
      tenant_id:
        description: TenantID 内容所属租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      title:
        description: Title 订单标题（用于列表展示）。
        type: string
      type:
        description: Type 订单类型（内容购买/充值等）。
        type: string
      type_description:
        description: TypeDescription 订单类型描述。
        type: string
    type: object
  dto.OrderBuyerLite:
    properties:
      id:
        description: ID 买家用户ID。
        type: integer
      username:
        description: Username 买家用户名。
        type: string
    type: object
  dto.OrderStatisticsResponse:
    properties:
      by_status:
        description: ByStatus 按状态聚合统计。
        items:
          $ref: '#/definitions/dto.OrderStatisticsRow'
        type: array
      total_amount_paid_sum:
        description: TotalAmountPaidSum 实付总额（分）。
        type: integer
      total_count:
        description: TotalCount 订单总数。
        type: integer
    type: object
  dto.OrderStatisticsRow:
    properties:
      amount_paid_sum:
        description: AmountPaidSum 该状态实付总额（分）。
        type: integer
      count:
        description: Count 该状态订单数量。
        type: integer
      status:
        allOf:
        - $ref: '#/definitions/consts.OrderStatus'
        description: Status 订单状态。
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
    type: object
  dto.OrderTenantLite:
    properties:
      code:
        description: Code 租户编码。
        type: string
      id:
        description: ID 租户ID。
        type: integer
      name:
        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:
        description: IDCard 身份证号。
        type: string
      realname:
        description: Realname 真实姓名。
        type: string
    type: object
  dto.RechargeForm:
    properties:
      amount:
        description: Amount 充值金额（单位元）。
        type: number
      method:
        description: Method 充值方式（alipay）。
        type: string
    type: object
  dto.RechargeResponse:
    properties:
      order_id:
        description: OrderID 充值订单ID。
        type: integer
      pay_params:
        description: PayParams 支付参数（透传给前端）。
        type: string
    type: object
  dto.ReportExportResponse:
    properties:
      content:
        description: Content 导出内容（CSV 文本）。
        type: string
      filename:
        description: Filename 导出文件名。
        type: string
      mime_type:
        description: MimeType 导出内容类型。
        type: string
    type: object
  dto.ReportOverviewItem:
    properties:
      comment_count:
        description: CommentCount 当日新增评论数。
        type: integer
      content_created:
        description: ContentCreated 当日新增内容数。
        type: integer
      date:
        description: Date 日期（YYYY-MM-DD）。
        type: string
      favorite_actions:
        description: FavoriteActions 当日新增收藏数（基于互动记录）。
        type: integer
      like_actions:
        description: LikeActions 当日新增点赞数（基于互动记录）。
        type: integer
      paid_amount:
        description: PaidAmount 当日已支付金额（单位元）。
        type: number
      paid_orders:
        description: PaidOrders 当日已支付订单数。
        type: integer
      refund_amount:
        description: RefundAmount 当日退款金额（单位元）。
        type: number
      refund_orders:
        description: RefundOrders 当日退款订单数。
        type: integer
      withdrawal_apply_amount:
        description: WithdrawalApplyAmount 当日提现申请金额（单位元）。
        type: number
      withdrawal_apply_orders:
        description: WithdrawalApplyOrders 当日提现申请订单数。
        type: integer
      withdrawal_failed_amount:
        description: WithdrawalFailedAmount 当日提现失败金额（单位元）。
        type: number
      withdrawal_failed_orders:
        description: WithdrawalFailedOrders 当日提现失败订单数。
        type: integer
      withdrawal_paid_amount:
        description: WithdrawalPaidAmount 当日提现完成金额（单位元）。
        type: number
      withdrawal_paid_orders:
        description: WithdrawalPaidOrders 当日提现完成订单数。
        type: integer
    type: object
  dto.ReportOverviewResponse:
    properties:
      items:
        description: Items 按日期拆分的趋势数据。
        items:
          $ref: '#/definitions/dto.ReportOverviewItem'
        type: array
      summary:
        allOf:
        - $ref: '#/definitions/dto.ReportSummary'
        description: Summary 汇总指标。
    type: object
  dto.ReportSummary:
    properties:
      comment_count:
        description: CommentCount 统计区间内新增评论数。
        type: integer
      content_count:
        description: ContentCount 内容总量（当前快照）。
        type: integer
      content_created:
        description: ContentCreated 统计区间内新增内容数。
        type: integer
      conversion_rate:
        description: ConversionRate 转化率（已支付订单数 / 累计曝光）。
        type: number
      favorite_actions:
        description: FavoriteActions 统计区间内新增收藏数（基于互动记录）。
        type: integer
      like_actions:
        description: LikeActions 统计区间内新增点赞数（基于互动记录）。
        type: integer
      paid_amount:
        description: PaidAmount 统计区间内已支付金额（单位元）。
        type: number
      paid_orders:
        description: PaidOrders 统计区间内已支付订单数。
        type: integer
      refund_amount:
        description: RefundAmount 统计区间内退款金额（单位元）。
        type: number
      refund_orders:
        description: RefundOrders 统计区间内退款订单数。
        type: integer
      total_views:
        description: TotalViews 内容累计曝光（全量累计值，用于粗略换算）。
        type: integer
      withdrawal_apply_amount:
        description: WithdrawalApplyAmount 统计区间内提现申请金额（单位元）。
        type: number
      withdrawal_apply_orders:
        description: WithdrawalApplyOrders 统计区间内提现申请订单数。
        type: integer
      withdrawal_failed_amount:
        description: WithdrawalFailedAmount 统计区间内提现失败金额（单位元）。
        type: number
      withdrawal_failed_orders:
        description: WithdrawalFailedOrders 统计区间内提现失败订单数。
        type: integer
      withdrawal_paid_amount:
        description: WithdrawalPaidAmount 统计区间内提现完成金额（单位元）。
        type: number
      withdrawal_paid_orders:
        description: WithdrawalPaidOrders 统计区间内提现完成订单数。
        type: integer
    type: object
  dto.Settings:
    properties:
      avatar:
        description: Avatar 头像URL。
        type: string
      bio:
        description: Bio 频道简介。
        type: string
      cover:
        description: Cover 封面图URL。
        type: string
      description:
        description: Description 详细描述。
        type: string
      id:
        description: ID 租户/频道ID。
        type: integer
      name:
        description: Name 频道名称。
        type: string
    type: object
  dto.Stats:
    properties:
      contents:
        description: Contents 内容数。
        type: integer
      followers:
        description: Followers 粉丝数。
        type: integer
      likes:
        description: Likes 累计点赞数。
        type: integer
    type: object
  dto.SuperAssetItem:
    properties:
      bucket:
        description: Bucket 存储桶名称。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      filename:
        description: Filename 原始文件名。
        type: string
      hash:
        description: Hash 文件哈希（MD5）。
        type: string
      id:
        description: ID 资产ID。
        type: integer
      object_key:
        description: ObjectKey 对象Key。
        type: string
      provider:
        description: Provider 存储提供方。
        type: string
      size:
        description: Size 文件大小（字节）。
        type: integer
      source_asset_id:
        description: SourceAssetID 源资产ID（用于变体关联）。
        type: integer
      status:
        allOf:
        - $ref: '#/definitions/consts.MediaAssetStatus'
        description: Status 处理状态。
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.MediaAssetType'
        description: Type 媒体类型。
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      url:
        description: URL 访问URL（若可用）。
        type: string
      used_count:
        description: UsedCount 被内容引用次数。
        type: integer
      user_id:
        description: UserID 上传用户ID。
        type: integer
      username:
        description: Username 上传用户名/昵称。
        type: string
      variant:
        allOf:
        - $ref: '#/definitions/consts.MediaAssetVariant'
        description: Variant 媒体变体（main/preview/cover 等）。
    type: object
  dto.SuperAssetUsageItem:
    properties:
      count:
        description: Count 该类型资产数量。
        type: integer
      total_size:
        description: TotalSize 该类型资产大小总和（字节）。
        type: integer
      type:
        allOf:
        - $ref: '#/definitions/consts.MediaAssetType'
        description: Type 媒体类型。
    type: object
  dto.SuperAssetUsageResponse:
    properties:
      by_type:
        description: ByType 按媒体类型汇总的用量统计。
        items:
          $ref: '#/definitions/dto.SuperAssetUsageItem'
        type: array
      total_count:
        description: TotalCount 资产总量。
        type: integer
      total_size:
        description: TotalSize 资产总大小（字节）。
        type: integer
    type: object
  dto.SuperAuditLogItem:
    properties:
      action:
        description: Action 动作标识。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      detail:
        description: Detail 操作详情。
        type: string
      id:
        description: ID 审计日志ID。
        type: integer
      operator_id:
        description: OperatorID 操作者用户ID。
        type: integer
      operator_name:
        description: OperatorName 操作者用户名/昵称。
        type: string
      target_id:
        description: TargetID 目标ID。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
    type: object
  dto.SuperBalanceAnomalyItem:
    properties:
      balance:
        description: Balance 可用余额（分）。
        type: integer
      balance_frozen:
        description: BalanceFrozen 冻结余额（分）。
        type: integer
      created_at:
        description: CreatedAt 用户创建时间（RFC3339）。
        type: string
      issue:
        description: Issue 异常类型标识。
        type: string
      issue_description:
        description: IssueDescription 异常描述说明。
        type: string
      user_id:
        description: UserID 用户ID。
        type: integer
      username:
        description: Username 用户名。
        type: string
    type: object
  dto.SuperCommentDeleteForm:
    properties:
      reason:
        description: Reason 删除原因（可选，用于审计记录）。
        type: string
    type: object
  dto.SuperCommentItem:
    properties:
      content:
        description: Content 评论内容。
        type: string
      content_id:
        description: ContentID 内容ID。
        type: integer
      content_title:
        description: ContentTitle 内容标题。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      deleted_at:
        description: DeletedAt 删除时间（RFC3339，未删除为空）。
        type: string
      id:
        description: ID 评论ID。
        type: integer
      is_deleted:
        description: IsDeleted 是否已删除。
        type: boolean
      likes:
        description: Likes 评论点赞数。
        type: integer
      reply_to:
        description: ReplyTo 回复评论ID（0 表示一级评论）。
        type: integer
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      user_id:
        description: UserID 评论用户ID。
        type: integer
      username:
        description: Username 评论用户名称。
        type: string
    type: object
  dto.SuperContentBatchReviewForm:
    properties:
      action:
        description: Action 审核动作（approve/reject）。
        enum:
        - approve
        - reject
        type: string
      content_ids:
        description: ContentIDs 待审核内容ID列表。
        items:
          type: integer
        minItems: 1
        type: array
      reason:
        description: Reason 审核说明（驳回时填写，便于作者修正）。
        type: string
    required:
    - action
    - content_ids
    type: object
  dto.SuperContentBatchStatusForm:
    properties:
      content_ids:
        description: ContentIDs 待处置内容ID列表。
        items:
          type: integer
        minItems: 1
        type: array
      reason:
        description: Reason 处置说明（可选，用于审计与通知作者）。
        type: string
      status:
        allOf:
        - $ref: '#/definitions/consts.ContentStatus'
        description: Status 目标内容状态（unpublished/blocked）。
        enum:
        - unpublished
        - blocked
    required:
    - content_ids
    - status
    type: object
  dto.SuperContentReportBatchProcessForm:
    properties:
      action:
        description: Action 处理动作（approve/reject）。
        enum:
        - approve
        - reject
        type: string
      content_action:
        description: ContentAction 内容处置动作（block/unpublish/ignore），仅在 approve 时生效。
        type: string
      reason:
        description: Reason 处理说明（可选，用于审计记录）。
        type: string
      report_ids:
        description: ReportIDs 待处理举报ID列表。
        items:
          type: integer
        minItems: 1
        type: array
    required:
    - action
    - report_ids
    type: object
  dto.SuperContentReportItem:
    properties:
      content_id:
        description: ContentID 内容ID。
        type: integer
      content_owner_id:
        description: ContentOwnerID 内容作者用户ID。
        type: integer
      content_owner_name:
        description: ContentOwnerName 内容作者用户名/昵称。
        type: string
      content_status:
        description: ContentStatus 内容状态。
        type: string
      content_title:
        description: ContentTitle 内容标题。
        type: string
      created_at:
        description: CreatedAt 举报时间（RFC3339）。
        type: string
      detail:
        description: Detail 举报描述。
        type: string
      handled_action:
        description: HandledAction 处理动作（block/unpublish/ignore）。
        type: string
      handled_at:
        description: HandledAt 处理时间（RFC3339）。
        type: string
      handled_by:
        description: HandledBy 处理人用户ID。
        type: integer
      handled_by_name:
        description: HandledByName 处理人用户名/昵称。
        type: string
      handled_reason:
        description: HandledReason 处理说明。
        type: string
      id:
        description: ID 举报ID。
        type: integer
      reason:
        description: Reason 举报原因。
        type: string
      reporter_id:
        description: ReporterID 举报人用户ID。
        type: integer
      reporter_name:
        description: ReporterName 举报人用户名/昵称。
        type: string
      status:
        description: Status 处理状态。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
    type: object
  dto.SuperContentReportProcessForm:
    properties:
      action:
        description: Action 处理动作（approve/reject）。
        type: string
      content_action:
        description: ContentAction 内容处置动作（block/unpublish/ignore），仅在 approve 时生效。
        type: string
      reason:
        description: Reason 处理说明（可选，用于审计记录）。
        type: string
    type: object
  dto.SuperContentReviewForm:
    properties:
      action:
        description: Action 审核动作（approve/reject）。
        enum:
        - approve
        - reject
        type: string
      reason:
        description: Reason 审核说明（驳回时填写，便于作者修正）。
        type: string
    required:
    - action
    type: object
  dto.SuperContentStatisticsResponse:
    properties:
      total_count:
        description: TotalCount 内容总量。
        type: integer
      trend:
        description: Trend 按天新增内容趋势。
        items:
          $ref: '#/definitions/dto.SuperContentTrendItem'
        type: array
    type: object
  dto.SuperContentTenantLite:
    properties:
      code:
        description: Code 租户编码。
        type: string
      id:
        description: ID 租户ID。
        type: integer
      name:
        description: Name 租户名称。
        type: string
    type: object
  dto.SuperContentTrendItem:
    properties:
      created_count:
        description: CreatedCount 当日新增内容数量。
        type: integer
      date:
        description: Date 日期（YYYY-MM-DD）。
        type: string
    type: object
  dto.SuperCouponGrantItem:
    properties:
      coupon_id:
        description: CouponID 优惠券ID。
        type: integer
      coupon_title:
        description: CouponTitle 优惠券标题。
        type: string
      created_at:
        description: CreatedAt 领取时间（RFC3339）。
        type: string
      id:
        description: ID 用户券ID。
        type: integer
      order_id:
        description: OrderID 使用订单ID。
        type: integer
      status:
        allOf:
        - $ref: '#/definitions/consts.UserCouponStatus'
        description: Status 用户券状态。
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      used_at:
        description: UsedAt 使用时间（RFC3339）。
        type: string
      user_id:
        description: UserID 用户ID。
        type: integer
      username:
        description: Username 用户名。
        type: string
    type: object
  dto.SuperCouponGrantResponse:
    properties:
      granted:
        description: Granted 实际发放数量。
        type: integer
    type: object
  dto.SuperCouponItem:
    properties:
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      description:
        description: Description 优惠券描述。
        type: string
      end_at:
        description: EndAt 结束时间（RFC3339）。
        type: string
      id:
        description: ID 优惠券ID。
        type: integer
      max_discount:
        description: MaxDiscount 最大折扣金额（折扣券）。
        type: integer
      min_order_amount:
        description: MinOrderAmount 最低订单金额门槛。
        type: integer
      start_at:
        description: StartAt 生效时间（RFC3339）。
        type: string
      status:
        description: Status 状态（active/expired/upcoming）。
        type: string
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      title:
        description: Title 优惠券标题。
        type: string
      total_quantity:
        description: TotalQuantity 总发行数量（0 表示不限量）。
        type: integer
      type:
        allOf:
        - $ref: '#/definitions/consts.CouponType'
        description: Type 优惠券类型。
      type_description:
        description: TypeDescription 类型描述（用于展示）。
        type: string
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      used_quantity:
        description: UsedQuantity 已使用数量。
        type: integer
      value:
        description: Value 优惠券面额/折扣值。
        type: integer
    type: object
  dto.SuperCouponRiskItem:
    properties:
      coupon_id:
        description: CouponID 优惠券ID。
        type: integer
      coupon_title:
        description: CouponTitle 优惠券标题。
        type: string
      created_at:
        description: CreatedAt 领取时间（RFC3339）。
        type: string
      id:
        description: ID 用户券ID。
        type: integer
      order_amount_paid:
        description: OrderAmountPaid 订单实付金额（分）。
        type: integer
      order_id:
        description: OrderID 使用订单ID。
        type: integer
      order_status:
        allOf:
        - $ref: '#/definitions/consts.OrderStatus'
        description: OrderStatus 订单状态。
      order_status_description:
        description: OrderStatusDescription 订单状态描述（用于展示）。
        type: string
      paid_at:
        description: PaidAt 订单支付时间（RFC3339）。
        type: string
      risk_reason:
        description: RiskReason 异常说明。
        type: string
      risk_type:
        description: RiskType 异常类型。
        type: string
      status:
        allOf:
        - $ref: '#/definitions/consts.UserCouponStatus'
        description: Status 用户券状态。
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      used_at:
        description: UsedAt 使用时间（RFC3339）。
        type: string
      user_id:
        description: UserID 用户ID。
        type: integer
      username:
        description: Username 用户名。
        type: string
    type: object
  dto.SuperCouponStatusUpdateForm:
    properties:
      status:
        description: Status 目标状态（frozen）。
        enum:
        - frozen
        type: string
    required:
    - status
    type: object
  dto.SuperCreatorApplicationReviewForm:
    properties:
      action:
        description: Action 审核动作（approve/reject）。
        enum:
        - approve
        - reject
        type: string
      reason:
        description: Reason 审核说明（可选，驳回时填写）。
        type: string
    required:
    - action
    type: object
  dto.SuperHealthAlertItem:
    properties:
      count:
        description: Count 关联数量（例如失败数、超时数）。
        type: integer
      detail:
        description: Detail 告警详情说明。
        type: string
      kind:
        description: Kind 告警类型（order_error_rate/upload_error_rate/upload_stuck/tenant_health）。
        type: string
      level:
        description: Level 告警级别（warning/risk）。
        type: string
      tenant_code:
        description: TenantCode 关联租户编码。
        type: string
      tenant_id:
        description: TenantID 关联租户ID（无则为 0）。
        type: integer
      tenant_name:
        description: TenantName 关联租户名称。
        type: string
      title:
        description: Title 告警标题。
        type: string
      updated_at:
        description: UpdatedAt 告警更新时间（RFC3339）。
        type: string
    type: object
  dto.SuperHealthOverviewResponse:
    properties:
      alerts:
        description: Alerts 健康告警列表。
        items:
          $ref: '#/definitions/dto.SuperHealthAlertItem'
        type: array
      end_at:
        description: EndAt 统计结束时间（RFC3339）。
        type: string
      order_failed:
        description: OrderFailed 失败订单数（统计区间内）。
        type: integer
      order_failed_rate:
        description: OrderFailedRate 失败率（失败订单数 / 总订单数）。
        type: number
      order_total:
        description: OrderTotal 订单总数（统计区间内）。
        type: integer
      start_at:
        description: StartAt 统计开始时间（RFC3339）。
        type: string
      storage_total_count:
        description: StorageTotalCount 资产总量（全量）。
        type: integer
      storage_total_size:
        description: StorageTotalSize 资产总大小（字节，全量）。
        type: integer
      tenant_id:
        description: TenantID 当前统计的租户ID（0 代表全平台）。
        type: integer
      tenant_risk_count:
        description: TenantRiskCount 健康风险租户数。
        type: integer
      tenant_total:
        description: TenantTotal 租户总数。
        type: integer
      tenant_warning_count:
        description: TenantWarningCount 健康预警租户数。
        type: integer
      upload_failed:
        description: UploadFailed 上传失败资产数（统计区间内）。
        type: integer
      upload_failed_rate:
        description: UploadFailedRate 上传失败率（失败资产数 / 总资产数）。
        type: number
      upload_processing_stuck:
        description: UploadProcessingStuck 处理超时资产数（processing 且超时）。
        type: integer
      upload_stuck_hours:
        description: UploadStuckHours 上传处理超时时长（小时）。
        type: integer
      upload_total:
        description: UploadTotal 上传资产总数（统计区间内）。
        type: integer
      upload_uploaded_stuck:
        description: UploadUploadedStuck 已上传但未进入处理的超时资产数（uploaded 且超时）。
        type: integer
    type: object
  dto.SuperLedgerItem:
    properties:
      amount:
        description: Amount 变动金额（分）。
        type: integer
      balance_after:
        description: BalanceAfter 变更后可用余额（分）。
        type: integer
      balance_before:
        description: BalanceBefore 变更前可用余额（分）。
        type: integer
      biz_ref_id:
        description: BizRefID 业务引用ID（可选）。
        type: integer
      biz_ref_type:
        description: BizRefType 业务引用类型（可选）。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      frozen_after:
        description: FrozenAfter 变更后冻结余额（分）。
        type: integer
      frozen_before:
        description: FrozenBefore 变更前冻结余额（分）。
        type: integer
      id:
        description: ID 流水ID。
        type: integer
      operator_user_id:
        description: OperatorUserID 操作者用户ID（0 表示系统）。
        type: integer
      order_id:
        description: OrderID 关联订单ID。
        type: integer
      remark:
        description: Remark 流水备注说明。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.TenantLedgerType'
        description: Type 流水类型。
      type_description:
        description: TypeDescription 流水类型描述（用于展示）。
        type: string
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      user_id:
        description: UserID 关联用户ID。
        type: integer
      username:
        description: Username 关联用户名。
        type: string
    type: object
  dto.SuperNotificationBroadcastForm:
    properties:
      content:
        description: Content 通知内容。
        type: string
      tenant_id:
        description: TenantID 租户ID（选填，用于指定租户成员）。
        type: integer
      title:
        description: Title 通知标题。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.NotificationType'
        description: Type 通知类型（system/order/audit/interaction）。
      user_ids:
        description: UserIDs 指定接收用户ID列表（优先级高于 TenantID）。
        items:
          type: integer
        type: array
    type: object
  dto.SuperNotificationItem:
    properties:
      content:
        description: Content 通知内容。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      id:
        description: ID 通知ID。
        type: integer
      is_read:
        description: IsRead 是否已读。
        type: boolean
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      title:
        description: Title 通知标题。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.NotificationType'
        description: Type 通知类型。
      user_id:
        description: UserID 用户ID。
        type: integer
      username:
        description: Username 用户名/昵称。
        type: string
    type: object
  dto.SuperNotificationTemplateCreateForm:
    properties:
      content:
        description: Content 通知内容。
        type: string
      is_active:
        description: IsActive 是否启用（不传默认启用）。
        type: boolean
      name:
        description: Name 模板名称（用于识别用途）。
        type: string
      tenant_id:
        description: TenantID 租户ID（不传代表全平台模板）。
        type: integer
      title:
        description: Title 通知标题。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.NotificationType'
        description: Type 通知类型（system/order/audit/interaction）。
    type: object
  dto.SuperNotificationTemplateItem:
    properties:
      content:
        description: Content 模板内容。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      id:
        description: ID 模板ID。
        type: integer
      is_active:
        description: IsActive 是否启用。
        type: boolean
      name:
        description: Name 模板名称。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      title:
        description: Title 模板标题。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.NotificationType'
        description: Type 通知类型。
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
    type: object
  dto.SuperNotificationTemplateUpdateForm:
    properties:
      content:
        description: Content 通知内容（可选）。
        type: string
      is_active:
        description: IsActive 是否启用（可选）。
        type: boolean
      name:
        description: Name 模板名称（可选）。
        type: string
      tenant_id:
        description: TenantID 租户ID（不传代表不修改租户归属）。
        type: integer
      title:
        description: Title 通知标题（可选）。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.NotificationType'
        description: Type 通知类型（system/order/audit/interaction，可选）。
    type: object
  dto.SuperOrderAnomalyItem:
    properties:
      amount_paid:
        description: AmountPaid 实付金额（分）。
        type: integer
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      issue:
        description: Issue 异常类型标识。
        type: string
      issue_description:
        description: IssueDescription 异常描述说明。
        type: string
      order_id:
        description: OrderID 订单ID。
        type: integer
      paid_at:
        description: PaidAt 支付时间（RFC3339）。
        type: string
      refunded_at:
        description: RefundedAt 退款时间（RFC3339）。
        type: string
      status:
        allOf:
        - $ref: '#/definitions/consts.OrderStatus'
        description: Status 订单状态。
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.OrderType'
        description: Type 订单类型。
      user_id:
        description: UserID 用户ID。
        type: integer
      username:
        description: Username 用户名。
        type: string
    type: object
  dto.SuperOrderDetail:
    properties:
      buyer:
        allOf:
        - $ref: '#/definitions/dto.OrderBuyerLite'
        description: Buyer 订单买家信息。
      order:
        allOf:
        - $ref: '#/definitions/dto.SuperOrderItem'
        description: Order 订单详细信息。
      tenant:
        allOf:
        - $ref: '#/definitions/dto.OrderTenantLite'
        description: Tenant 订单所属租户信息。
    type: object
  dto.SuperOrderFlagForm:
    properties:
      is_flagged:
        description: IsFlagged 是否标记为问题订单。
        type: boolean
      reason:
        description: Reason 标记原因（标记为问题时必填）。
        type: string
    type: object
  dto.SuperOrderItem:
    properties:
      amount_discount:
        description: AmountDiscount 优惠金额（分）。
        type: integer
      amount_original:
        description: AmountOriginal 原价金额（分）。
        type: integer
      amount_paid:
        description: AmountPaid 实付金额（分）。
        type: integer
      buyer:
        allOf:
        - $ref: '#/definitions/dto.OrderBuyerLite'
        description: Buyer 订单买家信息。
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      currency:
        allOf:
        - $ref: '#/definitions/consts.Currency'
        description: Currency 币种。
      flag_reason:
        description: FlagReason 问题标记原因。
        type: string
      flagged_at:
        description: FlaggedAt 标记时间（RFC3339）。
        type: string
      flagged_by:
        description: FlaggedBy 标记操作者ID。
        type: integer
      id:
        description: ID 订单ID。
        type: integer
      is_flagged:
        description: IsFlagged 是否标记为问题订单。
        type: boolean
      is_reconciled:
        description: IsReconciled 是否完成对账。
        type: boolean
      items:
        description: Items 订单明细行，用于展示具体内容与金额拆分。
        items:
          $ref: '#/definitions/dto.SuperOrderItemLine'
        type: array
      paid_at:
        description: PaidAt 支付时间（RFC3339）。
        type: string
      reconcile_note:
        description: ReconcileNote 对账说明。
        type: string
      reconciled_at:
        description: ReconciledAt 对账时间（RFC3339）。
        type: string
      reconciled_by:
        description: ReconciledBy 对账操作者ID。
        type: integer
      refunded_at:
        description: RefundedAt 退款时间（RFC3339）。
        type: string
      snapshot:
        description: Snapshot 订单快照，包含下单时的关键参数与定价信息，便于审计回溯。
      status:
        allOf:
        - $ref: '#/definitions/consts.OrderStatus'
        description: Status 订单状态。
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
      tenant:
        allOf:
        - $ref: '#/definitions/dto.OrderTenantLite'
        description: Tenant 订单所属租户信息。
      type:
        allOf:
        - $ref: '#/definitions/consts.OrderType'
        description: Type 订单类型。
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
    type: object
  dto.SuperOrderItemLine:
    properties:
      amount_paid:
        description: AmountPaid 该明细实付金额（分）。
        type: integer
      content_id:
        description: ContentID 购买的内容ID。
        type: integer
      id:
        description: ID 订单明细ID。
        type: integer
      snapshot:
        description: Snapshot 明细快照，用于展示内容标题等历史信息。
    type: object
  dto.SuperOrderReconcileForm:
    properties:
      is_reconciled:
        description: IsReconciled 是否完成对账。
        type: boolean
      note:
        description: Note 对账说明（可选）。
        type: string
    type: object
  dto.SuperOrderRefundForm:
    properties:
      force:
        description: Force 是否强制退款（忽略部分约束）。
        type: boolean
      idempotency_key:
        description: IdempotencyKey 幂等键（防止重复提交）。
        type: string
      reason:
        description: Reason 退款原因说明。
        type: string
    type: object
  dto.SuperPayoutAccountCreateForm:
    properties:
      account:
        description: Account 收款账号。
        maxLength: 128
        type: string
      name:
        description: Name 账户名称/开户行。
        maxLength: 128
        type: string
      realname:
        description: Realname 收款人姓名。
        maxLength: 128
        type: string
      type:
        description: Type 账户类型（bank/alipay）。
        enum:
        - bank
        - alipay
        type: string
      user_id:
        description: UserID 收款账户归属用户ID。
        type: integer
    required:
    - account
    - name
    - realname
    - type
    - user_id
    type: object
  dto.SuperPayoutAccountItem:
    properties:
      account:
        description: Account 收款账号。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      id:
        description: ID 结算账户ID。
        type: integer
      name:
        description: Name 账户名称/开户行。
        type: string
      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
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      type:
        description: Type 账户类型。
        type: string
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      user_id:
        description: UserID 用户ID。
        type: integer
      username:
        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.SuperPayoutAccountUpdateForm:
    properties:
      account:
        description: Account 收款账号（可选）。
        maxLength: 128
        type: string
      name:
        description: Name 账户名称/开户行（可选）。
        maxLength: 128
        type: string
      realname:
        description: Realname 收款人姓名（可选）。
        maxLength: 128
        type: string
      type:
        description: Type 账户类型（bank/alipay，可选）。
        enum:
        - bank
        - alipay
        type: string
    type: object
  dto.SuperReportExportForm:
    properties:
      end_at:
        description: EndAt 统计结束时间（RFC3339，可选；默认当前时间）。
        type: string
      format:
        description: Format 导出格式（仅支持 csv）。
        type: string
      granularity:
        description: Granularity 统计粒度（day；目前仅支持 day）。
        type: string
      start_at:
        description: StartAt 统计开始时间（RFC3339，可选；默认当前时间往前 7 天）。
        type: string
      tenant_id:
        description: TenantID 租户ID（不传代表全平台）。
        type: integer
    type: object
  dto.SuperSystemConfigCreateForm:
    properties:
      config_key:
        description: ConfigKey 配置项Key（唯一）。
        type: string
      description:
        description: Description 配置说明。
        type: string
      value:
        description: Value 配置值（JSON）。
        items:
          type: integer
        type: array
    type: object
  dto.SuperSystemConfigItem:
    properties:
      config_key:
        description: ConfigKey 配置项Key。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      description:
        description: Description 配置说明。
        type: string
      id:
        description: ID 配置ID。
        type: integer
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      value:
        description: Value 配置值（JSON）。
        items:
          type: integer
        type: array
    type: object
  dto.SuperSystemConfigUpdateForm:
    properties:
      description:
        description: Description 配置说明（可选）。
        type: string
      value:
        description: Value 配置值（JSON，可选）。
        items:
          type: integer
        type: array
    type: object
  dto.SuperTenantContentStatusUpdateForm:
    properties:
      status:
        allOf:
        - $ref: '#/definitions/consts.ContentStatus'
        description: Status 目标内容状态。
        enum:
        - unpublished
        - blocked
    required:
    - status
    type: object
  dto.SuperTenantJoinRequestItem:
    properties:
      created_at:
        description: CreatedAt 申请时间（RFC3339）。
        type: string
      decided_at:
        description: DecidedAt 审核时间（RFC3339）。
        type: string
      decided_operator_user_id:
        description: DecidedOperatorUserID 审核操作者ID。
        type: integer
      decided_reason:
        description: DecidedReason 审核备注/原因。
        type: string
      id:
        description: ID 申请记录ID。
        type: integer
      reason:
        description: Reason 申请说明。
        type: string
      status:
        description: Status 申请状态。
        type: string
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      user_id:
        description: UserID 申请用户ID。
        type: integer
      username:
        description: Username 申请用户名称。
        type: string
    type: object
  dto.SuperTenantUserItem:
    properties:
      tenant_user:
        allOf:
        - $ref: '#/definitions/dto.TenantUser'
        description: TenantUser 租户成员关系信息。
      user:
        allOf:
        - $ref: '#/definitions/dto.SuperUserLite'
        description: User 用户信息。
    type: object
  dto.SuperUserContentActionItem:
    properties:
      action_at:
        description: ActionAt 互动发生时间（RFC3339）。
        type: string
      action_id:
        description: ActionID 互动记录ID。
        type: integer
      action_type:
        allOf:
        - $ref: '#/definitions/consts.UserContentActionType'
        description: ActionType 互动类型（like/favorite）。
      content:
        allOf:
        - $ref: '#/definitions/dto.AdminContentItem'
        description: Content 互动对应内容详情（含租户与作者信息）。
    type: object
  dto.SuperUserCouponItem:
    properties:
      coupon_id:
        description: CouponID 券模板ID。
        type: integer
      created_at:
        description: CreatedAt 领取时间（RFC3339）。
        type: string
      description:
        description: Description 券描述。
        type: string
      end_at:
        description: EndAt 过期时间（RFC3339）。
        type: string
      id:
        description: ID 用户券ID。
        type: integer
      max_discount:
        description: MaxDiscount 折扣券最高抵扣金额（分）。
        type: integer
      min_order_amount:
        description: MinOrderAmount 使用门槛金额（分）。
        type: integer
      order_id:
        description: OrderID 使用订单ID（未使用为0）。
        type: integer
      start_at:
        description: StartAt 生效时间（RFC3339）。
        type: string
      status:
        allOf:
        - $ref: '#/definitions/consts.UserCouponStatus'
        description: Status 用户券状态。
      status_description:
        description: StatusDescription 用户券状态描述（用于展示）。
        type: string
      tenant_code:
        description: TenantCode 券所属租户编码。
        type: string
      tenant_id:
        description: TenantID 券所属租户ID。
        type: integer
      tenant_name:
        description: TenantName 券所属租户名称。
        type: string
      title:
        description: Title 券标题。
        type: string
      type:
        allOf:
        - $ref: '#/definitions/consts.CouponType'
        description: Type 券类型。
      type_description:
        description: TypeDescription 券类型描述（用于展示）。
        type: string
      used_at:
        description: UsedAt 使用时间（RFC3339）。
        type: string
      value:
        description: Value 券面值/折扣值。
        type: integer
    type: object
  dto.SuperUserLibraryItem:
    properties:
      access_id:
        description: AccessID 访问记录ID。
        type: integer
      access_status:
        allOf:
        - $ref: '#/definitions/consts.ContentAccessStatus'
        description: AccessStatus 访问状态。
      access_status_description:
        description: AccessStatusDescription 访问状态描述（用于展示）。
        type: string
      accessed_at:
        description: AccessedAt 获取访问权限时间（RFC3339）。
        type: string
      amount_paid:
        description: AmountPaid 该内容实付金额（分）。
        type: integer
      content:
        allOf:
        - $ref: '#/definitions/dto.AdminContentItem'
        description: Content 内容详情（含租户/作者/价格）。
      content_id:
        description: ContentID 内容ID。
        type: integer
      order_id:
        description: OrderID 订单ID。
        type: integer
      order_status:
        allOf:
        - $ref: '#/definitions/consts.OrderStatus'
        description: OrderStatus 订单状态。
      order_status_description:
        description: OrderStatusDescription 订单状态描述（用于展示）。
        type: string
      order_type:
        allOf:
        - $ref: '#/definitions/consts.OrderType'
        description: OrderType 订单类型。
      paid_at:
        description: PaidAt 支付时间（RFC3339）。
        type: string
      snapshot:
        description: Snapshot 下单快照（内容标题/金额等）。
      tenant_id:
        description: TenantID 内容所属租户ID。
        type: integer
    type: object
  dto.SuperUserLite:
    properties:
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      id:
        description: ID 用户ID。
        type: integer
      roles:
        description: Roles 用户角色列表。
        items:
          $ref: '#/definitions/consts.Role'
        type: array
      status:
        allOf:
        - $ref: '#/definitions/consts.UserStatus'
        description: Status 用户状态。
      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
    type: object
  dto.SuperUserNotificationItem:
    properties:
      content:
        description: Content 通知内容。
        type: string
      created_at:
        description: CreatedAt 发送时间（RFC3339）。
        type: string
      id:
        description: ID 通知ID。
        type: integer
      read:
        description: Read 是否已读。
        type: boolean
      tenant_code:
        description: TenantCode 通知所属租户编码。
        type: string
      tenant_id:
        description: TenantID 通知所属租户ID。
        type: integer
      tenant_name:
        description: TenantName 通知所属租户名称。
        type: string
      title:
        description: Title 通知标题。
        type: string
      type:
        description: Type 通知类型。
        type: string
    type: object
  dto.SuperUserProfileUpdateForm:
    properties:
      avatar:
        description: Avatar 头像URL（可选，空字符串表示清空）。
        type: string
      bio:
        description: Bio 个人简介（可选，空字符串表示清空）。
        type: string
      gender:
        allOf:
        - $ref: '#/definitions/consts.Gender'
        description: Gender 性别（可选）。
      id_card:
        description: IDCard 身份证号（可选，用于更新实名认证信息）。
        type: string
      is_real_name_verified:
        description: IsRealNameVerified 是否已实名认证（可选）。
        type: boolean
      nickname:
        description: Nickname 昵称（可选，空字符串表示清空）。
        type: string
      real_name:
        description: RealName 真实姓名（可选，用于更新实名认证信息）。
        type: string
    type: object
  dto.SuperUserRealNameResponse:
    properties:
      id_card_masked:
        description: IDCardMasked 身份证号脱敏展示。
        type: string
      is_real_name_verified:
        description: IsRealNameVerified 是否已实名认证。
        type: boolean
      real_name:
        description: RealName 真实姓名（来自用户元数据）。
        type: string
      verified_at:
        description: VerifiedAt 实名认证时间（RFC3339）。
        type: string
    type: object
  dto.SuperWalletResponse:
    properties:
      balance:
        description: Balance 账户可用余额（分）。
        type: integer
      balance_frozen:
        description: BalanceFrozen 账户冻结余额（分）。
        type: integer
      transactions:
        description: Transactions 最近交易记录。
        items:
          $ref: '#/definitions/dto.SuperWalletTransaction'
        type: array
    type: object
  dto.SuperWalletTransaction:
    properties:
      amount:
        description: Amount 交易金额（分）。
        type: integer
      date:
        description: Date 交易时间（RFC3339）。
        type: string
      id:
        description: ID 订单ID。
        type: integer
      order_type:
        allOf:
        - $ref: '#/definitions/consts.OrderType'
        description: OrderType 订单类型。
      tenant_code:
        description: TenantCode 租户编码。
        type: string
      tenant_id:
        description: TenantID 交易所属租户ID（充值为0）。
        type: integer
      tenant_name:
        description: TenantName 租户名称。
        type: string
      title:
        description: Title 交易标题。
        type: string
      type:
        description: Type 交易流向（income/expense）。
        type: string
    type: object
  dto.SuperWithdrawalRejectForm:
    properties:
      reason:
        description: Reason 驳回原因。
        type: string
    required:
    - reason
    type: object
  dto.TenantAdminUserLite:
    properties:
      id:
        description: ID 用户ID。
        type: integer
      username:
        description: Username 用户名。
        type: string
    type: object
  dto.TenantCreateForm:
    properties:
      admin_user_id:
        description: AdminUserID 租户管理员用户ID。
        type: integer
      code:
        description: Code 租户编码（唯一）。
        maxLength: 64
        type: string
      duration:
        description: Duration 租户有效期（天）。
        enum:
        - 7
        - 30
        - 90
        - 180
        - 365
        type: integer
      name:
        description: Name 租户名称。
        maxLength: 128
        type: string
    required:
    - admin_user_id
    - code
    - duration
    - name
    type: object
  dto.TenantExpireUpdateForm:
    properties:
      duration:
        description: Duration 延长有效期（天）。
        enum:
        - 7
        - 30
        - 90
        - 180
        - 365
        type: integer
    required:
    - duration
    type: object
  dto.TenantHealthItem:
    properties:
      alerts:
        description: Alerts 异常提示列表（用于运营侧提示）。
        items:
          type: string
        type: array
      code:
        description: Code 租户编码。
        type: string
      content_count:
        description: ContentCount 内容总数。
        type: integer
      health_level:
        description: HealthLevel 健康等级（healthy/warning/risk）。
        type: string
      last_paid_at:
        description: LastPaidAt 最近成交时间（RFC3339，空代表暂无成交）。
        type: string
      member_count:
        description: MemberCount 租户成员数量（包含管理员）。
        type: integer
      name:
        description: Name 租户名称。
        type: string
      owner:
        allOf:
        - $ref: '#/definitions/dto.TenantOwnerUserLite'
        description: Owner 租户所有者信息。
      paid_amount:
        description: PaidAmount 已支付金额（分）。
        type: integer
      paid_orders:
        description: PaidOrders 已支付订单数（内容购买）。
        type: integer
      published_content_count:
        description: PublishedContentCount 已发布内容数量。
        type: integer
      refund_amount:
        description: RefundAmount 已退款金额（分）。
        type: integer
      refund_orders:
        description: RefundOrders 已退款订单数（内容购买）。
        type: integer
      refund_rate:
        description: RefundRate 退款率（退款订单数 / 已支付订单数）。
        type: number
      status:
        allOf:
        - $ref: '#/definitions/consts.TenantStatus'
        description: Status 租户状态。
      status_description:
        description: StatusDescription 租户状态描述（用于展示）。
        type: string
      tenant_id:
        description: TenantID 租户ID。
        type: integer
    type: object
  dto.TenantInviteAcceptForm:
    properties:
      code:
        description: Code 邀请码（必填）。
        type: string
    type: object
  dto.TenantInviteCreateForm:
    properties:
      expires_at:
        description: ExpiresAt 过期时间（RFC3339，可选，空值使用默认过期时间）。
        type: string
      max_uses:
        description: MaxUses 最大可使用次数（<=0 默认 1）。
        type: integer
      remark:
        description: Remark 备注说明（可选）。
        type: string
    type: object
  dto.TenantInviteItem:
    properties:
      code:
        description: Code 邀请码。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      expires_at:
        description: ExpiresAt 过期时间（RFC3339，空字符串表示不限制）。
        type: string
      id:
        description: ID 邀请记录ID。
        type: integer
      max_uses:
        description: MaxUses 最大可使用次数。
        type: integer
      remark:
        description: Remark 备注说明。
        type: string
      status:
        description: Status 邀请状态（active/disabled/expired）。
        type: string
      used_count:
        description: UsedCount 已使用次数。
        type: integer
    type: object
  dto.TenantItem:
    properties:
      admin_users:
        description: AdminUsers 租户管理员列表。
        items:
          $ref: '#/definitions/dto.TenantAdminUserLite'
        type: array
      code:
        description: Code 租户编码。
        type: string
      config:
        description: Config 租户配置项（占位/需要结构化时替换）。
        items:
          type: integer
        type: array
      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:
        allOf:
        - $ref: '#/definitions/dto.TenantOwnerUserLite'
        description: Owner 租户所有者信息。
      status:
        allOf:
        - $ref: '#/definitions/consts.TenantStatus'
        description: Status 租户状态。
      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 租户成员列表（用于详情展示）。
        items:
          $ref: '#/definitions/dto.SuperUserLite'
        type: array
      uuid:
        description: UUID 租户UUID。
        type: string
    type: object
  dto.TenantJoinReviewForm:
    properties:
      action:
        description: Action 审核动作（approve/reject）。
        type: string
      reason:
        description: Reason 审核说明（可选，用于展示驳回原因或备注）。
        type: string
    type: object
  dto.TenantOwnerUserLite:
    properties:
      id:
        description: ID 用户ID。
        type: integer
      username:
        description: Username 用户名。
        type: string
    type: object
  dto.TenantProfile:
    properties:
      avatar:
        description: Avatar 头像URL。
        type: string
      bio:
        description: Bio 简短简介。
        type: string
      cert_type:
        description: CertType 认证类型（personal/enterprise）。
        type: string
      cover:
        description: Cover 封面图URL。
        type: string
      description:
        description: Description 详细描述。
        type: string
      id:
        description: ID 租户ID。
        type: integer
      is_following:
        description: IsFollowing 当前用户是否关注。
        type: boolean
      name:
        description: Name 租户名称。
        type: string
      stats:
        allOf:
        - $ref: '#/definitions/dto.Stats'
        description: Stats 统计信息。
    type: object
  dto.TenantStatusUpdateForm:
    properties:
      status:
        allOf:
        - $ref: '#/definitions/consts.TenantStatus'
        description: Status 目标租户状态。
    required:
    - status
    type: object
  dto.TenantUser:
    properties:
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      id:
        description: ID 成员记录ID。
        type: integer
      role:
        description: Role 成员角色列表。
        items:
          $ref: '#/definitions/consts.TenantUserRole'
        type: array
      status:
        allOf:
        - $ref: '#/definitions/consts.UserStatus'
        description: Status 成员状态。
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      updated_at:
        description: UpdatedAt 更新时间（RFC3339）。
        type: string
      user_id:
        description: UserID 用户ID。
        type: integer
    type: object
  dto.Topic:
    properties:
      count:
        description: Count 专题内内容数量。
        type: integer
      cover:
        description: Cover 专题封面图。
        type: string
      id:
        description: ID 专题ID。
        type: integer
      tag:
        description: Tag 专题标签（用于筛选/展示）。
        type: string
      title:
        description: Title 专题标题。
        type: string
    type: object
  dto.Transaction:
    properties:
      amount:
        description: Amount 发生金额（单位元）。
        type: number
      date:
        description: Date 发生时间（RFC3339）。
        type: string
      id:
        description: ID 流水ID。
        type: integer
      title:
        description: Title 流水标题/描述。
        type: string
      type:
        description: Type 流水类型（income/expense）。
        type: string
    type: object
  dto.UploadCompleteForm:
    properties:
      upload_id:
        description: UploadID 分片上传ID。
        type: string
    type: object
  dto.UploadInitForm:
    properties:
      filename:
        description: Filename 原始文件名。
        type: string
      hash:
        description: Hash 文件 MD5 哈希（用于秒传校验）。
        type: string
      mime_type:
        description: MimeType 文件类型（如 image/png）。
        type: string
      size:
        description: Size 文件大小（字节）。
        type: integer
      type:
        description: Type 业务类型（如 cover/media/avatar）。
        type: string
    type: object
  dto.UploadInitResponse:
    properties:
      chunk_size:
        description: ChunkSize 分片大小（字节）。
        type: integer
      key:
        description: Key 对象存储Key（S3 直传使用）。
        type: string
      upload_id:
        description: UploadID 分片上传ID。
        type: string
    type: object
  dto.UploadResult:
    properties:
      filename:
        description: Filename 原始文件名。
        type: string
      id:
        description: ID 媒体资源ID。
        type: integer
      mime_type:
        description: MimeType 文件类型（如 image/png）。
        type: string
      size:
        description: Size 文件大小（字节）。
        type: integer
      url:
        description: URL 访问地址（包含签名或公共URL）。
        type: string
    type: object
  dto.UserCouponItem:
    properties:
      coupon_id:
        description: CouponID 券模板ID。
        type: integer
      description:
        description: Description 券描述。
        type: string
      end_at:
        description: EndAt 过期时间（RFC3339）。
        type: string
      id:
        description: ID 用户券ID。
        type: integer
      min_order_amount:
        description: MinOrderAmount 使用门槛金额（分）。
        type: integer
      start_at:
        description: StartAt 生效时间（RFC3339）。
        type: string
      status:
        description: Status 当前状态（可用/已用/过期）。
        type: string
      title:
        description: Title 券标题。
        type: string
      type:
        description: Type 券类型（满减/折扣）。
        type: string
      value:
        description: Value 券面值（分/百分比）。
        type: integer
    type: object
  dto.UserItem:
    properties:
      avatar:
        description: Avatar 用户头像URL（资料展示）。
        type: string
      balance:
        description: Balance 账户可用余额（分）。
        type: integer
      balance_frozen:
        description: BalanceFrozen 账户冻结余额（分）。
        type: integer
      bio:
        description: Bio 用户个人简介。
        type: string
      created_at:
        description: CreatedAt 创建时间（RFC3339）。
        type: string
      gender:
        allOf:
        - $ref: '#/definitions/consts.Gender'
        description: Gender 用户性别（male/female/secret）。
      id:
        description: ID 用户ID。
        type: integer
      is_real_name_verified:
        description: IsRealNameVerified 是否已实名认证。
        type: boolean
      joined_tenant_count:
        description: JoinedTenantCount 加入的租户数量。
        type: integer
      nickname:
        description: Nickname 用户昵称（资料展示）。
        type: string
      owned_tenant_count:
        description: OwnedTenantCount 拥有的租户数量。
        type: integer
      roles:
        description: Roles 用户角色列表。
        items:
          $ref: '#/definitions/consts.Role'
        type: array
      status:
        allOf:
        - $ref: '#/definitions/consts.UserStatus'
        description: Status 用户状态。
      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
    type: object
  dto.UserRolesUpdateForm:
    properties:
      roles:
        description: Roles 目标角色列表（至少包含 1 个）。
        items:
          $ref: '#/definitions/consts.Role'
        minItems: 1
        type: array
    required:
    - roles
    type: object
  dto.UserStatistics:
    properties:
      count:
        description: Count 该状态用户数量。
        type: integer
      status:
        allOf:
        - $ref: '#/definitions/consts.UserStatus'
        description: Status 用户状态枚举。
      status_description:
        description: StatusDescription 状态描述（用于展示）。
        type: string
    type: object
  dto.UserStatusUpdateForm:
    properties:
      status:
        allOf:
        - $ref: '#/definitions/consts.UserStatus'
        description: Status 目标用户状态。
    required:
    - status
    type: object
  dto.UserTenantItem:
    properties:
      code:
        description: Code 租户编码。
        type: string
      expired_at:
        description: ExpiredAt 租户过期时间（RFC3339）。
        type: string
      joined_at:
        description: JoinedAt 加入时间（RFC3339）。
        type: string
      member_status:
        allOf:
        - $ref: '#/definitions/consts.UserStatus'
        description: MemberStatus 成员状态。
      member_status_description:
        description: MemberStatusDescription 成员状态描述。
        type: string
      name:
        description: Name 租户名称。
        type: string
      owner:
        allOf:
        - $ref: '#/definitions/dto.TenantOwnerUserLite'
        description: Owner 租户所有者用户信息。
      role:
        description: Role 用户在该租户内的角色列表。
        items:
          $ref: '#/definitions/consts.TenantUserRole'
        type: array
      tenant_id:
        description: TenantID 租户ID。
        type: integer
      tenant_status:
        allOf:
        - $ref: '#/definitions/consts.TenantStatus'
        description: TenantStatus 租户状态。
      tenant_status_description:
        description: TenantStatusDescription 租户状态描述。
        type: string
    type: object
  dto.UserUpdate:
    properties:
      avatar:
        description: Avatar 头像URL。
        type: string
      bio:
        description: Bio 个人简介。
        type: string
      birthday:
        description: Birthday 生日（YYYY-MM-DD）。
        type: string
      gender:
        allOf:
        - $ref: '#/definitions/consts.Gender'
        description: Gender 性别（枚举）。
      location:
        allOf:
        - $ref: '#/definitions/quyun_v2_app_http_v1_dto.Location'
        description: Location 地区信息（省/市）。
      nickname:
        description: Nickname 昵称。
        type: string
    type: object
  dto.WalletResponse:
    properties:
      balance:
        description: Balance 账户余额（单位元）。
        type: number
      transactions:
        description: Transactions 交易流水列表。
        items:
          $ref: '#/definitions/dto.Transaction'
        type: array
    type: object
  quyun_v2_app_http_super_v1_dto.Location:
    properties:
      city:
        description: City 城市名称。
        type: string
      province:
        description: Province 省份名称。
        type: string
    type: object
  quyun_v2_app_http_super_v1_dto.LoginForm:
    properties:
      password:
        description: Password 登录密码（加密传输）。
        type: string
      username:
        description: Username 登录用户名。
        type: string
    type: object
  quyun_v2_app_http_super_v1_dto.LoginResponse:
    properties:
      token:
        description: Token 登录后签发的 JWT。
        type: string
      user:
        allOf:
        - $ref: '#/definitions/quyun_v2_app_http_super_v1_dto.User'
        description: User 当前登录用户信息。
    type: object
  quyun_v2_app_http_super_v1_dto.User:
    properties:
      avatar:
        description: Avatar 头像URL。
        type: string
      balance:
        description: Balance 账户余额（元）。
        type: number
      bio:
        description: Bio 用户简介。
        type: string
      birthday:
        description: Birthday 生日（YYYY-MM-DD）。
        type: string
      gender:
        allOf:
        - $ref: '#/definitions/consts.Gender'
        description: Gender 性别（male/female/secret）。
      id:
        description: ID 用户ID。
        type: integer
      is_real_name_verified:
        description: IsRealNameVerified 是否已实名认证。
        type: boolean
      location:
        allOf:
        - $ref: '#/definitions/quyun_v2_app_http_super_v1_dto.Location'
        description: Location 所在地（省/市）。
      nickname:
        description: Nickname 用户昵称。
        type: string
      phone:
        description: Phone 手机号。
        type: string
      points:
        description: Points 用户积分。
        type: integer
    type: object
  quyun_v2_app_http_v1_dto.Location:
    properties:
      city:
        description: City 城市名称。
        type: string
      province:
        description: Province 省份名称。
        type: string
    type: object
  quyun_v2_app_http_v1_dto.LoginForm:
    properties:
      otp:
        description: OTP 短信验证码。
        type: string
      phone:
        description: Phone 手机号（登录账号）。
        type: string
    type: object
  quyun_v2_app_http_v1_dto.LoginResponse:
    properties:
      token:
        description: Token 登录成功后的 JWT。
        type: string
      user:
        allOf:
        - $ref: '#/definitions/quyun_v2_app_http_v1_dto.User'
        description: User 当前登录用户信息。
    type: object
  quyun_v2_app_http_v1_dto.SendOTPForm:
    properties:
      phone:
        description: Phone 手机号（用于发送验证码）。
        type: string
    type: object
  quyun_v2_app_http_v1_dto.User:
    properties:
      avatar:
        description: Avatar 头像URL。
        type: string
      balance:
        description: Balance 余额（单位元）。
        type: number
      bio:
        description: Bio 个人简介。
        type: string
      birthday:
        description: Birthday 生日（YYYY-MM-DD）。
        type: string
      gender:
        allOf:
        - $ref: '#/definitions/consts.Gender'
        description: Gender 性别（枚举）。
      id:
        description: ID 用户ID。
        type: integer
      is_real_name_verified:
        description: IsRealNameVerified 是否完成实名认证。
        type: boolean
      location:
        allOf:
        - $ref: '#/definitions/quyun_v2_app_http_v1_dto.Location'
        description: Location 地区信息（省/市）。
      nickname:
        description: Nickname 昵称。
        type: string
      phone:
        description: Phone 绑定手机号。
        type: string
      points:
        description: Points 积分余额。
        type: integer
    type: object
  requests.KV:
    properties:
      key:
        description: Key is a machine-readable value, usually an enum string.
        type: string
      value:
        description: Value is the label payload, often a human-readable string.
    type: object
  requests.Pager:
    properties:
      items:
        description: Items is the paged result list; concrete type depends on endpoint.
      limit:
        description: Limit is page size; only values in {10,20,50,100} are accepted
          (otherwise defaults to 10).
        type: integer
      page:
        description: Page is 1-based page index; values <= 0 are normalized to 1.
        type: integer
      total:
        description: Total is the total number of items matching current filter (before
          paging).
        type: integer
    type: object
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
host: localhost:8080
info:
  contact:
    email: support@swagger.io
    name: UserName
    url: http://www.swagger.io/support
  description: Multi-tenant media platform backend API.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://swagger.io/terms/
  title: ApiDoc
  version: "1.0"
paths:
  /super/v1/assets:
    get:
      consumes:
      - application/json
      description: List assets across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperAssetItem'
                  type: array
              type: object
      summary: List assets
      tags:
      - Asset
  /super/v1/assets/{id}:
    delete:
      consumes:
      - application/json
      description: Delete asset
      parameters:
      - description: Asset ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Force delete
        in: query
        name: force
        type: boolean
      produces:
      - application/json
      responses:
        "200":
          description: Deleted
          schema:
            type: string
      summary: Delete asset
      tags:
      - Asset
  /super/v1/assets/usage:
    get:
      consumes:
      - application/json
      description: Asset usage statistics
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperAssetUsageResponse'
      summary: Asset usage
      tags:
      - Asset
  /super/v1/audit-logs:
    get:
      consumes:
      - application/json
      description: List audit logs across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperAuditLogItem'
                  type: array
              type: object
      summary: List audit logs
      tags:
      - Audit
  /super/v1/auth/login:
    post:
      consumes:
      - application/json
      description: Login
      parameters:
      - description: Login form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/quyun_v2_app_http_super_v1_dto.LoginForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/quyun_v2_app_http_super_v1_dto.LoginResponse'
      summary: Login
      tags:
      - Auth
  /super/v1/auth/token:
    get:
      consumes:
      - application/json
      description: Check token
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/quyun_v2_app_http_super_v1_dto.LoginResponse'
      summary: Check token
      tags:
      - Auth
  /super/v1/comments:
    get:
      consumes:
      - application/json
      description: List comments across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperCommentItem'
                  type: array
              type: object
      summary: List comments
      tags:
      - Content
  /super/v1/comments/{id}/delete:
    post:
      consumes:
      - application/json
      description: Soft delete a comment
      parameters:
      - description: Comment ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Delete form
        in: body
        name: form
        schema:
          $ref: '#/definitions/dto.SuperCommentDeleteForm'
      produces:
      - application/json
      responses:
        "200":
          description: Deleted
          schema:
            type: string
      summary: Delete comment
      tags:
      - Content
  /super/v1/content-reports:
    get:
      consumes:
      - application/json
      description: List content report records across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperContentReportItem'
                  type: array
              type: object
      summary: List content reports
      tags:
      - Content
  /super/v1/content-reports/{id}/process:
    post:
      consumes:
      - application/json
      description: Process a content report record
      parameters:
      - description: Report ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Process form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperContentReportProcessForm'
      produces:
      - application/json
      responses:
        "200":
          description: Processed
          schema:
            type: string
      summary: Process content report
      tags:
      - Content
  /super/v1/content-reports/process/batch:
    post:
      consumes:
      - application/json
      description: Batch process content report records
      parameters:
      - description: Batch process form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperContentReportBatchProcessForm'
      produces:
      - application/json
      responses:
        "200":
          description: Processed
          schema:
            type: string
      summary: Batch process content reports
      tags:
      - Content
  /super/v1/contents:
    get:
      consumes:
      - application/json
      description: List contents
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.AdminContentItem'
                  type: array
              type: object
      summary: List contents
      tags:
      - Content
  /super/v1/contents/{id}/review:
    post:
      consumes:
      - application/json
      description: Review content
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Review form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperContentReviewForm'
      produces:
      - application/json
      responses:
        "200":
          description: Reviewed
          schema:
            type: string
      summary: Review content
      tags:
      - Content
  /super/v1/contents/review/batch:
    post:
      consumes:
      - application/json
      description: Batch review contents
      parameters:
      - description: Batch review form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperContentBatchReviewForm'
      produces:
      - application/json
      responses:
        "200":
          description: Reviewed
          schema:
            type: string
      summary: Batch review contents
      tags:
      - Content
  /super/v1/contents/statistics:
    get:
      consumes:
      - application/json
      description: Content statistics
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperContentStatisticsResponse'
      summary: Content statistics
      tags:
      - Content
  /super/v1/contents/status/batch:
    post:
      consumes:
      - application/json
      description: Batch unpublish or block contents
      parameters:
      - description: Batch status form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperContentBatchStatusForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Batch update content status
      tags:
      - Content
  /super/v1/coupon-grants:
    get:
      consumes:
      - application/json
      description: List coupon grant records across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperCouponGrantItem'
                  type: array
              type: object
      summary: List coupon grants
      tags:
      - Coupon
  /super/v1/coupon-risks:
    get:
      consumes:
      - application/json
      description: List coupon risk records across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperCouponRiskItem'
                  type: array
              type: object
      summary: List coupon risks
      tags:
      - Coupon
  /super/v1/coupons:
    get:
      consumes:
      - application/json
      description: List coupon templates across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperCouponItem'
                  type: array
              type: object
      summary: List coupons
      tags:
      - Coupon
  /super/v1/coupons/{id}/status:
    patch:
      consumes:
      - application/json
      description: Update coupon status across tenants
      parameters:
      - description: Coupon ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperCouponStatusUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update coupon status
      tags:
      - Coupon
  /super/v1/creator-applications:
    get:
      consumes:
      - application/json
      description: List creator applications across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.TenantItem'
                  type: array
              type: object
      summary: List creator applications
      tags:
      - Creator
  /super/v1/creator-applications/{id}/review:
    post:
      consumes:
      - application/json
      description: Approve or reject creator application
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Review form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperCreatorApplicationReviewForm'
      produces:
      - application/json
      responses:
        "200":
          description: Reviewed
          schema:
            type: string
      summary: Review creator application
      tags:
      - Creator
  /super/v1/creators:
    get:
      consumes:
      - application/json
      description: List creator tenants (channels) across the platform
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.TenantItem'
                  type: array
              type: object
      summary: List creators
      tags:
      - Creator
  /super/v1/creators/{tenantID}/payout-accounts:
    post:
      consumes:
      - application/json
      description: Create payout account for tenant
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Create form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperPayoutAccountCreateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Created
          schema:
            type: string
      summary: Create payout account
      tags:
      - Finance
  /super/v1/creators/{tenantID}/settings:
    get:
      consumes:
      - application/json
      description: Get creator settings by tenant ID
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.Settings'
      summary: Get creator settings
      tags:
      - Creator
    put:
      consumes:
      - application/json
      description: Update creator settings by tenant ID
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Settings form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.Settings'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update creator settings
      tags:
      - Creator
  /super/v1/finance/anomalies/balances:
    get:
      consumes:
      - application/json
      description: List balance anomalies across users
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperBalanceAnomalyItem'
                  type: array
              type: object
      summary: List balance anomalies
      tags:
      - Finance
  /super/v1/finance/anomalies/orders:
    get:
      consumes:
      - application/json
      description: List order anomalies across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperOrderAnomalyItem'
                  type: array
              type: object
      summary: List order anomalies
      tags:
      - Finance
  /super/v1/finance/ledgers:
    get:
      consumes:
      - application/json
      description: List tenant ledgers across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperLedgerItem'
                  type: array
              type: object
      summary: List ledgers
      tags:
      - Finance
  /super/v1/health/overview:
    get:
      consumes:
      - application/json
      description: Platform health overview
      parameters:
      - description: Tenant ID
        in: query
        name: tenant_id
        type: integer
      - description: Start time
        in: query
        name: start_at
        type: string
      - description: End time
        in: query
        name: end_at
        type: string
      - description: Upload stuck hours
        in: query
        name: upload_stuck_hours
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperHealthOverviewResponse'
      summary: Health overview
      tags:
      - Health
  /super/v1/notifications:
    get:
      consumes:
      - application/json
      description: List notifications across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperNotificationItem'
                  type: array
              type: object
      summary: List notifications
      tags:
      - Notification
  /super/v1/notifications/broadcast:
    post:
      consumes:
      - application/json
      description: Broadcast notification to users or tenant members
      parameters:
      - description: Broadcast form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperNotificationBroadcastForm'
      produces:
      - application/json
      responses:
        "200":
          description: Sent
          schema:
            type: string
      summary: Broadcast notification
      tags:
      - Notification
  /super/v1/notifications/templates:
    get:
      consumes:
      - application/json
      description: List notification templates
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperNotificationTemplateItem'
                  type: array
              type: object
      summary: List notification templates
      tags:
      - Notification
    post:
      consumes:
      - application/json
      description: Create notification template
      parameters:
      - description: Template form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperNotificationTemplateCreateForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperNotificationTemplateItem'
      summary: Create notification template
      tags:
      - Notification
  /super/v1/notifications/templates/{id}:
    patch:
      consumes:
      - application/json
      description: Update notification template
      parameters:
      - description: Template ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperNotificationTemplateUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperNotificationTemplateItem'
      summary: Update notification template
      tags:
      - Notification
  /super/v1/orders:
    get:
      consumes:
      - application/json
      description: List orders
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperOrderItem'
                  type: array
              type: object
      summary: List orders
      tags:
      - Order
  /super/v1/orders/{id}:
    get:
      consumes:
      - application/json
      description: Get order
      parameters:
      - description: Order ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperOrderDetail'
      summary: Get order
      tags:
      - Order
  /super/v1/orders/{id}/flag:
    post:
      consumes:
      - application/json
      description: Flag or unflag an order as problematic
      parameters:
      - description: Order ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Flag form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperOrderFlagForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            type: string
      summary: Flag order
      tags:
      - Order
  /super/v1/orders/{id}/reconcile:
    post:
      consumes:
      - application/json
      description: Mark or unmark order reconciliation status
      parameters:
      - description: Order ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Reconcile form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperOrderReconcileForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            type: string
      summary: Reconcile order
      tags:
      - Order
  /super/v1/orders/{id}/refund:
    post:
      consumes:
      - application/json
      description: Refund order
      parameters:
      - description: Order ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Refund form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperOrderRefundForm'
      produces:
      - application/json
      responses:
        "200":
          description: Refunded
          schema:
            type: string
      summary: Refund order
      tags:
      - Order
  /super/v1/orders/statistics:
    get:
      consumes:
      - application/json
      description: Order statistics
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.OrderStatisticsResponse'
      summary: Order statistics
      tags:
      - Order
  /super/v1/payout-accounts:
    get:
      consumes:
      - application/json
      description: List payout accounts across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperPayoutAccountItem'
                  type: array
              type: object
      summary: List payout accounts
      tags:
      - Finance
  /super/v1/payout-accounts/{id}:
    delete:
      consumes:
      - application/json
      description: Remove payout account across tenants
      parameters:
      - description: Payout account ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: Removed
          schema:
            type: string
      summary: Remove payout account
      tags:
      - Finance
    patch:
      consumes:
      - application/json
      description: Update payout account across tenants
      parameters:
      - description: Payout account ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperPayoutAccountUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update 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:
      - application/json
      description: Export platform report data
      parameters:
      - description: Export form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperReportExportForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.ReportExportResponse'
      summary: Export report
      tags:
      - Report
  /super/v1/reports/overview:
    get:
      consumes:
      - application/json
      description: Get platform report overview
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.ReportOverviewResponse'
      summary: Report overview
      tags:
      - Report
  /super/v1/system-configs:
    get:
      consumes:
      - application/json
      description: List platform system configs
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperSystemConfigItem'
                  type: array
              type: object
      summary: List system configs
      tags:
      - SystemConfig
    post:
      consumes:
      - application/json
      description: Create platform system config
      parameters:
      - description: Create form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperSystemConfigCreateForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperSystemConfigItem'
      summary: Create system config
      tags:
      - SystemConfig
  /super/v1/system-configs/{id}:
    patch:
      consumes:
      - application/json
      description: Update platform system config
      parameters:
      - description: Config ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperSystemConfigUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperSystemConfigItem'
      summary: Update system config
      tags:
      - SystemConfig
  /super/v1/tenant-join-requests:
    get:
      consumes:
      - application/json
      description: List tenant join requests across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperTenantJoinRequestItem'
                  type: array
              type: object
      summary: List tenant join requests
      tags:
      - Tenant
  /super/v1/tenant-join-requests/{id}/review:
    post:
      consumes:
      - application/json
      description: Approve or reject a tenant join request
      parameters:
      - description: Join request ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Review form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.TenantJoinReviewForm'
      produces:
      - application/json
      responses:
        "200":
          description: Reviewed
          schema:
            type: string
      summary: Review tenant join request
      tags:
      - Tenant
  /super/v1/tenants:
    get:
      consumes:
      - application/json
      description: List tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      - description: Name
        in: query
        name: name
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.TenantItem'
                  type: array
              type: object
      summary: List tenants
      tags:
      - Tenant
    post:
      consumes:
      - application/json
      description: Create tenant
      parameters:
      - description: Create form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.TenantCreateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Created
          schema:
            type: string
      summary: Create tenant
      tags:
      - Tenant
  /super/v1/tenants/{id}:
    get:
      consumes:
      - application/json
      description: Get tenant
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.TenantItem'
      summary: Get tenant
      tags:
      - Tenant
    patch:
      consumes:
      - application/json
      description: Update tenant expire
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.TenantExpireUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update tenant expire
      tags:
      - Tenant
  /super/v1/tenants/{id}/status:
    patch:
      consumes:
      - application/json
      description: Update tenant status
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.TenantStatusUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update tenant status
      tags:
      - Tenant
  /super/v1/tenants/{tenantID}/contents:
    get:
      consumes:
      - application/json
      description: List contents by tenant
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.AdminContentItem'
                  type: array
              type: object
      summary: List tenant contents
      tags:
      - Content
  /super/v1/tenants/{tenantID}/contents/{contentID}/status:
    patch:
      consumes:
      - application/json
      description: Update content status
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Content ID
        format: int64
        in: path
        name: contentID
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperTenantContentStatusUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update content status
      tags:
      - Content
  /super/v1/tenants/{tenantID}/coupons:
    post:
      consumes:
      - application/json
      description: Create coupon for tenant
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Create form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.CouponCreateForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.CouponItem'
      summary: Create coupon
      tags:
      - Coupon
  /super/v1/tenants/{tenantID}/coupons/{id}:
    get:
      consumes:
      - application/json
      description: Get coupon detail
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Coupon ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.CouponItem'
      summary: Get coupon
      tags:
      - Coupon
    put:
      consumes:
      - application/json
      description: Update coupon for tenant
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Coupon ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.CouponUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.CouponItem'
      summary: Update coupon
      tags:
      - Coupon
  /super/v1/tenants/{tenantID}/coupons/{id}/grant:
    post:
      consumes:
      - application/json
      description: Grant coupon to users
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Coupon ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Grant form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.CouponGrantForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperCouponGrantResponse'
      summary: Grant coupon
      tags:
      - Coupon
  /super/v1/tenants/{tenantID}/invites:
    post:
      consumes:
      - application/json
      description: Create tenant invite code
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Invite form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.TenantInviteCreateForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.TenantInviteItem'
      summary: Create tenant invite
      tags:
      - Tenant
  /super/v1/tenants/{tenantID}/users:
    get:
      consumes:
      - application/json
      description: List tenant users
      parameters:
      - description: Tenant ID
        format: int64
        in: path
        name: tenantID
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperTenantUserItem'
                  type: array
              type: object
      summary: List tenant users
      tags:
      - Tenant
  /super/v1/tenants/health:
    get:
      consumes:
      - application/json
      description: Tenant health overview
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.TenantHealthItem'
                  type: array
              type: object
      summary: Tenant health overview
      tags:
      - Tenant
  /super/v1/tenants/statuses:
    get:
      consumes:
      - application/json
      description: Tenant statuses
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/requests.KV'
            type: array
      summary: Tenant statuses
      tags:
      - Tenant
  /super/v1/users:
    get:
      consumes:
      - application/json
      description: List users
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      - description: Username
        in: query
        name: username
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.UserItem'
                  type: array
              type: object
      summary: List users
      tags:
      - User
  /super/v1/users/{id}:
    get:
      consumes:
      - application/json
      description: Get user
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.UserItem'
      summary: Get user
      tags:
      - User
    patch:
      consumes:
      - application/json
      description: Update user profile fields
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperUserProfileUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update user profile
      tags:
      - User
  /super/v1/users/{id}/coupons:
    get:
      consumes:
      - application/json
      description: List coupons of a user
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperUserCouponItem'
                  type: array
              type: object
      summary: List user coupons
      tags:
      - User
  /super/v1/users/{id}/favorites:
    get:
      consumes:
      - application/json
      description: List user's favorited contents
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperUserContentActionItem'
                  type: array
              type: object
      summary: List user favorites
      tags:
      - User
  /super/v1/users/{id}/following:
    get:
      consumes:
      - application/json
      description: List tenants followed by user
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.UserTenantItem'
                  type: array
              type: object
      summary: List user following tenants
      tags:
      - User
  /super/v1/users/{id}/library:
    get:
      consumes:
      - application/json
      description: List purchased contents of a user
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperUserLibraryItem'
                  type: array
              type: object
      summary: List user library
      tags:
      - User
  /super/v1/users/{id}/likes:
    get:
      consumes:
      - application/json
      description: List user's liked contents
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperUserContentActionItem'
                  type: array
              type: object
      summary: List user likes
      tags:
      - User
  /super/v1/users/{id}/notifications:
    get:
      consumes:
      - application/json
      description: List notifications of a user
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperUserNotificationItem'
                  type: array
              type: object
      summary: List user notifications
      tags:
      - User
  /super/v1/users/{id}/realname:
    get:
      consumes:
      - application/json
      description: Get real-name verification detail of a user
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperUserRealNameResponse'
      summary: Get user real-name verification detail
      tags:
      - User
  /super/v1/users/{id}/roles:
    patch:
      consumes:
      - application/json
      description: Update user roles
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.UserRolesUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update user roles
      tags:
      - User
  /super/v1/users/{id}/status:
    patch:
      consumes:
      - application/json
      description: Update user status
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.UserStatusUpdateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update user status
      tags:
      - User
  /super/v1/users/{id}/tenants:
    get:
      consumes:
      - application/json
      description: List tenants joined by user
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.UserTenantItem'
                  type: array
              type: object
      summary: List user tenants
      tags:
      - User
  /super/v1/users/{id}/wallet:
    get:
      consumes:
      - application/json
      description: Get user wallet balance and transactions
      parameters:
      - description: User ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.SuperWalletResponse'
      summary: Get user wallet
      tags:
      - User
  /super/v1/users/statistics:
    get:
      consumes:
      - application/json
      description: User statistics
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.UserStatistics'
            type: array
      summary: User statistics
      tags:
      - User
  /super/v1/users/statuses:
    get:
      consumes:
      - application/json
      description: User statuses
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/requests.KV'
            type: array
      summary: User statuses
      tags:
      - User
  /super/v1/withdrawals:
    get:
      consumes:
      - application/json
      description: List withdrawal orders across tenants
      parameters:
      - description: Page number
        in: query
        name: page
        type: integer
      - description: Page size
        in: query
        name: limit
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.SuperOrderItem'
                  type: array
              type: object
      summary: List withdrawals
      tags:
      - Finance
  /super/v1/withdrawals/{id}/approve:
    post:
      consumes:
      - application/json
      description: Approve a withdrawal request
      parameters:
      - description: Withdrawal order ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: Approved
          schema:
            type: string
      summary: Approve withdrawal
      tags:
      - Finance
  /super/v1/withdrawals/{id}/reject:
    post:
      consumes:
      - application/json
      description: Reject a withdrawal request
      parameters:
      - description: Withdrawal order ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Reject form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.SuperWithdrawalRejectForm'
      produces:
      - application/json
      responses:
        "200":
          description: Rejected
          schema:
            type: string
      summary: Reject withdrawal
      tags:
      - Finance
  /v1/auth/login:
    post:
      consumes:
      - application/json
      description: Login or register user using phone number and OTP
      parameters:
      - description: Login form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/quyun_v2_app_http_v1_dto.LoginForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/quyun_v2_app_http_v1_dto.LoginResponse'
      summary: Login or Register with OTP
      tags:
      - Auth
  /v1/auth/otp:
    post:
      consumes:
      - application/json
      description: Send OTP to phone number
      parameters:
      - description: Phone number
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/quyun_v2_app_http_v1_dto.SendOTPForm'
      produces:
      - application/json
      responses:
        "200":
          description: OTP sent
          schema:
            type: string
      summary: Send OTP
      tags:
      - Auth
  /v1/t/{tenantCode}/comments/{id}/like:
    post:
      consumes:
      - application/json
      description: Like a comment
      parameters:
      - description: Comment ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: Liked
          schema:
            type: string
      summary: Like comment
      tags:
      - Content
  /v1/t/{tenantCode}/common/options:
    get:
      consumes:
      - application/json
      description: Get global options (enums)
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.OptionsResponse'
      summary: Get options
      tags:
      - Common
  /v1/t/{tenantCode}/contents:
    get:
      consumes:
      - application/json
      description: List contents with filtering and pagination
      parameters:
      - description: Search keyword
        in: query
        name: keyword
        type: string
      - description: Genre
        in: query
        name: genre
        type: string
      - description: Filter by tenant
        format: int64
        in: query
        name: tenant_id
        type: integer
      - description: Filter by author
        format: int64
        in: query
        name: author_id
        type: integer
      - description: Sort order
        enum:
        - latest
        - hot
        - price_asc
        in: query
        name: sort
        type: string
      - description: Page number
        in: query
        name: page
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.ContentItem'
                  type: array
              type: object
      summary: List contents
      tags:
      - Content
  /v1/t/{tenantCode}/contents/{id}:
    get:
      consumes:
      - application/json
      description: Get content detail by ID
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.ContentDetail'
      summary: Get content detail
      tags:
      - Content
  /v1/t/{tenantCode}/contents/{id}/comments:
    get:
      consumes:
      - application/json
      description: Get comments for a content
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Page number
        in: query
        name: page
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.Comment'
                  type: array
              type: object
      summary: Get comments
      tags:
      - Content
    post:
      consumes:
      - application/json
      description: Post a comment to a content
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      - description: Comment form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.CommentCreateForm'
      produces:
      - application/json
      responses:
        "200":
          description: Comment created
          schema:
            type: string
      summary: Post comment
      tags:
      - Content
  /v1/t/{tenantCode}/contents/{id}/favorite:
    delete:
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      responses:
        "200":
          description: Unfavorited
          schema:
            type: string
      summary: Remove favorite
      tags:
      - Content
    post:
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      responses:
        "200":
          description: Favorited
          schema:
            type: string
      summary: Add favorite
      tags:
      - Content
  /v1/t/{tenantCode}/contents/{id}/like:
    delete:
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      responses:
        "200":
          description: Unliked
          schema:
            type: string
      summary: Remove like
      tags:
      - Content
    post:
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      responses:
        "200":
          description: Liked
          schema:
            type: string
      summary: Add like
      tags:
      - Content
  /v1/t/{tenantCode}/me:
    get:
      consumes:
      - application/json
      description: Get current user profile
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/quyun_v2_app_http_v1_dto.User'
      summary: Get user profile
      tags:
      - UserCenter
    put:
      consumes:
      - application/json
      description: Update user profile
      parameters:
      - description: Update form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.UserUpdate'
      produces:
      - application/json
      responses:
        "200":
          description: Updated
          schema:
            type: string
      summary: Update user profile
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/coupons:
    get:
      consumes:
      - application/json
      description: List my coupons
      parameters:
      - description: Status (unused, used, expired)
        in: query
        name: status
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.UserCouponItem'
            type: array
      summary: List coupons
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/coupons/available:
    get:
      consumes:
      - application/json
      description: List coupons available for the given order amount
      parameters:
      - description: Order amount (cents)
        format: int64
        in: query
        name: amount
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.UserCouponItem'
            type: array
      summary: List available coupons
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/coupons/receive:
    post:
      consumes:
      - application/json
      description: Receive a coupon by coupon_id
      parameters:
      - description: Receive form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.CouponReceiveForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.UserCouponItem'
      summary: Receive coupon
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/favorites:
    get:
      consumes:
      - application/json
      description: Get favorites
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.ContentItem'
            type: array
      summary: Get favorites
      tags:
      - UserCenter
    post:
      consumes:
      - application/json
      description: Add to favorites
      parameters:
      - description: Content ID
        format: int64
        in: query
        name: content_id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: Added
          schema:
            type: string
      summary: Add favorite
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/favorites/{contentId}:
    delete:
      consumes:
      - application/json
      description: Remove from favorites
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: contentId
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: Removed
          schema:
            type: string
      summary: Remove favorite
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/following:
    get:
      consumes:
      - application/json
      description: Get following tenants
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.TenantProfile'
            type: array
      summary: Get following
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/library:
    get:
      consumes:
      - application/json
      description: Get purchased content
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.ContentItem'
            type: array
      summary: Get library
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/likes:
    get:
      consumes:
      - application/json
      description: Get liked contents
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.ContentItem'
            type: array
      summary: Get likes
      tags:
      - UserCenter
    post:
      consumes:
      - application/json
      description: Like content
      parameters:
      - description: Content ID
        format: int64
        in: query
        name: content_id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: Liked
          schema:
            type: string
      summary: Like content
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/likes/{contentId}:
    delete:
      consumes:
      - application/json
      description: Unlike content
      parameters:
      - description: Content ID
        format: int64
        in: path
        name: contentId
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: Unliked
          schema:
            type: string
      summary: Unlike content
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/notifications:
    get:
      consumes:
      - application/json
      description: Get notifications
      parameters:
      - description: Type enum(all, system, order, audit, interaction)
        in: query
        name: type
        type: string
      - description: Page number
        in: query
        name: page
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/requests.Pager'
            - properties:
                items:
                  items:
                    $ref: '#/definitions/dto.Notification'
                  type: array
              type: object
      summary: Get notifications
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/notifications/{id}/read:
    post:
      consumes:
      - application/json
      parameters:
      - description: Notification ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            type: string
      summary: Mark as read
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/notifications/read-all:
    post:
      consumes:
      - application/json
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            type: string
      summary: Mark all as read
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/orders:
    get:
      consumes:
      - application/json
      description: List user orders
      parameters:
      - description: Status enum(all, unpaid, completed, refund)
        in: query
        name: status
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.Order'
            type: array
      summary: List orders
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/orders/{id}:
    get:
      consumes:
      - application/json
      description: Get user order detail
      parameters:
      - description: Order ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.Order'
      summary: Get order detail
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/realname:
    post:
      consumes:
      - application/json
      description: Submit real-name authentication
      parameters:
      - description: Realname form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.RealNameForm'
      produces:
      - application/json
      responses:
        "200":
          description: Submitted
          schema:
            type: string
      summary: Realname auth
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/wallet:
    get:
      consumes:
      - application/json
      description: Get wallet balance and transactions
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.WalletResponse'
      summary: Get wallet
      tags:
      - UserCenter
  /v1/t/{tenantCode}/me/wallet/recharge:
    post:
      consumes:
      - application/json
      description: Recharge wallet
      parameters:
      - description: Recharge form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.RechargeForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.RechargeResponse'
      summary: Recharge wallet
      tags:
      - UserCenter
  /v1/t/{tenantCode}/media-assets/{id}:
    delete:
      consumes:
      - application/json
      description: Delete media asset
      parameters:
      - description: Asset ID
        format: int64
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            type: string
      summary: Delete media asset
      tags:
      - Common
  /v1/t/{tenantCode}/storage/{any}:
    get:
      consumes:
      - application/json
      parameters:
      - description: any path
        in: path
        name: any
        type: string
      - description: Expiry
        in: query
        name: expires
        required: true
        type: string
      - description: Signature
        in: query
        name: sign
        required: true
        type: string
      produces:
      - application/octet-stream
      responses:
        "200":
          description: OK
          schema:
            type: file
      summary: Download file
      tags:
      - Storage
    put:
      consumes:
      - application/octet-stream
      parameters:
      - description: any path
        in: path
        name: any
        type: string
      - description: Expiry
        in: query
        name: expires
        required: true
        type: string
      - description: Signature
        in: query
        name: sign
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: success
          schema:
            type: string
      summary: Upload file
      tags:
      - Storage
  /v1/t/{tenantCode}/topics:
    get:
      consumes:
      - application/json
      description: List curated topics
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              $ref: '#/definitions/dto.Topic'
            type: array
      summary: List topics
      tags:
      - Content
  /v1/t/{tenantCode}/upload:
    post:
      consumes:
      - multipart/form-data
      description: Upload file
      parameters:
      - description: File
        in: formData
        name: file
        required: true
        type: file
      - description: Type 上传资源类型（如 cover/media/avatar）。
        in: formData
        name: type
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.UploadResult'
      summary: Upload file
      tags:
      - Common
  /v1/t/{tenantCode}/upload/{uploadId}:
    delete:
      consumes:
      - application/json
      description: Abort multipart upload
      parameters:
      - description: Upload ID
        in: path
        name: uploadId
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            type: string
      summary: Abort upload
      tags:
      - Common
  /v1/t/{tenantCode}/upload/check:
    get:
      consumes:
      - application/json
      description: Check if file hash exists
      parameters:
      - description: File MD5 Hash
        in: query
        name: hash
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.UploadResult'
      summary: Check hash
      tags:
      - Common
  /v1/t/{tenantCode}/upload/complete:
    post:
      consumes:
      - application/json
      description: Complete multipart upload
      parameters:
      - description: Complete form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.UploadCompleteForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.UploadResult'
      summary: Complete upload
      tags:
      - Common
  /v1/t/{tenantCode}/upload/init:
    post:
      consumes:
      - application/json
      description: Initialize multipart upload
      parameters:
      - description: Init form
        in: body
        name: form
        required: true
        schema:
          $ref: '#/definitions/dto.UploadInitForm'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/dto.UploadInitResponse'
      summary: Init multipart upload
      tags:
      - Common
  /v1/t/{tenantCode}/upload/part:
    post:
      consumes:
      - multipart/form-data
      description: Upload a part
      parameters:
      - description: Part File
        in: formData
        name: file
        required: true
        type: file
      - description: PartNumber 分片序号（从 1 开始）。
        in: formData
        name: part_number
        type: integer
      - description: UploadID 分片上传ID。
        in: formData
        name: upload_id
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            type: string
      summary: Upload part
      tags:
      - Common
securityDefinitions:
  BasicAuth:
    type: basic
swagger: "2.0"