201

apis/admin/user.api

@@ -43,7 +43,7 @@ type (
 		GiftAmount         int64  `json:"gift_amount"`
 		Telegram           int64  `json:"telegram"`
 		ReferCode          string `json:"refer_code"`
-		RefererId          *int64  `json:"referer_id"`
+		RefererId          *int64 `json:"referer_id"`
 		Enable             bool   `json:"enable"`
 		IsAdmin            bool   `json:"is_admin"`
 		MemberStatus       string `json:"member_status"`
@@ -295,3 +295,4 @@ service ppanel {
 	@handler GetUserLoginLogs
 	get /login/logs (GetUserLoginLogsRequest) returns (GetUserLoginLogsResponse)
 }
+

apis/public/user.api

@@ -118,6 +118,51 @@ type (
 		DeviceStatus  bool `json:"device_status"`
 		EmailStatus   bool `json:"email_status"`
 	}
+	// GetAgentRealtimeRequest - 获取代理链接实时数据
+	GetAgentRealtimeRequest {}
+	// GetAgentRealtimeResponse - 代理链接实时数据响应
+	GetAgentRealtimeResponse {
+		Total     int64 `json:"total"`      // 访问总人数
+		Clicks    int64 `json:"clicks"`     // 点击量
+		Views     int64 `json:"views"`      // 浏览量
+		PaidCount int64 `json:"paid_count"` // 付费数量
+	}
+	// GetUserInviteStatsRequest - 获取用户邀请统计
+	GetUserInviteStatsRequest {}
+	// GetUserInviteStatsResponse - 用户邀请统计响应
+	GetUserInviteStatsResponse {
+		FriendlyCount int64 `json:"friendly_count"` // 有效邀请数（有订单的用户）
+		HistoryCount  int64 `json:"history_count"`  // 历史邀请总数
+	}
+	// GetInviteSalesRequest - 获取最近销售数据
+	GetInviteSalesRequest {
+		Page int `form:"page" validate:"required"`
+		Size int `form:"size" validate:"required"`
+	}
+	// GetInviteSalesResponse - 最近销售数据响应
+	GetInviteSalesResponse {
+		Total int64             `json:"total"` // 销售记录总数
+		List  []InvitedUserSale `json:"list"`  // 销售数据列表（分页）
+	}
+	// InvitedUserSale - 被邀请用户的销售记录
+	InvitedUserSale {
+		Amount    int64  `json:"amount"`
+		CreatedAt int64  `json:"created_at"`
+		UserEmail string `json:"user_email"`
+		UserId    int64  `json:"user_id"`
+	}
+	// GetAgentDownloadsRequest - 获取各端下载量
+	GetAgentDownloadsRequest {}
+	// GetAgentDownloadsResponse - 各端下载量响应
+	GetAgentDownloadsResponse {
+		List []AgentDownloadStats `json:"list"`
+	}
+	// AgentDownloadStats - 各端下载量统计
+	AgentDownloadStats {
+		Platform string `json:"platform"`
+		Clicks   int64  `json:"clicks"`
+		Visits   int64  `json:"visits"`
+	}
 )
 
 @server (
@@ -225,5 +270,21 @@ service ppanel {
 	@doc "Unbind Device"
 	@handler UnbindDevice
 	put /unbind_device (UnbindDeviceRequest)
+
+	@doc "Get agent realtime data"
+	@handler GetAgentRealtime
+	get /agent/realtime (GetAgentRealtimeRequest) returns (GetAgentRealtimeResponse)
+
+	@doc "Get user invite statistics"
+	@handler GetUserInviteStats
+	get /invite/stats (GetUserInviteStatsRequest) returns (GetUserInviteStatsResponse)
+
+	@doc "Get invite sales data"
+	@handler GetInviteSales
+	get /invite/sales (GetInviteSalesRequest) returns (GetInviteSalesResponse)
+
+	@doc "Get agent downloads data"
+	@handler GetAgentDownloads
+	get /agent/downloads (GetAgentDownloadsRequest) returns (GetAgentDownloadsResponse)
 }