analytics

type AggregateQuery struct {
	MetricQuery
	AggregateType AggregateType `json:"aggregate_type"`
	GroupBy       []string      `json:"group_by"`
	Interval      time.Duration `json:"interval"`
}

type AggregateType string

type AggregatedMetric struct {
	Name      string            `json:"name"`
	Value     float64           `json:"value"`
	Timestamp time.Time         `json:"timestamp"`
	Tags      map[string]string `json:"tags"`
}

type AlertAction struct {
	Type        string         `json:"type"`
	Description string         `json:"description"`
	Target      string         `json:"target"`
	Parameters  map[string]any `json:"parameters"`
	Automated   bool           `json:"automated"`
}

type AlertContext struct {
	TriggerMetric   string         `json:"trigger_metric"`
	RelatedMetrics  []string       `json:"related_metrics"`
	SystemContext   map[string]any `json:"system_context"`
	UserContext     map[string]any `json:"user_context"`
	BusinessContext map[string]any `json:"business_context"`
}

type AlertManager interface {
	SendAlert(ctx context.Context, alert PerformanceAlert) error
	GetActiveAlerts() []PerformanceAlert
	AcknowledgeAlert(alertID string) error
	SuppressAlert(alertID string, duration time.Duration) error
}

type AlertPriority string

type AlertSeverity string

type AlertTriggerType string

type AnalyticsDataStore interface {
	StoreMetric(ctx context.Context, metric *PerformanceMetric) error
	GetMetrics(ctx context.Context, query MetricQuery) ([]PerformanceMetric, error)
	GetAggregatedMetrics(ctx context.Context, query AggregateQuery) ([]AggregatedMetric, error)
	DeleteOldMetrics(ctx context.Context, before time.Time) error
	GetMetricNames() []string
}

type AnomalyContext struct {
	PrecedingTrend   string            `json:"preceding_trend"`
	ConcurrentEvents []ConcurrentEvent `json:"concurrent_events"`
	RelatedMetrics   []RelatedMetric   `json:"related_metrics"`
	SystemState      map[string]any    `json:"system_state"`
}

type AnomalyDetector interface {
	DetectAnomalies(ctx context.Context, metrics []PerformanceMetric) ([]PerformanceAnomaly, error)
	TrainModel(ctx context.Context, historicalData []PerformanceMetric) error
	UpdateBaseline(ctx context.Context, metrics []PerformanceMetric) error
	GetDetectionSensitivity() float64
	SetDetectionSensitivity(sensitivity float64)
}

type AnomalyImpact struct {
	UserExperience  ImpactLevel `json:"user_experience"`
	SystemStability ImpactLevel `json:"system_stability"`
	BusinessMetrics ImpactLevel `json:"business_metrics"`
	OperationalCost ImpactLevel `json:"operational_cost"`
	SecurityRisk    ImpactLevel `json:"security_risk"`
	ComplianceRisk  ImpactLevel `json:"compliance_risk"`
}

type AnomalySeverity string

type AnomalyType string

type ConcurrentEvent struct {
	Type        string    `json:"type"`
	Description string    `json:"description"`
	Timestamp   time.Time `json:"timestamp"`
	Correlation float64   `json:"correlation"`
}

type CorrelationMatrix struct {
	Metrics      []string    `json:"metrics"`
	Correlations [][]float64 `json:"correlations"`
	Significance [][]float64 `json:"significance"`
	CalculatedAt time.Time   `json:"calculated_at"`
}

type CostEstimate struct {
	Initial   float64 `json:"initial"`
	Recurring float64 `json:"recurring"`
	Currency  string  `json:"currency"`
	Period    string  `json:"period"`
}

type DistributionAnalysis struct {
	Type       string  `json:"type"`
	Skewness   float64 `json:"skewness"`
	Kurtosis   float64 `json:"kurtosis"`
	IsNormal   bool    `json:"is_normal"`
	Confidence float64 `json:"confidence"`
}

type EffortLevel string

type ForecastPoint struct {
	Timestamp time.Time `json:"timestamp"`
	Value     float64   `json:"value"`
	Lower     float64   `json:"lower"`
	Upper     float64   `json:"upper"`
}

type ImpactLevel string

type MetricQuery struct {
	MetricNames []string          `json:"metric_names"`
	TimeRange   TimeRange         `json:"time_range"`
	Tags        map[string]string `json:"tags"`
	Limit       int               `json:"limit"`
	Offset      int               `json:"offset"`
}

type OutlierPoint struct {
	Timestamp time.Time `json:"timestamp"`
	Value     float64   `json:"value"`
	ZScore    float64   `json:"z_score"`
	Severity  string    `json:"severity"`
}

