syntax = "v1"

info (
	title:   "仪表盘 API"
	desc:    "仪表盘统计数据接口"
	author:  "author@example.com"
	version: "v1.0"
)

// ========== 仪表盘类型 ==========
type (
	// 最近活动请求
	RecentActivitiesRequest {
		Limit int `form:"limit,default=10"` // 数量限制
	}

	// 仪表盘统计数据
	DashboardStatsResponse {
		TotalUsers   int64  `json:"totalUsers"`   // 总用户数
		ActiveUsers  int64  `json:"activeUsers"`  // 活跃用户数
		SystemLoad   int    `json:"systemLoad"`   // 系统负载 0-100
		DbStatus     string `json:"dbStatus"`     // 数据库状态
		UserGrowth   int    `json:"userGrowth"`   // 用户增长率
	}

	// 活动记录
	Activity {
		Id     int64  `json:"id"`     // 记录ID
		User   string `json:"user"`   // 用户邮箱
		Action string `json:"action"` // 操作
		Time   string `json:"time"`   // 时间描述
		Status string `json:"status"` // 状态 success/error
	}

	// 最近活动列表响应
	RecentActivitiesResponse {
		Activities []Activity `json:"activities"` // 活动列表
	}
)