telemetry

type AdImpressionRequest struct {
	UserID        string
	AdNetwork     string
	PlacementID   string
	AdFormat      string // rewarded/interstitial/banner/native
	PlacementType string // between_waves/revive/booster/double_reward
	EcpmUSD       float64
	RevenueUSD    float64
}

type AnalyticsBridge struct {
	// contains filtered or unexported fields
}

type AnalyticsBridgeConfig struct {
	Enabled        bool          `yaml:"enabled"`
	RedisAddr      string        `yaml:"redis_addr"`
	RedisPassword  string        `yaml:"redis_password"`
	RedisDB        int           `yaml:"redis_db"`
	TopicPrefix    string        `yaml:"topic_prefix"`
	RetentionHours int           `yaml:"retention_hours"`
	BatchSize      int           `yaml:"batch_size"`
	FlushInterval  time.Duration `yaml:"flush_interval"`
}

type AnalyticsEvent struct {
	EventType  string                 `json:"event_type"`
	GameID     string                 `json:"game_id"`
	UserID     string                 `json:"user_id"`
	SessionID  string                 `json:"session_id"`
	Platform   string                 `json:"platform"`
	Region     string                 `json:"region"`
	Timestamp  int64                  `json:"timestamp"`
	Attributes map[string]interface{} `json:"attributes"`
	TraceID    string                 `json:"trace_id,omitempty"`
	SpanID     string                 `json:"span_id,omitempty"`
}

type CrashEvent struct {
	UserID     string
	SessionID  string
	StackHash  string
	SignalCode string
	Scene      string
	DeviceID   string
}

type EconomyTransaction struct {
	UserID       string
	Currency     string
	CurrencyKind string // soft/hard/real
	Amount       float64
	Type         string // earn/spend
	Source       string // for earn: kill_enemy/wave_bonus/quest/ad_reward/offline
	Sink         string // for spend: tower_build/tower_upgrade/ability/unlock/boost
	ItemID       string
	BalanceAfter float64
}

type FunctionCallRequest struct {
	FunctionID  string
	Version     string
	UserID      string
	SessionID   string
	GameID      string
	Environment string
	AgentID     string
	Parameters  map[string]interface{}
}

type FunctionCallResult struct {
	Success      bool
	DurationMs   int64
	ResultType   string
	ErrorMessage string
	ErrorCode    string
}

type GachaPullRequest struct {
	UserID      string
	PoolID      string
	Pulls       int
	Rarity      string
	PityCounter int
	ItemIDs     []string
}

type GameMetrics struct {
	// === 用户活跃指标 ===
	DAU metric.Int64ObservableGauge // 日活跃用户数
	WAU metric.Int64ObservableGauge // 周活跃用户数
	MAU metric.Int64ObservableGauge // 月活跃用户数

	UserLoginCounter    metric.Int64Counter // 登录次数
	UserRegisterCounter metric.Int64Counter // 注册次数

	// === 留存指标 ===
	RetentionD1  metric.Float64ObservableGauge // 次日留存率
	RetentionD7  metric.Float64ObservableGauge // 7日留存率
	RetentionD30 metric.Float64ObservableGauge // 30日留存率

	// === 会话指标 ===
	SessionDuration metric.Float64Histogram // 会话时长分布
	SessionCounter  metric.Int64Counter     // 会话计数

	// === 变现指标 ===
	RevenueTotal metric.Float64Counter         // 总收入
	ARPU         metric.Float64ObservableGauge // 每用户平均收入
	ARPPU        metric.Float64ObservableGauge // 每付费用户收入
	PaymentRate  metric.Float64ObservableGauge // 付费率

	// 广告收入
	AdRevenue     metric.Float64Counter         // 广告收入
	AdImpressions metric.Int64Counter           // 广告曝光
	AdARPU        metric.Float64ObservableGauge // 广告ARPU

	// === 游戏玩法指标 ===
	// 关卡/进度
	LevelStartCounter    metric.Int64Counter           // 关卡开始
	LevelCompleteCounter metric.Int64Counter           // 关卡完成
	LevelFailCounter     metric.Int64Counter           // 关卡失败
	LevelCompletionRate  metric.Float64ObservableGauge // 关卡完成率
	LevelRetries         metric.Float64Histogram       // 重试次数分布

	// 对战系统
	MatchStartCounter metric.Int64Counter           // 对局开始
	MatchEndCounter   metric.Int64Counter           // 对局结束
	WinRate           metric.Float64ObservableGauge // 胜率
	MatchDuration     metric.Float64Histogram       // 对局时长
	QueueTime         metric.Float64Histogram       // 匹配等待时间

	// 经济系统
	CurrencyEarn   metric.Float64Counter         // 货币获得
	CurrencySpend  metric.Float64Counter         // 货币消费
	EconomyBalance metric.Float64ObservableGauge // 产消比

	// === 技术指标 ===
	ClientFPS      metric.Float64Histogram // 客户端帧率
	NetworkLatency metric.Float64Histogram // 网络延迟
	MemoryUsage    metric.Float64Histogram // 内存使用

	// 稳定性指标
	CrashCounter       metric.Int64Counter           // 崩溃计数
	ANRCounter         metric.Int64Counter           // ANR计数
	CrashRate          metric.Float64ObservableGauge // 崩溃率
	CrashFreeUsersRate metric.Float64ObservableGauge // 无崩溃用户率

	// === 游戏类型特有指标 ===
	// 塔防 (TD)
	TDTowerBuildCounter   metric.Int64Counter           // 塔建造次数
	TDTowerUpgradeCounter metric.Int64Counter           // 塔升级次数
	TDTowerUsageRate      metric.Float64ObservableGauge // 塔型使用率
	TDUpgradeRate         metric.Float64ObservableGauge // 塔升级率

	// 卡牌游戏
	CardUsageRate      metric.Float64ObservableGauge // 卡牌使用率
	CardWinRate        metric.Float64ObservableGauge // 卡牌胜率
	DeckArchetypeShare metric.Float64ObservableGauge // 卡组类型分布

	// 抽卡系统
	GachaPullCounter metric.Int64Counter           // 抽卡次数
	GachaPityCounter metric.Float64ObservableGauge // 保底计数
}