type Pattern struct {
	Name       string    `json:"name"`
	StartTime  time.Time `json:"start_time"`
	EndTime    time.Time `json:"end_time"`
	Amplitude  float64   `json:"amplitude"`
	Frequency  float64   `json:"frequency"`
	Confidence float64   `json:"confidence"`
}

type PerformanceAlert struct {
	ID           string           `json:"id"`
	Title        string           `json:"title"`
	Description  string           `json:"description"`
	Severity     AlertSeverity    `json:"severity"`
	Priority     AlertPriority    `json:"priority"`
	Timestamp    time.Time        `json:"timestamp"`
	MetricName   string           `json:"metric_name"`
	Threshold    Threshold        `json:"threshold"`
	ActualValue  float64          `json:"actual_value"`
	TriggerType  AlertTriggerType `json:"trigger_type"`
	Context      AlertContext     `json:"context"`
	Actions      []AlertAction    `json:"actions"`
	Suppressed   bool             `json:"suppressed"`
	Acknowledged bool             `json:"acknowledged"`
}

type PerformanceAnalysis struct {
	ID              string                      `json:"id"`
	TimeRange       TimeRange                   `json:"time_range"`
	Metrics         []PerformanceMetric         `json:"metrics"`
	Statistics      PerformanceStatistics       `json:"statistics"`
	Trends          []PerformanceTrend          `json:"trends"`
	Anomalies       []PerformanceAnomaly        `json:"anomalies"`
	Predictions     []PerformancePrediction     `json:"predictions"`
	HealthScore     float64                     `json:"health_score"`
	Recommendations []PerformanceRecommendation `json:"recommendations"`
	Alerts          []PerformanceAlert          `json:"alerts"`
	GeneratedAt     time.Time                   `json:"generated_at"`
	Duration        time.Duration               `json:"duration"`
}

type PerformanceAnalyticsConfig struct {
	Enabled                bool          `json:"enabled"`
	DataRetentionDays      int           `json:"data_retention_days"`
	AnalysisInterval       time.Duration `json:"analysis_interval"`
	AnomalyDetectionWindow time.Duration `json:"anomaly_detection_window"`
	TrendAnalysisWindow    time.Duration `json:"trend_analysis_window"`
	MetricSamplingRate     float64       `json:"metric_sampling_rate"`
	AlertingEnabled        bool          `json:"alerting_enabled"`
	MaxConcurrentAnalysis  int           `json:"max_concurrent_analysis"`
	EnablePredictive       bool          `json:"enable_predictive"`
	EnableMachineLearning  bool          `json:"enable_machine_learning"`
}

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

type PerformanceAnomaly struct {
	ID              string          `json:"id"`
	MetricName      string          `json:"metric_name"`
	Timestamp       time.Time       `json:"timestamp"`
	Value           float64         `json:"value"`
	ExpectedValue   float64         `json:"expected_value"`
	Deviation       float64         `json:"deviation"`
	Severity        AnomalySeverity `json:"severity"`
	Type            AnomalyType     `json:"type"`
	Confidence      float64         `json:"confidence"`
	Context         AnomalyContext  `json:"context"`
	Impact          AnomalyImpact   `json:"impact"`
	Explanation     string          `json:"explanation"`
	Recommendations []string        `json:"recommendations"`
	RelatedMetrics  []string        `json:"related_metrics"`
}

type PerformanceMetric struct {
	ID            string            `json:"id"`
	Name          string            `json:"name"`
	Value         float64           `json:"value"`
	Unit          string            `json:"unit"`
	Timestamp     time.Time         `json:"timestamp"`
	Source        string            `json:"source"`
	Tags          map[string]string `json:"tags"`
	Dimensions    map[string]string `json:"dimensions"`
	Metadata      map[string]any    `json:"metadata"`
	AggregateType AggregateType     `json:"aggregate_type"`
}

type PerformancePrediction struct {
	ID              string               `json:"id"`
	MetricName      string               `json:"metric_name"`
	PredictionType  PredictionType       `json:"prediction_type"`
	TimeHorizon     time.Duration        `json:"time_horizon"`
	PredictedValue  float64              `json:"predicted_value"`
	ConfidenceLevel float64              `json:"confidence_level"`
	PredictionBands PredictionBands      `json:"prediction_bands"`
	Methodology     string               `json:"methodology"`
	Assumptions     []string             `json:"assumptions"`
	RiskFactors     []RiskFactor         `json:"risk_factors"`
	Scenarios       []PredictionScenario `json:"scenarios"`
	GeneratedAt     time.Time            `json:"generated_at"`
}

