tyapi-server/docs/swagger.yaml

basePath: /
definitions:
  commands.AddPackageItemCommand:
    properties:
      product_id:
        type: string
    required:
    - product_id
    type: object
  commands.ApiCallCommand:
    properties:
      data:
        type: string
      options:
        $ref: '#/definitions/commands.ApiCallOptions'
    required:
    - data
    type: object
  commands.ApiCallOptions:
    properties:
      is_debug:
        description: 是否为调试调用
        type: boolean
      json:
        description: 是否返回JSON格式
        type: boolean
    type: object
  commands.ApplyContractCommand:
    properties:
      user_id:
        type: string
    required:
    - user_id
    type: object
  commands.BatchUpdateSubscriptionPricesCommand:
    properties:
      discount:
        maximum: 10
        minimum: 0.1
        type: number
      scope:
        enum:
        - undiscounted
        - all
        type: string
      user_id:
        type: string
    required:
    - discount
    - scope
    - user_id
    type: object
  commands.ChangePasswordCommand:
    description: 修改用户密码请求参数
    properties:
      code:
        example: "123456"
        type: string
      confirm_new_password:
        example: NewPassword123
        type: string
      new_password:
        example: NewPassword123
        type: string
      old_password:
        example: OldPassword123
        maxLength: 128
        minLength: 6
        type: string
    required:
    - code
    - confirm_new_password
    - new_password
    - old_password
    type: object
  commands.CreateAlipayRechargeCommand:
    properties:
      amount:
        description: 充值金额
        type: string
      platform:
        description: 支付平台：app/h5/pc
        enum:
        - app
        - h5
        - pc
        type: string
    required:
    - amount
    - platform
    type: object
  commands.CreateArticleCommand:
    properties:
      category_id:
        type: string
      content:
        type: string
      cover_image:
        type: string
      is_featured:
        type: boolean
      summary:
        type: string
      tag_ids:
        items:
          type: string
        type: array
      title:
        type: string
    required:
    - content
    - title
    type: object
  commands.CreateCategoryCommand:
    properties:
      code:
        type: string
      description:
        maxLength: 200
        type: string
      is_enabled:
        type: boolean
      is_visible:
        type: boolean
      name:
        maxLength: 50
        minLength: 2
        type: string
      sort:
        maximum: 9999
        minimum: 0
        type: integer
    required:
    - code
    - name
    type: object
  commands.CreateDocumentationCommand:
    properties:
      basic_info:
        type: string
      error_codes:
        type: string
      product_id:
        type: string
      request_method:
        type: string
      request_params:
        type: string
      request_url:
        type: string
      response_example:
        type: string
      response_fields:
        type: string
    required:
    - basic_info
    - product_id
    - request_method
    - request_params
    - request_url
    type: object
  commands.CreateProductCommand:
    properties:
      category_id:
        type: string
      code:
        type: string
      content:
        maxLength: 5000
        type: string
      description:
        maxLength: 500
        type: string
      is_enabled:
        type: boolean
      is_package:
        type: boolean
      is_visible:
        type: boolean
      name:
        maxLength: 100
        minLength: 2
        type: string
      price:
        minimum: 0
        type: number
      seo_description:
        maxLength: 200
        type: string
      seo_keywords:
        maxLength: 200
        type: string
      seo_title:
        description: SEO信息
        maxLength: 100
        type: string
    required:
    - category_id
    - code
    - name
    type: object
  commands.DecryptCommand:
    properties:
      encrypted_data:
        type: string
      secret_key:
        type: string
    required:
    - encrypted_data
    - secret_key
    type: object
  commands.EncryptCommand:
    properties:
      data:
        additionalProperties: true
        type: object
      secret_key:
        type: string
    required:
    - data
    - secret_key
    type: object
  commands.LoginWithPasswordCommand:
    description: 使用密码进行用户登录请求参数
    properties:
      password:
        example: Password123
        maxLength: 128
        minLength: 6
        type: string
      phone:
        example: "13800138000"
        type: string
    required:
    - password
    - phone
    type: object
  commands.LoginWithSMSCommand:
    description: 使用短信验证码进行用户登录请求参数
    properties:
      code:
        example: "123456"
        type: string
      phone:
        example: "13800138000"
        type: string
    required:
    - code
    - phone
    type: object
  commands.PackageItemData:
    properties:
      product_id:
        type: string
      sort_order:
        minimum: 0
        type: integer
    required:
    - product_id
    - sort_order
    type: object
  commands.RegisterUserCommand:
    description: 用户注册请求参数
    properties:
      code:
        example: "123456"
        type: string
      confirm_password:
        example: Password123
        type: string
      password:
        example: Password123
        type: string
      phone:
        example: "13800138000"
        type: string
    required:
    - code
    - confirm_password
    - password
    - phone
    type: object
  commands.ReorderPackageItemsCommand:
    properties:
      item_ids:
        items:
          type: string
        type: array
    required:
    - item_ids
    type: object
  commands.ResetPasswordCommand:
    description: 重置用户密码请求参数（忘记密码时使用）
    properties:
      code:
        example: "123456"
        type: string
      confirm_new_password:
        example: NewPassword123
        type: string
      new_password:
        example: NewPassword123
        type: string
      phone:
        example: "13800138000"
        type: string
    required:
    - code
    - confirm_new_password
    - new_password
    - phone
    type: object
  commands.SendCodeCommand:
    description: 发送短信验证码请求参数
    properties:
      phone:
        example: "13800138000"
        type: string
      scene:
        enum:
        - register
        - login
        - change_password
        - reset_password
        - bind
        - unbind
        - certification
        example: register
        type: string
    required:
    - phone
    - scene
    type: object
  commands.SetFeaturedCommand:
    properties:
      is_featured:
        type: boolean
    required:
    - is_featured
    type: object
  commands.SubmitEnterpriseInfoCommand:
    properties:
      company_name:
        maxLength: 100
        minLength: 2
        type: string
      enterprise_address:
        type: string
      legal_person_id:
        type: string
      legal_person_name:
        maxLength: 20
        minLength: 2
        type: string
      legal_person_phone:
        type: string
      unified_social_code:
        type: string
      verification_code:
        type: string
    required:
    - company_name
    - enterprise_address
    - legal_person_id
    - legal_person_name
    - legal_person_phone
    - unified_social_code
    - verification_code
    type: object
  commands.UpdateArticleCommand:
    properties:
      category_id:
        type: string
      content:
        type: string
      cover_image:
        type: string
      is_featured:
        type: boolean
      summary:
        type: string
      tag_ids:
        items:
          type: string
        type: array
      title:
        type: string
    type: object
  commands.UpdateCategoryCommand:
    properties:
      code:
        type: string
      description:
        maxLength: 200
        type: string
      is_enabled:
        type: boolean
      is_visible:
        type: boolean
      name:
        maxLength: 50
        minLength: 2
        type: string
      sort:
        maximum: 9999
        minimum: 0
        type: integer
    required:
    - code
    - name
    type: object
  commands.UpdatePackageItemCommand:
    properties:
      sort_order:
        minimum: 0
        type: integer
    required:
    - sort_order
    type: object
  commands.UpdatePackageItemsCommand:
    properties:
      items:
        items:
          $ref: '#/definitions/commands.PackageItemData'
        type: array
    required:
    - items
    type: object
  commands.UpdateProductCommand:
    properties:
      category_id:
        type: string
      code:
        type: string
      content:
        maxLength: 5000
        type: string
      description:
        maxLength: 500
        type: string
      is_enabled:
        type: boolean
      is_package:
        type: boolean
      is_visible:
        type: boolean
      name:
        maxLength: 100
        minLength: 2
        type: string
      price:
        minimum: 0
        type: number
      seo_description:
        maxLength: 200
        type: string
      seo_keywords:
        maxLength: 200
        type: string
      seo_title:
        description: SEO信息
        maxLength: 100
        type: string
    required:
    - category_id
    - code
    - name
    type: object
  commands.UpdateSubscriptionPriceCommand:
    properties:
      price:
        minimum: 0
        type: number
    type: object
  dto.ApiCallListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/dto.ApiCallRecordResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  dto.ApiCallRecordResponse:
    properties:
      access_id:
        type: string
      client_ip:
        type: string
      company_name:
        type: string
      cost:
        type: string
      created_at:
        type: string
      end_at:
        type: string
      error_msg:
        type: string
      error_type:
        type: string
      id:
        type: string
      product_id:
        type: string
      product_name:
        type: string
      start_at:
        type: string
      status:
        type: string
      transaction_id:
        type: string
      translated_error_msg:
        type: string
      updated_at:
        type: string
      user:
        $ref: '#/definitions/dto.UserSimpleResponse'
      user_id:
        type: string
    type: object
  dto.ApiCallResponse:
    properties:
      code:
        type: integer
      data:
        type: string
      message:
        type: string
      transaction_id:
        type: string
    type: object
  dto.AvailableAmountResponse:
    properties:
      available_amount:
        description: 可开票金额
        type: number
      pending_applications:
        description: 待处理申请金额
        type: number
      total_gifted:
        description: 总赠送金额
        type: number
      total_invoiced:
        description: 已开票金额
        type: number
      total_recharged:
        description: 总充值金额
        type: number
    type: object
  dto.EncryptResponse:
    properties:
      encrypted_data:
        type: string
    type: object
  dto.InvoiceApplicationResponse:
    properties:
      amount:
        type: number
      created_at:
        type: string
      id:
        type: string
      invoice_info:
        $ref: '#/definitions/value_objects.InvoiceInfo'
      invoice_type:
        $ref: '#/definitions/value_objects.InvoiceType'
      status:
        $ref: '#/definitions/entities.ApplicationStatus'
      user_id:
        type: string
    type: object
  dto.InvoiceInfoResponse:
    properties:
      bank_account:
        description: 用户可编辑
        type: string
      bank_name:
        description: 用户可编辑
        type: string
      company_address:
        description: 用户可编辑
        type: string
      company_name:
        description: 从企业认证信息获取，只读
        type: string
      company_name_read_only:
        description: 字段权限标识
        type: boolean
      company_phone:
        description: 用户可编辑
        type: string
      is_complete:
        type: boolean
      missing_fields:
        items:
          type: string
        type: array
      receiving_email:
        description: 用户可编辑
        type: string
      taxpayer_id:
        description: 从企业认证信息获取，只读
        type: string
      taxpayer_id_read_only:
        description: 纳税人识别号是否只读
        type: boolean
    type: object
  dto.InvoiceRecordResponse:
    properties:
      amount:
        type: number
      bank_account:
        description: 银行账号
        type: string
      bank_name:
        description: 开户银行
        type: string
      company_address:
        description: 企业地址
        type: string
      company_name:
        description: 开票信息（快照数据）
        type: string
      company_phone:
        description: 企业电话
        type: string
      created_at:
        type: string
      file_name:
        description: 文件信息
        type: string
      file_size:
        type: integer
      file_url:
        type: string
      id:
        type: string
      invoice_type:
        $ref: '#/definitions/value_objects.InvoiceType'
      processed_at:
        description: 时间信息
        type: string
      receiving_email:
        description: 接收邮箱
        type: string
      reject_reason:
        description: 拒绝原因
        type: string
      status:
        $ref: '#/definitions/entities.ApplicationStatus'
      taxpayer_id:
        description: 纳税人识别号
        type: string
      user_id:
        type: string
    type: object
  dto.InvoiceRecordsResponse:
    properties:
      page:
        type: integer
      page_size:
        type: integer
      records:
        items:
          $ref: '#/definitions/dto.InvoiceRecordResponse'
        type: array
      total:
        type: integer
      total_pages:
        type: integer
    type: object
  dto.PendingApplicationResponse:
    properties:
      amount:
        type: number
      bank_account:
        type: string
      bank_name:
        type: string
      company_address:
        type: string
      company_name:
        type: string
      company_phone:
        type: string
      created_at:
        type: string
      file_name:
        type: string
      file_size:
        type: integer
      file_url:
        type: string
      id:
        type: string
      invoice_type:
        $ref: '#/definitions/value_objects.InvoiceType'
      processed_at:
        type: string
      receiving_email:
        type: string
      reject_reason:
        type: string
      status:
        $ref: '#/definitions/entities.ApplicationStatus'
      taxpayer_id:
        type: string
      user_id:
        type: string
    type: object
  dto.PendingApplicationsResponse:
    properties:
      applications:
        items:
          $ref: '#/definitions/dto.PendingApplicationResponse'
        type: array
      page:
        type: integer
      page_size:
        type: integer
      total:
        type: integer
      total_pages:
        type: integer
    type: object
  dto.UserSimpleResponse:
    properties:
      company_name:
        type: string
      id:
        type: string
      phone:
        type: string
    type: object
  entities.ApplicationStatus:
    enum:
    - pending
    - completed
    - rejected
    type: string
    x-enum-comments:
      ApplicationStatusCompleted: 已完成（已上传发票）
      ApplicationStatusPending: 待处理
      ApplicationStatusRejected: 已拒绝
    x-enum-descriptions:
    - 待处理
    - 已完成（已上传发票）
    - 已拒绝
    x-enum-varnames:
    - ApplicationStatusPending
    - ApplicationStatusCompleted
    - ApplicationStatusRejected
  enums.CertificationStatus:
    enum:
    - pending
    - info_submitted
    - enterprise_verified
    - contract_applied
    - contract_signed
    - completed
    - info_rejected
    - contract_rejected
    - contract_expired
    type: string
    x-enum-comments:
      StatusCompleted: 认证完成
      StatusContractApplied: 已申请签署合同
      StatusContractExpired: 合同签署超时
      StatusContractRejected: 合同被拒签
      StatusContractSigned: 已签署合同
      StatusEnterpriseVerified: 已企业认证
      StatusInfoRejected: 企业信息被拒绝
      StatusInfoSubmitted: 已提交企业信息
      StatusPending: 待认证
    x-enum-descriptions:
    - 待认证
    - 已提交企业信息
    - 已企业认证
    - 已申请签署合同
    - 已签署合同
    - 认证完成
    - 企业信息被拒绝
    - 合同被拒签
    - 合同签署超时
    x-enum-varnames:
    - StatusPending
    - StatusInfoSubmitted
    - StatusEnterpriseVerified
    - StatusContractApplied
    - StatusContractSigned
    - StatusCompleted
    - StatusInfoRejected
    - StatusContractRejected
    - StatusContractExpired
  enums.FailureReason:
    enum:
    - enterprise_not_exists
    - enterprise_info_mismatch
    - enterprise_status_abnormal
    - legal_person_mismatch
    - esign_verification_failed
    - invalid_document
    - contract_rejected_by_user
    - contract_expired
    - sign_process_failed
    - contract_gen_failed
    - esign_flow_error
    - system_error
    - network_error
    - timeout
    - unknown_error
    type: string
    x-enum-comments:
      FailureReasonContractExpired: 合同签署超时
      FailureReasonContractGenFailed: 合同生成失败
      FailureReasonContractRejectedByUser: 用户拒绝签署
      FailureReasonEnterpriseInfoMismatch: 企业信息不匹配
      FailureReasonEnterpriseNotExists: 企业不存在
      FailureReasonEnterpriseStatusAbnormal: 企业状态异常
      FailureReasonEsignFlowError: e签宝流程错误
      FailureReasonEsignVerificationFailed: e签宝验证失败
      FailureReasonInvalidDocument: 证件信息无效
      FailureReasonLegalPersonMismatch: 法定代表人信息不匹配
      FailureReasonNetworkError: 网络错误
      FailureReasonSignProcessFailed: 签署流程失败
      FailureReasonSystemError: 系统错误
      FailureReasonTimeout: 操作超时
      FailureReasonUnknownError: 未知错误
    x-enum-descriptions:
    - 企业不存在
    - 企业信息不匹配
    - 企业状态异常
    - 法定代表人信息不匹配
    - e签宝验证失败
    - 证件信息无效
    - 用户拒绝签署
    - 合同签署超时
    - 签署流程失败
    - 合同生成失败
    - e签宝流程错误
    - 系统错误
    - 网络错误
    - 操作超时
    - 未知错误
    x-enum-varnames:
    - FailureReasonEnterpriseNotExists
    - FailureReasonEnterpriseInfoMismatch
    - FailureReasonEnterpriseStatusAbnormal
    - FailureReasonLegalPersonMismatch
    - FailureReasonEsignVerificationFailed
    - FailureReasonInvalidDocument
    - FailureReasonContractRejectedByUser
    - FailureReasonContractExpired
    - FailureReasonSignProcessFailed
    - FailureReasonContractGenFailed
    - FailureReasonEsignFlowError
    - FailureReasonSystemError
    - FailureReasonNetworkError
    - FailureReasonTimeout
    - FailureReasonUnknownError
  finance.ApplyInvoiceRequest:
    properties:
      amount:
        description: 开票金额
        type: string
      invoice_type:
        description: 发票类型：general/special
        type: string
    required:
    - amount
    - invoice_type
    type: object
  finance.RejectInvoiceRequest:
    properties:
      reason:
        description: 拒绝原因
        type: string
    required:
    - reason
    type: object
  finance.UpdateInvoiceInfoRequest:
    properties:
      bank_account:
        description: 银行账户
        type: string
      bank_name:
        description: 银行名称
        type: string
      company_address:
        description: 公司地址
        type: string
      company_name:
        description: 公司名称（从企业认证信息获取，用户不可修改）
        type: string
      company_phone:
        description: 企业注册电话
        type: string
      receiving_email:
        description: 发票接收邮箱
        type: string
      taxpayer_id:
        description: 纳税人识别号（从企业认证信息获取，用户不可修改）
        type: string
    required:
    - receiving_email
    type: object
  interfaces.APIResponse:
    properties:
      data: {}
      errors: {}
      message:
        type: string
      meta:
        additionalProperties: true
        type: object
      pagination:
        $ref: '#/definitions/interfaces.PaginationMeta'
      request_id:
        type: string
      success:
        type: boolean
      timestamp:
        type: integer
    type: object
  interfaces.PaginationMeta:
    properties:
      has_next:
        type: boolean
      has_prev:
        type: boolean
      page:
        type: integer
      page_size:
        type: integer
      total:
        type: integer
      total_pages:
        type: integer
    type: object
  queries.ConfirmAuthCommand:
    type: object
  queries.ConfirmSignCommand:
    type: object
  responses.AlipayOrderStatusResponse:
    properties:
      amount:
        description: 订单金额
        type: number
      can_retry:
        description: 是否可以重试
        type: boolean
      created_at:
        description: 创建时间
        type: string
      error_code:
        description: 错误码
        type: string
      error_message:
        description: 错误信息
        type: string
      is_processing:
        description: 是否处理中
        type: boolean
      notify_time:
        description: 异步通知时间
        type: string
      out_trade_no:
        description: 商户订单号
        type: string
      platform:
        description: 支付平台
        type: string
      return_time:
        description: 同步返回时间
        type: string
      status:
        description: 订单状态
        type: string
      subject:
        description: 订单标题
        type: string
      trade_no:
        description: 支付宝交易号
        type: string
      updated_at:
        description: 更新时间
        type: string
    type: object
  responses.AlipayRechargeBonusRuleResponse:
    properties:
      bonus_amount:
        type: number
      recharge_amount:
        type: number
    type: object
  responses.AlipayRechargeOrderResponse:
    properties:
      amount:
        description: 充值金额
        type: number
      out_trade_no:
        description: 商户订单号
        type: string
      pay_url:
        description: 支付链接
        type: string
      platform:
        description: 支付平台
        type: string
      subject:
        description: 订单标题
        type: string
    type: object
  responses.ArticleInfoResponse:
    properties:
      category:
        $ref: '#/definitions/tyapi-server_internal_application_article_dto_responses.CategoryInfoResponse'
      category_id:
        type: string
      content:
        type: string
      cover_image:
        type: string
      created_at:
        type: string
      id:
        type: string
      is_featured:
        type: boolean
      published_at:
        type: string
      status:
        type: string
      summary:
        type: string
      tags:
        items:
          $ref: '#/definitions/responses.TagInfoResponse'
        type: array
      title:
        type: string
      updated_at:
        type: string
      view_count:
        type: integer
    type: object
  responses.ArticleListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.ArticleInfoResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.ArticleStatsResponse:
    properties:
      archived_articles:
        type: integer
      draft_articles:
        type: integer
      published_articles:
        type: integer
      total_articles:
        type: integer
      total_views:
        type: integer
    type: object
  responses.CategoryListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.CategorySimpleResponse:
    properties:
      code:
        type: string
      id:
        type: string
      name:
        type: string
    type: object
  responses.CertificationListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.CertificationResponse'
        type: array
      page:
        type: integer
      page_size:
        type: integer
      total:
        type: integer
      total_pages:
        type: integer
    type: object
  responses.CertificationResponse:
    properties:
      available_actions:
        items:
          type: string
        type: array
      can_retry:
        type: boolean
      completed_at:
        type: string
      contract_applied_at:
        type: string
      contract_info:
        allOf:
        - $ref: '#/definitions/value_objects.ContractInfo'
        description: 合同信息
      contract_signed_at:
        type: string
      created_at:
        description: 时间戳
        type: string
      enterprise_info:
        allOf:
        - $ref: '#/definitions/value_objects.EnterpriseInfo'
        description: 企业信息
      enterprise_verified_at:
        type: string
      failure_message:
        type: string
      failure_reason:
        allOf:
        - $ref: '#/definitions/enums.FailureReason'
        description: 失败信息
      failure_reason_name:
        type: string
      id:
        type: string
      info_submitted_at:
        type: string
      is_completed:
        description: 业务状态
        type: boolean
      is_failed:
        type: boolean
      is_user_action_required:
        type: boolean
      metadata:
        additionalProperties: true
        description: 元数据
        type: object
      next_action:
        description: 用户操作提示
        type: string
      progress:
        type: integer
      retry_count:
        type: integer
      status:
        $ref: '#/definitions/enums.CertificationStatus'
      status_name:
        type: string
      updated_at:
        type: string
      user_id:
        type: string
    type: object
  responses.ConfirmAuthResponse:
    properties:
      reason:
        type: string
      status:
        $ref: '#/definitions/enums.CertificationStatus'
    type: object
  responses.ConfirmSignResponse:
    properties:
      reason:
        type: string
      status:
        $ref: '#/definitions/enums.CertificationStatus'
    type: object
  responses.ContractInfoItem:
    properties:
      contract_file_url:
        type: string
      contract_name:
        type: string
      contract_type:
        description: 合同类型代码
        type: string
      contract_type_name:
        description: 合同类型中文名称
        type: string
      created_at:
        type: string
      id:
        type: string
    type: object
  responses.ContractSignUrlResponse:
    properties:
      certification_id:
        type: string
      contract_sign_url:
        type: string
      contract_url:
        type: string
      expire_at:
        type: string
      message:
        type: string
      next_action:
        type: string
    type: object
  responses.DocumentationResponse:
    properties:
      basic_info:
        type: string
      created_at:
        type: string
      error_codes:
        type: string
      id:
        type: string
      product_id:
        type: string
      request_method:
        type: string
      request_params:
        type: string
      request_url:
        type: string
      response_example:
        type: string
      response_fields:
        type: string
      updated_at:
        type: string
      version:
        type: string
    type: object
  responses.EnterpriseInfoItem:
    properties:
      company_name:
        type: string
      contracts:
        description: 合同信息
        items:
          $ref: '#/definitions/responses.ContractInfoItem'
        type: array
      created_at:
        type: string
      enterprise_address:
        type: string
      id:
        type: string
      legal_person_name:
        type: string
      legal_person_phone:
        type: string
      unified_social_code:
        type: string
    type: object
  responses.EnterpriseInfoResponse:
    description: 企业信息响应
    properties:
      certified_at:
        example: "2024-01-01T00:00:00Z"
        type: string
      company_name:
        example: 示例企业有限公司
        type: string
      created_at:
        example: "2024-01-01T00:00:00Z"
        type: string
      enterprise_address:
        example: 北京市朝阳区xxx街道xxx号
        type: string
      id:
        example: 123e4567-e89b-12d3-a456-426614174000
        type: string
      legal_person_id:
        example: "110101199001011234"
        type: string
      legal_person_name:
        example: 张三
        type: string
      legal_person_phone:
        example: "13800138000"
        type: string
      unified_social_code:
        example: 91110000123456789X
        type: string
      updated_at:
        example: "2024-01-01T00:00:00Z"
        type: string
    type: object
  responses.LoginUserResponse:
    description: 用户登录成功响应
    properties:
      access_token:
        example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
        type: string
      expires_in:
        example: 86400
        type: integer
      login_method:
        example: password
        type: string
      token_type:
        example: Bearer
        type: string
      user:
        $ref: '#/definitions/responses.UserProfileResponse'
    type: object
  responses.PackageItemResponse:
    properties:
      id:
        type: string
      price:
        type: number
      product_code:
        type: string
      product_id:
        type: string
      product_name:
        type: string
      sort_order:
        type: integer
    type: object
  responses.ProductAdminInfoResponse:
    properties:
      category:
        allOf:
        - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse'
        description: 关联信息
      category_id:
        type: string
      code:
        type: string
      content:
        type: string
      created_at:
        type: string
      description:
        type: string
      documentation:
        allOf:
        - $ref: '#/definitions/responses.DocumentationResponse'
        description: 文档信息
      id:
        type: string
      is_enabled:
        type: boolean
      is_package:
        type: boolean
      is_visible:
        type: boolean
      name:
        type: string
      old_id:
        type: string
      package_items:
        description: 组合包信息
        items:
          $ref: '#/definitions/responses.PackageItemResponse'
        type: array
      price:
        type: number
      seo_description:
        type: string
      seo_keywords:
        type: string
      seo_title:
        description: SEO信息
        type: string
      updated_at:
        type: string
    type: object
  responses.ProductAdminListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.ProductAdminInfoResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.ProductApiConfigResponse:
    properties:
      created_at:
        type: string
      id:
        type: string
      product_id:
        type: string
      request_params:
        items:
          $ref: '#/definitions/responses.RequestParamResponse'
        type: array
      response_example:
        additionalProperties: true
        type: object
      response_fields:
        items:
          $ref: '#/definitions/responses.ResponseFieldResponse'
        type: array
      updated_at:
        type: string
    type: object
  responses.ProductInfoResponse:
    properties:
      category:
        allOf:
        - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse'
        description: 关联信息
      category_id:
        type: string
      code:
        type: string
      content:
        type: string
      created_at:
        type: string
      description:
        type: string
      id:
        type: string
      is_enabled:
        type: boolean
      is_package:
        type: boolean
      is_subscribed:
        type: boolean
      name:
        type: string
      old_id:
        type: string
      package_items:
        description: 组合包信息
        items:
          $ref: '#/definitions/responses.PackageItemResponse'
        type: array
      price:
        type: number
      seo_description:
        type: string
      seo_keywords:
        type: string
      seo_title:
        description: SEO信息
        type: string
      updated_at:
        type: string
    type: object
  responses.ProductInfoWithDocumentResponse:
    properties:
      category:
        allOf:
        - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse'
        description: 关联信息
      category_id:
        type: string
      code:
        type: string
      content:
        type: string
      created_at:
        type: string
      description:
        type: string
      documentation:
        $ref: '#/definitions/responses.DocumentationResponse'
      id:
        type: string
      is_enabled:
        type: boolean
      is_package:
        type: boolean
      is_subscribed:
        type: boolean
      name:
        type: string
      old_id:
        type: string
      package_items:
        description: 组合包信息
        items:
          $ref: '#/definitions/responses.PackageItemResponse'
        type: array
      price:
        type: number
      seo_description:
        type: string
      seo_keywords:
        type: string
      seo_title:
        description: SEO信息
        type: string
      updated_at:
        type: string
    type: object
  responses.ProductListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.ProductInfoResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.ProductSimpleResponse:
    properties:
      category:
        $ref: '#/definitions/responses.CategorySimpleResponse'
      code:
        type: string
      description:
        type: string
      id:
        type: string
      is_package:
        type: boolean
      is_subscribed:
        type: boolean
      name:
        type: string
      old_id:
        type: string
      price:
        type: number
    type: object
  responses.ProductStatsResponse:
    properties:
      enabled_products:
        type: integer
      package_products:
        type: integer
      total_products:
        type: integer
      visible_products:
        type: integer
    type: object
  responses.RechargeConfigResponse:
    properties:
      alipay_recharge_bonus:
        items:
          $ref: '#/definitions/responses.AlipayRechargeBonusRuleResponse'
        type: array
      max_amount:
        description: 最高充值金额
        type: string
      min_amount:
        description: 最低充值金额
        type: string
    type: object
  responses.RechargeRecordListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.RechargeRecordResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.RechargeRecordResponse:
    properties:
      alipay_order_id:
        type: string
      amount:
        type: number
      company_name:
        type: string
      created_at:
        type: string
      id:
        type: string
      notes:
        type: string
      operator_id:
        type: string
      recharge_type:
        type: string
      status:
        type: string
      transfer_order_id:
        type: string
      updated_at:
        type: string
      user:
        $ref: '#/definitions/tyapi-server_internal_application_finance_dto_responses.UserSimpleResponse'
      user_id:
        type: string
    type: object
  responses.RegisterUserResponse:
    description: 用户注册成功响应
    properties:
      id:
        example: 123e4567-e89b-12d3-a456-426614174000
        type: string
      phone:
        example: "13800138000"
        type: string
    type: object
  responses.RequestParamResponse:
    properties:
      description:
        type: string
      example:
        type: string
      field:
        type: string
      name:
        type: string
      required:
        type: boolean
      type:
        type: string
      validation:
        type: string
    type: object
  responses.ResponseFieldResponse:
    properties:
      description:
        type: string
      example:
        type: string
      name:
        type: string
      path:
        type: string
      required:
        type: boolean
      type:
        type: string
    type: object
  responses.SubscriptionInfoResponse:
    properties:
      api_used:
        type: integer
      created_at:
        type: string
      id:
        type: string
      price:
        type: number
      product:
        $ref: '#/definitions/responses.ProductSimpleResponse'
      product_id:
        type: string
      updated_at:
        type: string
      user:
        allOf:
        - $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.UserSimpleResponse'
        description: 关联信息
      user_id:
        type: string
    type: object
  responses.SubscriptionListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.SubscriptionInfoResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.SubscriptionStatsResponse:
    properties:
      total_revenue:
        type: number
      total_subscriptions:
        type: integer
    type: object
  responses.TagInfoResponse:
    properties:
      color:
        type: string
      created_at:
        type: string
      id:
        type: string
      name:
        type: string
    type: object
  responses.UserDetailResponse:
    properties:
      created_at:
        type: string
      enterprise_info:
        allOf:
        - $ref: '#/definitions/responses.EnterpriseInfoItem'
        description: 企业信息
      id:
        type: string
      is_active:
        type: boolean
      is_certified:
        type: boolean
      last_login_at:
        type: string
      login_count:
        type: integer
      phone:
        type: string
      updated_at:
        type: string
      user_type:
        type: string
      username:
        type: string
      wallet_balance:
        description: 钱包信息
        type: string
    type: object
  responses.UserListItem:
    properties:
      created_at:
        type: string
      enterprise_info:
        allOf:
        - $ref: '#/definitions/responses.EnterpriseInfoItem'
        description: 企业信息
      id:
        type: string
      is_active:
        type: boolean
      is_certified:
        type: boolean
      last_login_at:
        type: string
      login_count:
        type: integer
      phone:
        type: string
      updated_at:
        type: string
      user_type:
        type: string
      username:
        type: string
      wallet_balance:
        description: 钱包信息
        type: string
    type: object
  responses.UserListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.UserListItem'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.UserProfileResponse:
    description: 用户基本信息
    properties:
      created_at:
        example: "2024-01-01T00:00:00Z"
        type: string
      enterprise_info:
        $ref: '#/definitions/responses.EnterpriseInfoResponse'
      id:
        example: 123e4567-e89b-12d3-a456-426614174000
        type: string
      is_active:
        example: true
        type: boolean
      is_certified:
        example: false
        type: boolean
      last_login_at:
        example: "2024-01-01T00:00:00Z"
        type: string
      login_count:
        example: 10
        type: integer
      permissions:
        example:
        - '[''user:read'''
        - '''user:write'']'
        items:
          type: string
        type: array
      phone:
        example: "13800138000"
        type: string
      updated_at:
        example: "2024-01-01T00:00:00Z"
        type: string
      user_type:
        example: user
        type: string
      username:
        example: admin
        type: string
    type: object
  responses.UserStatsResponse:
    properties:
      active_users:
        type: integer
      certified_users:
        type: integer
      total_users:
        type: integer
    type: object
  responses.WalletResponse:
    properties:
      balance:
        type: number
      balance_status:
        description: normal, low, arrears
        type: string
      created_at:
        type: string
      id:
        type: string
      is_active:
        type: boolean
      is_arrears:
        description: 是否欠费
        type: boolean
      is_low_balance:
        description: 是否余额较低
        type: boolean
      updated_at:
        type: string
      user_id:
        type: string
    type: object
  responses.WalletTransactionListResponse:
    properties:
      items:
        items:
          $ref: '#/definitions/responses.WalletTransactionResponse'
        type: array
      page:
        type: integer
      size:
        type: integer
      total:
        type: integer
    type: object
  responses.WalletTransactionResponse:
    properties:
      amount:
        type: number
      api_call_id:
        type: string
      company_name:
        type: string
      created_at:
        type: string
      id:
        type: string
      product_id:
        type: string
      product_name:
        type: string
      transaction_id:
        type: string
      updated_at:
        type: string
      user:
        $ref: '#/definitions/tyapi-server_internal_application_finance_dto_responses.UserSimpleResponse'
      user_id:
        type: string
    type: object
  tyapi-server_internal_application_article_dto_responses.CategoryInfoResponse:
    properties:
      created_at:
        type: string
      description:
        type: string
      id:
        type: string
      is_active:
        type: boolean
      name:
        type: string
      sort_order:
        type: integer
    type: object
  tyapi-server_internal_application_finance_dto_responses.UserSimpleResponse:
    properties:
      company_name:
        type: string
      id:
        type: string
      phone:
        type: string
    type: object
  tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse:
    properties:
      code:
        type: string
      created_at:
        type: string
      description:
        type: string
      id:
        type: string
      is_enabled:
        type: boolean
      is_visible:
        type: boolean
      name:
        type: string
      sort:
        type: integer
      updated_at:
        type: string
    type: object
  tyapi-server_internal_application_product_dto_responses.UserSimpleResponse:
    properties:
      company_name:
        type: string
      id:
        type: string
      phone:
        type: string
    type: object
  value_objects.ContractInfo:
    properties:
      contract_file_id:
        description: 合同基本信息
        type: string
      contract_sign_url:
        description: 合同签署链接
        type: string
      contract_title:
        description: 合同元数据
        type: string
      contract_url:
        description: 合同文件访问链接
        type: string
      contract_version:
        description: 合同版本
        type: string
      esign_flow_id:
        description: e签宝签署流程ID
        type: string
      expires_at:
        description: 签署链接过期时间
        type: string
      generated_at:
        description: 时间信息
        type: string
      metadata:
        additionalProperties: true
        description: 附加信息
        type: object
      sign_flow_created_at:
        description: 签署流程创建时间
        type: string
      sign_progress:
        description: 签署进度
        type: integer
      signed_at:
        description: 签署完成时间
        type: string
      signer_account:
        description: 签署相关信息
        type: string
      signer_name:
        description: 签署人姓名
        type: string
      status:
        description: 状态信息
        type: string
      template_id:
        description: 模板ID
        type: string
      transactor_id_card_num:
        description: 经办人身份证号
        type: string
      transactor_name:
        description: 经办人姓名
        type: string
      transactor_phone:
        description: 经办人手机号
        type: string
    type: object
  value_objects.EnterpriseInfo:
    properties:
      company_name:
        description: 企业基本信息
        type: string
      enterprise_address:
        description: 企业地址（新增）
        type: string
      legal_person_id:
        description: 法定代表人身份证号
        type: string
      legal_person_name:
        description: 法定代表人信息
        type: string
      legal_person_phone:
        description: 法定代表人手机号
        type: string
      registered_address:
        description: 企业详细信息
        type: string
      unified_social_code:
        description: 统一社会信用代码
        type: string
    type: object
  value_objects.InvoiceInfo:
    properties:
      bank_account:
        description: 基本开户账号
        type: string
      bank_name:
        description: 基本开户银行
        type: string
      company_address:
        description: 企业注册地址
        type: string
      company_name:
        description: 公司名称
        type: string
      company_phone:
        description: 企业注册电话
        type: string
      receiving_email:
        description: 发票接收邮箱
        type: string
      taxpayer_id:
        description: 纳税人识别号
        type: string
    type: object
  value_objects.InvoiceType:
    enum:
    - general
    - special
    type: string
    x-enum-comments:
      InvoiceTypeGeneral: 增值税普通发票 (普票)
      InvoiceTypeSpecial: 增值税专用发票 (专票)
    x-enum-descriptions:
    - 增值税普通发票 (普票)
    - 增值税专用发票 (专票)
    x-enum-varnames:
    - InvoiceTypeGeneral
    - InvoiceTypeSpecial
host: localhost:8080
info:
  contact:
    email: support@example.com
    name: API Support
    url: https://github.com/your-org/tyapi-server-gin
  description: |-
    基于DDD和Clean Architecture的企业级后端API服务
    采用Gin框架构建，支持用户管理、JWT认证、事件驱动等功能
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  title: TYAPI Server API
  version: "1.0"
paths:
  /api/v1/:api_name:
    post:
      consumes:
      - application/json
      description: 统一API调用入口，参数加密传输
      parameters:
      - description: API调用请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.ApiCallCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 调用成功
          schema:
            $ref: '#/definitions/dto.ApiCallResponse'
        "400":
          description: 请求参数错误
          schema:
            $ref: '#/definitions/dto.ApiCallResponse'
        "401":
          description: 未授权
          schema:
            $ref: '#/definitions/dto.ApiCallResponse'
        "429":
          description: 请求过于频繁
          schema:
            $ref: '#/definitions/dto.ApiCallResponse'
        "500":
          description: 服务器内部错误
          schema:
            $ref: '#/definitions/dto.ApiCallResponse'
      summary: API调用
      tags:
      - API调用
  /api/v1/admin/api-calls:
    get:
      consumes:
      - application/json
      description: 管理员获取API调用记录，支持筛选和分页
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 用户ID
        in: query
        name: user_id
        type: string
      - description: 交易ID
        in: query
        name: transaction_id
        type: string
      - description: 产品名称
        in: query
        name: product_name
        type: string
      - description: 状态
        in: query
        name: status
        type: string
      - description: 开始时间
        format: date-time
        in: query
        name: start_time
        type: string
      - description: 结束时间
        format: date-time
        in: query
        name: end_time
        type: string
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取API调用记录成功
          schema:
            $ref: '#/definitions/dto.ApiCallListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取管理端API调用记录
      tags:
      - API管理
  /api/v1/admin/invoices/{application_id}/approve:
    post:
      consumes:
      - multipart/form-data
      description: 管理员通过发票申请并上传发票文件
      parameters:
      - description: 申请ID
        in: path
        name: application_id
        required: true
        type: string
      - description: 发票文件
        in: formData
        name: file
        required: true
        type: file
      - description: 管理员备注
        in: formData
        name: admin_notes
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 通过发票申请
      tags:
      - 管理员-发票管理
  /api/v1/admin/invoices/{application_id}/download:
    get:
      description: 管理员下载指定发票的文件
      parameters:
      - description: 申请ID
        in: path
        name: application_id
        required: true
        type: string
      produces:
      - application/octet-stream
      responses:
        "200":
          description: OK
          schema:
            type: file
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 管理员下载发票文件
      tags:
      - 管理员-发票管理
  /api/v1/admin/invoices/{application_id}/reject:
    post:
      consumes:
      - application/json
      description: 管理员拒绝发票申请
      parameters:
      - description: 申请ID
        in: path
        name: application_id
        required: true
        type: string
      - description: 拒绝申请请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/finance.RejectInvoiceRequest'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 拒绝发票申请
      tags:
      - 管理员-发票管理
  /api/v1/admin/invoices/pending:
    get:
      description: 管理员获取发票申请列表，支持状态和时间范围筛选
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 状态筛选：pending/completed/rejected
        in: query
        name: status
        type: string
      - description: '开始时间 (格式: 2006-01-02 15:04:05)'
        in: query
        name: start_time
        type: string
      - description: '结束时间 (格式: 2006-01-02 15:04:05)'
        in: query
        name: end_time
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/interfaces.APIResponse'
            - properties:
                data:
                  $ref: '#/definitions/dto.PendingApplicationsResponse'
              type: object
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 获取发票申请列表
      tags:
      - 管理员-发票管理
  /api/v1/admin/product-categories:
    get:
      consumes:
      - application/json
      description: 管理员获取产品分类列表
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: 获取分类列表成功
          schema:
            $ref: '#/definitions/responses.CategoryListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取分类列表
      tags:
      - 分类管理
    post:
      consumes:
      - application/json
      description: 管理员创建新产品分类
      parameters:
      - description: 创建分类请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.CreateCategoryCommand'
      produces:
      - application/json
      responses:
        "201":
          description: 分类创建成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 创建分类
      tags:
      - 分类管理
  /api/v1/admin/product-categories/{id}:
    delete:
      consumes:
      - application/json
      description: 管理员删除产品分类
      parameters:
      - description: 分类ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 分类删除成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 分类不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 删除分类
      tags:
      - 分类管理
    get:
      consumes:
      - application/json
      description: 管理员获取分类详细信息
      parameters:
      - description: 分类ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取分类详情成功
          schema:
            $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 分类不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取分类详情
      tags:
      - 分类管理
    put:
      consumes:
      - application/json
      description: 管理员更新产品分类信息
      parameters:
      - description: 分类ID
        in: path
        name: id
        required: true
        type: string
      - description: 更新分类请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.UpdateCategoryCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 分类更新成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 分类不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 更新分类
      tags:
      - 分类管理
  /api/v1/admin/products:
    get:
      consumes:
      - application/json
      description: 管理员获取产品列表，支持筛选和分页，包含所有产品（包括隐藏的）
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 搜索关键词
        in: query
        name: keyword
        type: string
      - description: 分类ID
        in: query
        name: category_id
        type: string
      - description: 是否启用
        in: query
        name: is_enabled
        type: boolean
      - description: 是否可见
        in: query
        name: is_visible
        type: boolean
      - description: 是否组合包
        in: query
        name: is_package
        type: boolean
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取产品列表成功
          schema:
            $ref: '#/definitions/responses.ProductAdminListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取产品列表
      tags:
      - 产品管理
    post:
      consumes:
      - application/json
      description: 管理员创建新产品
      parameters:
      - description: 创建产品请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.CreateProductCommand'
      produces:
      - application/json
      responses:
        "201":
          description: 产品创建成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 创建产品
      tags:
      - 产品管理
  /api/v1/admin/products/{id}:
    delete:
      consumes:
      - application/json
      description: 管理员删除产品
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 产品删除成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 删除产品
      tags:
      - 产品管理
    get:
      consumes:
      - application/json
      description: 管理员获取产品详细信息
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      - description: 是否包含文档信息
        in: query
        name: with_document
        type: boolean
      produces:
      - application/json
      responses:
        "200":
          description: 获取产品详情成功
          schema:
            $ref: '#/definitions/responses.ProductAdminInfoResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取产品详情
      tags:
      - 产品管理
    put:
      consumes:
      - application/json
      description: 管理员更新产品信息
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      - description: 更新产品请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.UpdateProductCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 产品更新成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 更新产品
      tags:
      - 产品管理
  /api/v1/admin/products/{id}/api-config:
    delete:
      consumes:
      - application/json
      description: 管理员删除产品的API配置
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: API配置删除成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品或API配置不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 删除产品API配置
      tags:
      - 产品管理
    get:
      consumes:
      - application/json
      description: 管理员获取产品的API配置信息，如果不存在则返回空配置
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取API配置成功
          schema:
            $ref: '#/definitions/responses.ProductApiConfigResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取产品API配置
      tags:
      - 产品管理
    post:
      consumes:
      - application/json
      description: 管理员为产品创建API配置
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      - description: API配置信息
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/responses.ProductApiConfigResponse'
      produces:
      - application/json
      responses:
        "201":
          description: API配置创建成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "409":
          description: API配置已存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 创建产品API配置
      tags:
      - 产品管理
    put:
      consumes:
      - application/json
      description: 管理员更新产品的API配置
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      - description: API配置信息
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/responses.ProductApiConfigResponse'
      produces:
      - application/json
      responses:
        "200":
          description: API配置更新成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品或配置不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 更新产品API配置
      tags:
      - 产品管理
  /api/v1/admin/products/{id}/documentation:
    delete:
      consumes:
      - application/json
      description: 管理员删除产品的文档
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 文档删除成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品或文档不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 删除产品文档
      tags:
      - 产品管理
    get:
      consumes:
      - application/json
      description: 管理员获取产品的文档信息
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取文档成功
          schema:
            $ref: '#/definitions/responses.DocumentationResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品或文档不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取产品文档
      tags:
      - 产品管理
    post:
      consumes:
      - application/json
      description: 管理员创建或更新产品的文档信息，如果文档不存在则创建，存在则更新
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      - description: 文档信息
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.CreateDocumentationCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 文档操作成功
          schema:
            $ref: '#/definitions/responses.DocumentationResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 创建或更新产品文档
      tags:
      - 产品管理
  /api/v1/admin/products/{id}/package-items:
    post:
      consumes:
      - application/json
      description: 管理员向组合包添加子产品
      parameters:
      - description: 组合包ID
        in: path
        name: id
        required: true
        type: string
      - description: 添加子产品命令
        in: body
        name: command
        required: true
        schema:
          $ref: '#/definitions/commands.AddPackageItemCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 添加成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 添加组合包子产品
      tags:
      - 产品管理
  /api/v1/admin/products/{id}/package-items/{item_id}:
    delete:
      consumes:
      - application/json
      description: 管理员从组合包移除子产品
      parameters:
      - description: 组合包ID
        in: path
        name: id
        required: true
        type: string
      - description: 子产品项目ID
        in: path
        name: item_id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 移除成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 移除组合包子产品
      tags:
      - 产品管理
    put:
      consumes:
      - application/json
      description: 管理员更新组合包子产品信息
      parameters:
      - description: 组合包ID
        in: path
        name: id
        required: true
        type: string
      - description: 子产品项目ID
        in: path
        name: item_id
        required: true
        type: string
      - description: 更新子产品命令
        in: body
        name: command
        required: true
        schema:
          $ref: '#/definitions/commands.UpdatePackageItemCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 更新成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 更新组合包子产品
      tags:
      - 产品管理
  /api/v1/admin/products/{id}/package-items/batch:
    put:
      consumes:
      - application/json
      description: 管理员批量更新组合包子产品配置
      parameters:
      - description: 组合包ID
        in: path
        name: id
        required: true
        type: string
      - description: 批量更新命令
        in: body
        name: command
        required: true
        schema:
          $ref: '#/definitions/commands.UpdatePackageItemsCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 更新成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 批量更新组合包子产品
      tags:
      - 产品管理
  /api/v1/admin/products/{id}/package-items/reorder:
    put:
      consumes:
      - application/json
      description: 管理员重新排序组合包子产品
      parameters:
      - description: 组合包ID
        in: path
        name: id
        required: true
        type: string
      - description: 重新排序命令
        in: body
        name: command
        required: true
        schema:
          $ref: '#/definitions/commands.ReorderPackageItemsCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 排序成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 重新排序组合包子产品
      tags:
      - 产品管理
  /api/v1/admin/products/available:
    get:
      consumes:
      - application/json
      description: 管理员获取可选作组合包子产品的产品列表
      parameters:
      - description: 排除的组合包ID
        in: query
        name: exclude_package_id
        type: string
      - description: 搜索关键词
        in: query
        name: keyword
        type: string
      - description: 分类ID
        in: query
        name: category_id
        type: string
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 20
        description: 每页数量
        in: query
        name: page_size
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: 获取可选产品列表成功
          schema:
            $ref: '#/definitions/responses.ProductListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取可选子产品列表
      tags:
      - 产品管理
  /api/v1/admin/recharge-records:
    get:
      consumes:
      - application/json
      description: 管理员获取充值记录，支持筛选和分页
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 用户ID
        in: query
        name: user_id
        type: string
      - description: 充值类型
        enum:
        - alipay
        - transfer
        - gift
        in: query
        name: recharge_type
        type: string
      - description: 状态
        enum:
        - pending
        - success
        - failed
        in: query
        name: status
        type: string
      - description: 最小金额
        in: query
        name: min_amount
        type: string
      - description: 最大金额
        in: query
        name: max_amount
        type: string
      - description: 开始时间
        format: date-time
        in: query
        name: start_time
        type: string
      - description: 结束时间
        format: date-time
        in: query
        name: end_time
        type: string
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取充值记录成功
          schema:
            $ref: '#/definitions/responses.RechargeRecordListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取管理端充值记录
      tags:
      - 财务管理
  /api/v1/admin/subscriptions:
    get:
      consumes:
      - application/json
      description: 管理员获取订阅列表
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 搜索关键词
        in: query
        name: keyword
        type: string
      - description: 企业名称
        in: query
        name: company_name
        type: string
      - description: 产品名称
        in: query
        name: product_name
        type: string
      - description: 订阅开始时间
        format: date-time
        in: query
        name: start_time
        type: string
      - description: 订阅结束时间
        format: date-time
        in: query
        name: end_time
        type: string
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取订阅列表成功
          schema:
            $ref: '#/definitions/responses.SubscriptionListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取订阅列表
      tags:
      - 订阅管理
  /api/v1/admin/subscriptions/{id}/price:
    put:
      consumes:
      - application/json
      description: 管理员修改用户订阅价格
      parameters:
      - description: 订阅ID
        in: path
        name: id
        required: true
        type: string
      - description: 更新订阅价格请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.UpdateSubscriptionPriceCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 订阅价格更新成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 订阅不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 更新订阅价格
      tags:
      - 订阅管理
  /api/v1/admin/subscriptions/batch-update-prices:
    post:
      consumes:
      - application/json
      description: 管理员一键调整用户所有订阅的价格
      parameters:
      - description: 批量改价请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.BatchUpdateSubscriptionPricesCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 一键改价成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 一键改价
      tags:
      - 订阅管理
  /api/v1/admin/subscriptions/stats:
    get:
      consumes:
      - application/json
      description: 管理员获取订阅统计信息
      produces:
      - application/json
      responses:
        "200":
          description: 获取订阅统计成功
          schema:
            $ref: '#/definitions/responses.SubscriptionStatsResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取订阅统计
      tags:
      - 订阅管理
  /api/v1/admin/wallet-transactions:
    get:
      consumes:
      - application/json
      description: 管理员获取消费记录，支持筛选和分页
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 用户ID
        in: query
        name: user_id
        type: string
      - description: 交易ID
        in: query
        name: transaction_id
        type: string
      - description: 产品名称
        in: query
        name: product_name
        type: string
      - description: 最小金额
        in: query
        name: min_amount
        type: string
      - description: 最大金额
        in: query
        name: max_amount
        type: string
      - description: 开始时间
        format: date-time
        in: query
        name: start_time
        type: string
      - description: 结束时间
        format: date-time
        in: query
        name: end_time
        type: string
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取消费记录成功
          schema:
            $ref: '#/definitions/responses.WalletTransactionListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取管理端消费记录
      tags:
      - 财务管理
  /api/v1/articles:
    get:
      consumes:
      - application/json
      description: 分页获取文章列表
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 文章状态
        in: query
        name: status
        type: string
      - description: 分类ID
        in: query
        name: category_id
        type: string
      - description: 作者ID
        in: query
        name: author_id
        type: string
      - description: 是否推荐
        in: query
        name: is_featured
        type: boolean
      - description: 排序字段
        in: query
        name: order_by
        type: string
      - description: 排序方向
        in: query
        name: order_dir
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取文章列表成功
          schema:
            $ref: '#/definitions/responses.ArticleListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取文章列表
      tags:
      - 文章管理
    post:
      consumes:
      - application/json
      description: 创建新的文章
      parameters:
      - description: 创建文章请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.CreateArticleCommand'
      produces:
      - application/json
      responses:
        "201":
          description: 文章创建成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 创建文章
      tags:
      - 文章管理
  /api/v1/articles/{id}:
    delete:
      consumes:
      - application/json
      description: 删除指定文章
      parameters:
      - description: 文章ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 文章删除成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 文章不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 删除文章
      tags:
      - 文章管理
    get:
      consumes:
      - application/json
      description: 根据ID获取文章详情
      parameters:
      - description: 文章ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取文章详情成功
          schema:
            $ref: '#/definitions/responses.ArticleInfoResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 文章不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取文章详情
      tags:
      - 文章管理
    put:
      consumes:
      - application/json
      description: 更新文章信息
      parameters:
      - description: 文章ID
        in: path
        name: id
        required: true
        type: string
      - description: 更新文章请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.UpdateArticleCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 文章更新成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 文章不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 更新文章
      tags:
      - 文章管理
  /api/v1/articles/{id}/archive:
    post:
      consumes:
      - application/json
      description: 将已发布文章归档
      parameters:
      - description: 文章ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 文章归档成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 文章不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 归档文章
      tags:
      - 文章管理
  /api/v1/articles/{id}/featured:
    put:
      consumes:
      - application/json
      description: 设置文章的推荐状态
      parameters:
      - description: 文章ID
        in: path
        name: id
        required: true
        type: string
      - description: 设置推荐状态请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.SetFeaturedCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 设置推荐状态成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 文章不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 设置推荐状态
      tags:
      - 文章管理
  /api/v1/articles/{id}/publish:
    post:
      consumes:
      - application/json
      description: 将草稿文章发布
      parameters:
      - description: 文章ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 文章发布成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 文章不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 发布文章
      tags:
      - 文章管理
  /api/v1/articles/search:
    get:
      consumes:
      - application/json
      description: 根据关键词搜索文章
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 搜索关键词
        in: query
        name: keyword
        required: true
        type: string
      - description: 分类ID
        in: query
        name: category_id
        type: string
      - description: 作者ID
        in: query
        name: author_id
        type: string
      - description: 文章状态
        in: query
        name: status
        type: string
      - description: 排序字段
        in: query
        name: order_by
        type: string
      - description: 排序方向
        in: query
        name: order_dir
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 搜索文章成功
          schema:
            $ref: '#/definitions/responses.ArticleListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 搜索文章
      tags:
      - 文章管理
  /api/v1/articles/stats:
    get:
      consumes:
      - application/json
      description: 获取文章相关统计数据
      produces:
      - application/json
      responses:
        "200":
          description: 获取统计成功
          schema:
            $ref: '#/definitions/responses.ArticleStatsResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取文章统计
      tags:
      - 文章管理
  /api/v1/categories:
    get:
      consumes:
      - application/json
      description: 获取产品分类列表，支持筛选
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 是否启用
        in: query
        name: is_enabled
        type: boolean
      - description: 是否可见
        in: query
        name: is_visible
        type: boolean
      produces:
      - application/json
      responses:
        "200":
          description: 获取分类列表成功
          schema:
            $ref: '#/definitions/responses.CategoryListResponse'
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 获取分类列表
      tags:
      - 数据大厅
  /api/v1/categories/{id}:
    get:
      consumes:
      - application/json
      description: 根据分类ID获取分类详细信息
      parameters:
      - description: 分类ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取分类详情成功
          schema:
            $ref: '#/definitions/tyapi-server_internal_application_product_dto_responses.CategoryInfoResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 分类不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 获取分类详情
      tags:
      - 数据大厅
  /api/v1/certifications:
    get:
      consumes:
      - application/json
      description: 管理员获取认证申请列表
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      - description: 认证状态
        in: query
        name: status
        type: string
      - description: 用户ID
        in: query
        name: user_id
        type: string
      - description: 公司名称
        in: query
        name: company_name
        type: string
      - description: 法人姓名
        in: query
        name: legal_person_name
        type: string
      - description: 搜索关键词
        in: query
        name: search_keyword
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取认证列表成功
          schema:
            $ref: '#/definitions/responses.CertificationListResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "403":
          description: 权限不足
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取认证列表
      tags:
      - 认证管理
  /api/v1/certifications/apply-contract:
    post:
      consumes:
      - application/json
      description: 申请企业认证合同签署
      parameters:
      - description: 申请合同请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.ApplyContractCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 合同申请成功
          schema:
            $ref: '#/definitions/responses.ContractSignUrlResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 认证记录不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 申请合同签署
      tags:
      - 认证管理
  /api/v1/certifications/confirm-auth:
    post:
      consumes:
      - application/json
      description: 前端轮询确认企业认证是否完成
      parameters:
      - description: 确认状态请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/queries.ConfirmAuthCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 状态确认成功
          schema:
            $ref: '#/definitions/responses.ConfirmAuthResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 认证记录不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 前端确认认证状态
      tags:
      - 认证管理
  /api/v1/certifications/confirm-sign:
    post:
      consumes:
      - application/json
      description: 前端轮询确认合同签署是否完成
      parameters:
      - description: 确认状态请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/queries.ConfirmSignCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 状态确认成功
          schema:
            $ref: '#/definitions/responses.ConfirmSignResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 认证记录不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 前端确认签署状态
      tags:
      - 认证管理
  /api/v1/certifications/details:
    get:
      consumes:
      - application/json
      description: 根据认证ID获取认证详情
      produces:
      - application/json
      responses:
        "200":
          description: 获取认证详情成功
          schema:
            $ref: '#/definitions/responses.CertificationResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 认证记录不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取认证详情
      tags:
      - 认证管理
  /api/v1/certifications/enterprise-info:
    post:
      consumes:
      - application/json
      description: 提交企业认证所需的企业信息
      parameters:
      - description: 提交企业信息请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.SubmitEnterpriseInfoCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 企业信息提交成功
          schema:
            $ref: '#/definitions/responses.CertificationResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 认证记录不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 提交企业信息
      tags:
      - 认证管理
  /api/v1/certifications/esign/callback:
    post:
      consumes:
      - application/json
      description: 处理e签宝的异步回调通知
      produces:
      - text/plain
      responses:
        "200":
          description: success
          schema:
            type: string
        "400":
          description: fail
          schema:
            type: string
      summary: 处理e签宝回调
      tags:
      - 认证管理
  /api/v1/debug/event-system:
    post:
      consumes:
      - application/json
      description: 调试事件系统，用于测试事件触发和处理
      produces:
      - application/json
      responses:
        "200":
          description: 调试成功
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 调试事件系统
      tags:
      - 系统调试
  /api/v1/decrypt:
    post:
      consumes:
      - application/json
      description: 使用密钥解密加密的数据
      parameters:
      - description: 解密请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.DecryptCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 解密成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未授权
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 解密失败
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 解密参数
      tags:
      - API调试
  /api/v1/encrypt:
    post:
      consumes:
      - application/json
      description: 用于前端调试时加密API调用参数
      parameters:
      - description: 加密请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.EncryptCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 加密成功
          schema:
            $ref: '#/definitions/dto.EncryptResponse'
        "400":
          description: 请求参数错误
          schema:
            $ref: '#/definitions/dto.EncryptResponse'
        "401":
          description: 未授权
          schema:
            $ref: '#/definitions/dto.EncryptResponse'
      summary: 加密参数
      tags:
      - API调试
  /api/v1/finance/alipay/callback:
    post:
      consumes:
      - application/x-www-form-urlencoded
      description: 处理支付宝异步支付通知
      produces:
      - text/plain
      responses:
        "200":
          description: success
          schema:
            type: string
        "400":
          description: fail
          schema:
            type: string
      summary: 支付宝支付回调
      tags:
      - 支付管理
  /api/v1/finance/alipay/return:
    get:
      consumes:
      - application/x-www-form-urlencoded
      description: 处理支付宝同步支付通知，跳转到前端成功页面
      produces:
      - text/html
      responses:
        "200":
          description: 支付成功页面
          schema:
            type: string
        "400":
          description: 支付失败页面
          schema:
            type: string
      summary: 支付宝同步回调
      tags:
      - 支付管理
  /api/v1/finance/wallet:
    get:
      consumes:
      - application/json
      description: 获取当前用户的钱包详细信息
      produces:
      - application/json
      responses:
        "200":
          description: 获取钱包信息成功
          schema:
            $ref: '#/definitions/responses.WalletResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 钱包不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取钱包信息
      tags:
      - 钱包管理
  /api/v1/finance/wallet/alipay-order-status:
    get:
      consumes:
      - application/json
      description: 获取支付宝订单的当前状态，用于轮询查询
      parameters:
      - description: 商户订单号
        in: query
        name: out_trade_no
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取订单状态成功
          schema:
            $ref: '#/definitions/responses.AlipayOrderStatusResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 订单不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取支付宝订单状态
      tags:
      - 钱包管理
  /api/v1/finance/wallet/alipay-recharge:
    post:
      consumes:
      - application/json
      description: 创建支付宝充值订单并返回支付链接
      parameters:
      - description: 充值请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.CreateAlipayRechargeCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 创建充值订单成功
          schema:
            $ref: '#/definitions/responses.AlipayRechargeOrderResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 创建支付宝充值订单
      tags:
      - 钱包管理
  /api/v1/finance/wallet/recharge-config:
    get:
      consumes:
      - application/json
      description: 获取当前环境的充值配置信息（最低充值金额、最高充值金额等）
      produces:
      - application/json
      responses:
        "200":
          description: 获取充值配置成功
          schema:
            $ref: '#/definitions/responses.RechargeConfigResponse'
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 获取充值配置
      tags:
      - 钱包管理
  /api/v1/finance/wallet/transactions:
    get:
      consumes:
      - application/json
      description: 获取当前用户的钱包交易记录列表，支持分页和筛选
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: '开始时间 (格式: 2006-01-02 15:04:05)'
        in: query
        name: start_time
        type: string
      - description: '结束时间 (格式: 2006-01-02 15:04:05)'
        in: query
        name: end_time
        type: string
      - description: 交易ID
        in: query
        name: transaction_id
        type: string
      - description: 产品名称
        in: query
        name: product_name
        type: string
      - description: 最小金额
        in: query
        name: min_amount
        type: string
      - description: 最大金额
        in: query
        name: max_amount
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取成功
          schema:
            $ref: '#/definitions/responses.WalletTransactionListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取用户钱包交易记录
      tags:
      - 钱包管理
  /api/v1/form-config/{api_code}:
    get:
      consumes:
      - application/json
      description: 获取指定API的表单配置，用于前端动态生成表单
      parameters:
      - description: API代码
        in: path
        name: api_code
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未授权
          schema:
            additionalProperties: true
            type: object
        "404":
          description: API接口不存在
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取表单配置
      tags:
      - API调试
  /api/v1/invoices/{application_id}/download:
    get:
      description: 下载指定发票的文件
      parameters:
      - description: 申请ID
        in: path
        name: application_id
        required: true
        type: string
      produces:
      - application/octet-stream
      responses:
        "200":
          description: OK
          schema:
            type: file
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 下载发票文件
      tags:
      - 发票管理
  /api/v1/invoices/apply:
    post:
      consumes:
      - application/json
      description: 用户申请开票
      parameters:
      - description: 申请开票请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/finance.ApplyInvoiceRequest'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/interfaces.APIResponse'
            - properties:
                data:
                  $ref: '#/definitions/dto.InvoiceApplicationResponse'
              type: object
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 申请开票
      tags:
      - 发票管理
  /api/v1/invoices/available-amount:
    get:
      description: 获取用户当前可开票的金额
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/interfaces.APIResponse'
            - properties:
                data:
                  $ref: '#/definitions/dto.AvailableAmountResponse'
              type: object
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 获取可开票金额
      tags:
      - 发票管理
  /api/v1/invoices/info:
    get:
      description: 获取用户的发票信息
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/interfaces.APIResponse'
            - properties:
                data:
                  $ref: '#/definitions/dto.InvoiceInfoResponse'
              type: object
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 获取用户发票信息
      tags:
      - 发票管理
    put:
      consumes:
      - application/json
      description: 更新用户的发票信息
      parameters:
      - description: 更新发票信息请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/finance.UpdateInvoiceInfoRequest'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 更新用户发票信息
      tags:
      - 发票管理
  /api/v1/invoices/records:
    get:
      description: 获取用户的开票记录列表
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 状态筛选
        in: query
        name: status
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/interfaces.APIResponse'
            - properties:
                data:
                  $ref: '#/definitions/dto.InvoiceRecordsResponse'
              type: object
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 获取用户开票记录
      tags:
      - 发票管理
  /api/v1/my/api-calls:
    get:
      consumes:
      - application/json
      description: 获取当前用户的API调用记录列表，支持分页和筛选
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: '开始时间 (格式: 2006-01-02 15:04:05)'
        in: query
        name: start_time
        type: string
      - description: '结束时间 (格式: 2006-01-02 15:04:05)'
        in: query
        name: end_time
        type: string
      - description: 交易ID
        in: query
        name: transaction_id
        type: string
      - description: 产品名称
        in: query
        name: product_name
        type: string
      - description: 状态 (pending/success/failed)
        in: query
        name: status
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取成功
          schema:
            $ref: '#/definitions/dto.ApiCallListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取用户API调用记录
      tags:
      - API管理
  /api/v1/my/subscriptions:
    get:
      consumes:
      - application/json
      description: 获取当前用户的订阅列表
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 搜索关键词
        in: query
        name: keyword
        type: string
      - description: 产品名称
        in: query
        name: product_name
        type: string
      - description: 订阅开始时间
        format: date-time
        in: query
        name: start_time
        type: string
      - description: 订阅结束时间
        format: date-time
        in: query
        name: end_time
        type: string
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取订阅列表成功
          schema:
            $ref: '#/definitions/responses.SubscriptionListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取我的订阅列表
      tags:
      - 我的订阅
  /api/v1/my/subscriptions/{id}:
    get:
      consumes:
      - application/json
      description: 获取指定订阅的详细信息
      parameters:
      - description: 订阅ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取订阅详情成功
          schema:
            $ref: '#/definitions/responses.SubscriptionInfoResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 订阅不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取我的订阅详情
      tags:
      - 我的订阅
  /api/v1/my/subscriptions/{id}/usage:
    get:
      consumes:
      - application/json
      description: 获取指定订阅的使用情况统计
      parameters:
      - description: 订阅ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取使用情况成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 订阅不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取我的订阅使用情况
      tags:
      - 我的订阅
  /api/v1/my/subscriptions/stats:
    get:
      consumes:
      - application/json
      description: 获取当前用户的订阅统计信息
      produces:
      - application/json
      responses:
        "200":
          description: 获取订阅统计成功
          schema:
            $ref: '#/definitions/responses.SubscriptionStatsResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取我的订阅统计
      tags:
      - 我的订阅
  /api/v1/my/whitelist/{ip}:
    delete:
      consumes:
      - application/json
      description: 从当前用户的白名单中删除指定IP地址
      parameters:
      - description: IP地址
        in: path
        name: ip
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 删除白名单IP成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 删除白名单IP
      tags:
      - API管理
  /api/v1/products:
    get:
      consumes:
      - application/json
      description: 分页获取可用的产品列表，支持筛选，默认只返回可见的产品
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 搜索关键词
        in: query
        name: keyword
        type: string
      - description: 分类ID
        in: query
        name: category_id
        type: string
      - description: 是否启用
        in: query
        name: is_enabled
        type: boolean
      - description: 是否可见
        in: query
        name: is_visible
        type: boolean
      - description: 是否组合包
        in: query
        name: is_package
        type: boolean
      - description: 是否已订阅（需要认证）
        in: query
        name: is_subscribed
        type: boolean
      - description: 排序字段
        in: query
        name: sort_by
        type: string
      - description: 排序方向
        enum:
        - asc
        - desc
        in: query
        name: sort_order
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取产品列表成功
          schema:
            $ref: '#/definitions/responses.ProductListResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 获取产品列表
      tags:
      - 数据大厅
  /api/v1/products/{id}:
    get:
      consumes:
      - application/json
      description: 获取产品详细信息，用户端只能查看可见的产品
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      - description: 是否包含文档信息
        in: query
        name: with_document
        type: boolean
      produces:
      - application/json
      responses:
        "200":
          description: 获取产品详情成功
          schema:
            $ref: '#/definitions/responses.ProductInfoWithDocumentResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在或不可见
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 获取产品详情
      tags:
      - 数据大厅
  /api/v1/products/{id}/api-config:
    get:
      consumes:
      - application/json
      description: 根据产品ID获取API配置信息
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取成功
          schema:
            $ref: '#/definitions/responses.ProductApiConfigResponse'
        "400":
          description: 请求参数错误
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "404":
          description: 配置不存在
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 获取产品API配置
      tags:
      - 产品API配置
  /api/v1/products/{id}/documentation:
    get:
      consumes:
      - application/json
      description: 获取指定产品的文档信息
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取产品文档成功
          schema:
            $ref: '#/definitions/responses.DocumentationResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 获取产品文档
      tags:
      - 数据大厅
  /api/v1/products/{id}/subscribe:
    post:
      consumes:
      - application/json
      description: 用户订阅指定产品
      parameters:
      - description: 产品ID
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 订阅成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 产品不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 订阅产品
      tags:
      - 数据大厅
  /api/v1/products/code/{product_code}/api-config:
    get:
      consumes:
      - application/json
      description: 根据产品代码获取API配置信息
      parameters:
      - description: 产品代码
        in: path
        name: product_code
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 获取成功
          schema:
            $ref: '#/definitions/responses.ProductApiConfigResponse'
        "400":
          description: 请求参数错误
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
        "404":
          description: 配置不存在
          schema:
            $ref: '#/definitions/interfaces.APIResponse'
      summary: 根据产品代码获取API配置
      tags:
      - 产品API配置
  /api/v1/products/stats:
    get:
      consumes:
      - application/json
      description: 获取产品相关的统计信息
      produces:
      - application/json
      responses:
        "200":
          description: 获取统计信息成功
          schema:
            $ref: '#/definitions/responses.ProductStatsResponse'
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 获取产品统计
      tags:
      - 数据大厅
  /api/v1/users/admin/{user_id}:
    get:
      consumes:
      - application/json
      description: 管理员获取指定用户的详细信息
      parameters:
      - description: 用户ID
        in: path
        name: user_id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 用户详情
          schema:
            $ref: '#/definitions/responses.UserDetailResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "403":
          description: 权限不足
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 用户不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 管理员获取用户详情
      tags:
      - 用户管理
  /api/v1/users/admin/list:
    get:
      consumes:
      - application/json
      description: 管理员查看用户列表，支持分页和筛选
      parameters:
      - default: 1
        description: 页码
        in: query
        name: page
        type: integer
      - default: 10
        description: 每页数量
        in: query
        name: page_size
        type: integer
      - description: 手机号筛选
        in: query
        name: phone
        type: string
      - description: 用户类型筛选
        enum:
        - user
        - admin
        in: query
        name: user_type
        type: string
      - description: 是否激活筛选
        in: query
        name: is_active
        type: boolean
      - description: 是否已认证筛选
        in: query
        name: is_certified
        type: boolean
      - description: 企业名称筛选
        in: query
        name: company_name
        type: string
      - description: 开始日期
        format: date
        in: query
        name: start_date
        type: string
      - description: 结束日期
        format: date
        in: query
        name: end_date
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 用户列表
          schema:
            $ref: '#/definitions/responses.UserListResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "403":
          description: 权限不足
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 管理员查看用户列表
      tags:
      - 用户管理
  /api/v1/users/admin/stats:
    get:
      consumes:
      - application/json
      description: 管理员获取用户相关的统计信息
      produces:
      - application/json
      responses:
        "200":
          description: 用户统计信息
          schema:
            $ref: '#/definitions/responses.UserStatsResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "403":
          description: 权限不足
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取用户统计信息
      tags:
      - 用户管理
  /api/v1/users/login-password:
    post:
      consumes:
      - application/json
      description: 使用手机号和密码进行用户登录，返回JWT令牌
      parameters:
      - description: 密码登录请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.LoginWithPasswordCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 登录成功
          schema:
            $ref: '#/definitions/responses.LoginUserResponse'
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 用户名或密码错误
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 用户密码登录
      tags:
      - 用户认证
  /api/v1/users/login-sms:
    post:
      consumes:
      - application/json
      description: 使用手机号和短信验证码进行用户登录，返回JWT令牌
      parameters:
      - description: 短信登录请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.LoginWithSMSCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 登录成功
          schema:
            $ref: '#/definitions/responses.LoginUserResponse'
        "400":
          description: 请求参数错误或验证码无效
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 认证失败
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 用户短信验证码登录
      tags:
      - 用户认证
  /api/v1/users/me:
    get:
      consumes:
      - application/json
      description: 根据JWT令牌获取当前登录用户的详细信息
      produces:
      - application/json
      responses:
        "200":
          description: 用户信息
          schema:
            $ref: '#/definitions/responses.UserProfileResponse'
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 用户不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 获取当前用户信息
      tags:
      - 用户管理
  /api/v1/users/me/password:
    put:
      consumes:
      - application/json
      description: 使用旧密码、新密码确认和验证码修改当前用户的密码
      parameters:
      - description: 修改密码请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.ChangePasswordCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 密码修改成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误或验证码无效
          schema:
            additionalProperties: true
            type: object
        "401":
          description: 未认证
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      security:
      - Bearer: []
      summary: 修改密码
      tags:
      - 用户管理
  /api/v1/users/register:
    post:
      consumes:
      - application/json
      description: 使用手机号、密码和验证码进行用户注册，需要确认密码
      parameters:
      - description: 用户注册请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.RegisterUserCommand'
      produces:
      - application/json
      responses:
        "201":
          description: 注册成功
          schema:
            $ref: '#/definitions/responses.RegisterUserResponse'
        "400":
          description: 请求参数错误或验证码无效
          schema:
            additionalProperties: true
            type: object
        "409":
          description: 手机号已存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 用户注册
      tags:
      - 用户认证
  /api/v1/users/reset-password:
    post:
      consumes:
      - application/json
      description: 使用手机号、验证码和新密码重置用户密码（忘记密码时使用）
      parameters:
      - description: 重置密码请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.ResetPasswordCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 密码重置成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误或验证码无效
          schema:
            additionalProperties: true
            type: object
        "404":
          description: 用户不存在
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 重置密码
      tags:
      - 用户认证
  /api/v1/users/send-code:
    post:
      consumes:
      - application/json
      description: 向指定手机号发送验证码，支持注册、登录、修改密码等场景
      parameters:
      - description: 发送验证码请求
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/commands.SendCodeCommand'
      produces:
      - application/json
      responses:
        "200":
          description: 验证码发送成功
          schema:
            additionalProperties: true
            type: object
        "400":
          description: 请求参数错误
          schema:
            additionalProperties: true
            type: object
        "429":
          description: 请求频率限制
          schema:
            additionalProperties: true
            type: object
        "500":
          description: 服务器内部错误
          schema:
            additionalProperties: true
            type: object
      summary: 发送短信验证码
      tags:
      - 用户认证
securityDefinitions:
  Bearer:
    description: Type "Bearer" followed by a space and JWT token.
    in: header
    name: Authorization
    type: apiKey
swagger: "2.0"