type GameTelemetryService struct {
	// contains filtered or unexported fields
}

type GameTracer struct {
	// contains filtered or unexported fields
}

type LevelCompleteRequest struct {
	LevelID         string
	DurationMs      int64
	Stars           int
	Retries         int
	WaveIndex       int
	HeartsRemaining int
	Difficulty      string
}

type LevelFailRequest struct {
	LevelID         string
	DurationMs      int64
	Reason          string
	FailWave        int
	HeartsRemaining int
	Difficulty      string
}

type LevelStartRequest struct {
	UserID       string
	SessionID    string
	LevelID      string
	ChapterID    string
	StageID      string
	Difficulty   string
	WaveIndex    int
	AttemptIndex int
	IsBossWave   bool
}

type MatchEndRequest struct {
	MatchID       string
	MatchResult   string // win/lose/draw/abandon
	DurationMs    int64
	GameMode      string
	Kills         int
	Deaths        int
	Assists       int
	DamageDone    int
	DamageTaken   int
	Surrender     bool
	DeckID        string
	DeckArchetype string
}

type MatchStartRequest struct {
	UserID        string
	SessionID     string
	MatchID       string
	GameMode      string
	QueueType     string
	MapID         string
	QueueTimeMs   int
	MMR           int
	TeamID        string
	DeckID        string
	DeckArchetype string
}

type PerformanceMetrics struct {
	UserID     string
	FPS        float64
	MemoryMB   float64
	CPULoad    float64
	RTTMs      float64
	JitterMs   float64
	PacketLoss float64
}

type PermissionCheckRequest struct {
	UserID   string
	Resource string
	Action   string
	Scope    string
}

type PermissionCheckResult struct {
	Granted    bool
	Reason     string
	DurationMs int64
}

type Provider struct {
	TracerProvider *trace.TracerProvider
	MeterProvider  *metric.MeterProvider
	GameMetrics    *GameMetrics
	GameTracer     *GameTracer
	Bridge         *AnalyticsBridge
	// contains filtered or unexported fields
}

type PurchaseFlow struct {
	UserID          string
	OrderID         string
	SKUID           string
	PriceUSD        float64
	CurrencyCode    string
	PaymentProvider string
}

type PurchaseResult struct {
	OrderID    string
	SKUID      string
	PriceUSD   float64
	Success    bool
	FailReason string
	TaxUSD     float64
	Country    string
}

type SessionEndRequest struct {
	UserID     string
	SessionID  string
	DurationMs int64
	CauseOfEnd string // normal/crash/disconnect/quit
}

type SessionStartRequest struct {
	UserID     string
	SessionID  string
	Platform   string
	Region     string
	GameType   string
	GenreCode  string
	AppVersion string
	EntryPoint string
	CampaignID string
	DeviceID   string
}

type TelemetryConfig struct {
	ServiceName    string  `yaml:"service_name"`
	ServiceVersion string  `yaml:"service_version"`
	Environment    string  `yaml:"environment"`
	CollectorURL   string  `yaml:"collector_url"`
	GameID         string  `yaml:"game_id"`
	EnableTracing  bool    `yaml:"enable_tracing"`
	EnableMetrics  bool    `yaml:"enable_metrics"`
	SamplingRatio  float64 `yaml:"sampling_ratio"`

	// TLS配置
	UseTLS  bool   `yaml:"use_tls"` // 是否使用TLS连接到Collector
	Headers string `yaml:"headers"` // 自定义HTTP头（如Authorization）

	// Analytics桥接配置
	Analytics AnalyticsBridgeConfig `yaml:"analytics"`
}

type TowerBuildRequest struct {
	UserID    string
	LevelID   string
	TowerID   string
	TowerType string
	PosX      int
	PosY      int
	Cost      float64
	WaveIndex int
}

type TowerUpgradeRequest struct {
	UserID    string
	LevelID   string
	TowerID   string
	TowerType string
	FromLevel int
	ToLevel   int
	Cost      float64
	WaveIndex int
}