type PerformanceRecommendation struct {
	ID          string                 `json:"id"`
	Title       string                 `json:"title"`
	Description string                 `json:"description"`
	Priority    Priority               `json:"priority"`
	Category    RecommendationCategory `json:"category"`
	Impact      ImpactLevel            `json:"impact"`
	Effort      EffortLevel            `json:"effort"`
	Actions     []RecommendedAction    `json:"actions"`
	Benefits    []string               `json:"benefits"`
	Risks       []string               `json:"risks"`
	Metrics     []string               `json:"metrics"`
	Timeline    time.Duration          `json:"timeline"`
	Cost        CostEstimate           `json:"cost"`
}

type PerformanceStatistics struct {
	Count        int64                `json:"count"`
	Mean         float64              `json:"mean"`
	Median       float64              `json:"median"`
	Mode         float64              `json:"mode"`
	StdDev       float64              `json:"std_dev"`
	Variance     float64              `json:"variance"`
	Min          float64              `json:"min"`
	Max          float64              `json:"max"`
	Range        float64              `json:"range"`
	Percentiles  map[string]float64   `json:"percentiles"`
	Distribution DistributionAnalysis `json:"distribution"`
	Outliers     []OutlierPoint       `json:"outliers"`
}

type PerformanceTrend struct {
	ID          string             `json:"id"`
	MetricName  string             `json:"metric_name"`
	Direction   TrendDirection     `json:"direction"`
	Strength    float64            `json:"strength"`
	Confidence  float64            `json:"confidence"`
	Duration    time.Duration      `json:"duration"`
	Slope       float64            `json:"slope"`
	StartValue  float64            `json:"start_value"`
	EndValue    float64            `json:"end_value"`
	ChangeRate  float64            `json:"change_rate"`
	Seasonality SeasonalityPattern `json:"seasonality"`
	Forecast    TrendForecast      `json:"forecast"`
}

type PredictionBands struct {
	Upper95 float64 `json:"upper_95"`
	Upper80 float64 `json:"upper_80"`
	Lower80 float64 `json:"lower_80"`
	Lower95 float64 `json:"lower_95"`
}

type PredictionScenario struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Probability float64  `json:"probability"`
	Value       float64  `json:"value"`
	Conditions  []string `json:"conditions"`
}

type PredictionType string

type Priority string

type RecommendationCategory string

type RecommendedAction struct {
	Type        string         `json:"type"`
	Description string         `json:"description"`
	Command     string         `json:"command,omitempty"`
	Parameters  map[string]any `json:"parameters,omitempty"`
	Validation  string         `json:"validation,omitempty"`
	Rollback    string         `json:"rollback,omitempty"`
}

type RelatedMetric struct {
	Name        string  `json:"name"`
	Value       float64 `json:"value"`
	Correlation float64 `json:"correlation"`
	Impact      string  `json:"impact"`
}

type RiskFactor struct {
	Name        string  `json:"name"`
	Probability float64 `json:"probability"`
	Impact      string  `json:"impact"`
	Mitigation  string  `json:"mitigation"`
}

type SeasonalityPattern struct {
	Detected   bool          `json:"detected"`
	Cycle      time.Duration `json:"cycle"`
	Strength   float64       `json:"strength"`
	Confidence float64       `json:"confidence"`
	Patterns   []Pattern     `json:"patterns"`
}

type Threshold struct {
	Name     string            `json:"name"`
	Operator ThresholdOperator `json:"operator"`
	Value    float64           `json:"value"`
	Severity AlertSeverity     `json:"severity"`
	Duration time.Duration     `json:"duration"`
	Dynamic  bool              `json:"dynamic"`
}

type ThresholdManager interface {
	GetThresholds(metricName string) []Threshold
	SetThreshold(metricName string, threshold Threshold) error
	UpdateDynamicThresholds(ctx context.Context, metrics []PerformanceMetric) error
	EvaluateThresholds(metric PerformanceMetric) []ThresholdViolation
}

type ThresholdOperator string

type ThresholdViolation struct {
	Threshold   Threshold     `json:"threshold"`
	ActualValue float64       `json:"actual_value"`
	Timestamp   time.Time     `json:"timestamp"`
	Duration    time.Duration `json:"duration"`
}

type TimeRange struct {
	Start time.Time `json:"start"`
	End   time.Time `json:"end"`
}

type TrendAnalyzer interface {
	AnalyzeTrends(ctx context.Context, metrics []PerformanceMetric) ([]PerformanceTrend, error)
	PredictTrends(ctx context.Context, metrics []PerformanceMetric, horizon time.Duration) ([]PerformancePrediction, error)
	DetectSeasonality(ctx context.Context, metrics []PerformanceMetric) (SeasonalityPattern, error)
	CalculateCorrelations(ctx context.Context, metrics map[string][]PerformanceMetric) (CorrelationMatrix, error)
}

type TrendDirection string

type TrendForecast struct {
	Points      []ForecastPoint `json:"points"`
	Confidence  float64         `json:"confidence"`
	Methodology string          `json:"methodology"`
}