/**
 * 统计相关类型定义
 */
declare namespace Api.Statistics {
  /**
   * 订阅概览统计
   */
  interface SubscriptionOverview {
    /** 总订阅数 */
    totalSubscriptions: number
    /** 活跃订阅数 */
    activeSubscriptions: number
    /** 7天内到期 */
    expiringIn7Days: number
    /** 3天内到期 */
    expiringIn3Days: number
    /** 明天到期 */
    expiringIn1Day: number
    /** 已过期 */
    expiredSubscriptions: number
    /** 待激活 */
    pendingSubscriptions: number
    /** 已暂停 */
    suspendedSubscriptions: number
  }

  /**
   * 配额使用排行项
   */
  interface QuotaUsageRankingItem {
    /** 租户ID */
    tenantId: string
    /** 租户名称 */
    tenantName: string
    /** 配额类型 */
    quotaType: number
    /** 配额名称 */
    quotaName: string
    /** 当前使用量 */
    currentUsage: number
    /** 配额上限 */
    quotaLimit: number
    /** 使用率（百分比） */
    usagePercentage: number
  }

  /**
   * 配额使用排行请求参数
   */
  interface QuotaUsageRankingParams {
    /** 配额类型（可选） */
    quotaType?: number
    /** 返回数量限制 */
    limit?: number
  }

  /**
   * 配额使用排行响应
   */
  interface QuotaUsageRankingResponse {
    /** 排行列表 */
    items: QuotaUsageRankingItem[]
  }

  /**
   * 月度收入统计项
   */
  interface MonthlyRevenueItem {
    /** 年份 */
    year: number
    /** 月份 */
    month: number
    /** 月度收入 */
    revenue: number
  }

  /**
   * 收入统计请求参数
   */
  interface RevenueStatisticsParams {
    /** 年份（可选，默认当前年） */
    year?: number
  }

  /**
   * 收入统计响应
   */
  interface RevenueStatisticsResponse {
    /** 总收入 */
    totalRevenue: number
    /** 本月收入 */
    currentMonthRevenue: number
    /** 本季度收入 */
    currentQuarterRevenue: number
    /** 月度收入列表（最近6个月） */
    monthlyRevenues: MonthlyRevenueItem[]
  }

  /**
   * 即将到期订阅项
   */
  interface ExpiringSubscriptionItem {
    /** 订阅ID */
    subscriptionId: string
    /** 租户ID */
    tenantId: string
    /** 租户名称 */
    tenantName: string
    /** 套餐名称 */
    packageName: string
    /** 到期日期 */
    expireDate: string
    /** 距离到期天数 */
    daysUntilExpiry: number
    /** 订阅状态 */
    status: number
  }

  /**
   * 即将到期订阅请求参数
   */
  interface ExpiringSubscriptionsParams {
    /** 天数范围（默认7天） */
    days?: number
    /** 页码 */
    page?: number
    /** 每页数量 */
    pageSize?: number
  }

  /**
   * 即将到期订阅响应
   */
  interface ExpiringSubscriptionsResponse {
    /** 订阅列表 */
    items: ExpiringSubscriptionItem[]
    /** 总数 */
    totalCount: number
    /** 当前页 */
    page: number
    /** 每页数量 */
    pageSize: number
  }
}
