second commit

internal/reporting/data_source.go

@@ -0,0 +1,64 @@
+package reporting
+
+import (
+	"time"
+)
+
+// TimeseriesPoint represents a single data point in a timeseries.
+type TimeseriesPoint struct {
+	Timestamp time.Time `json:"timestamp"`
+	Value     float64   `json:"value"`
+}
+
+// AggregateResult holds a single aggregate value for a metric.
+type AggregateResult struct {
+	Metric string  `json:"metric"`
+	Value  float64 `json:"value"`
+}
+
+// SummaryResult holds the summary (totals/averages) for a metric over a range.
+type SummaryResult struct {
+	Metric    string  `json:"metric"`
+	Total     float64 `json:"total"`
+	Average   float64 `json:"average"`
+	Count     int     `json:"count"`
+}
+
+// DataSourceParams defines the parameters for a data source query.
+// Reference: Chatwoot Reports::DataSource — for(account, metric, dimension_type, dimension_id,
+// range, group_by, timezone_offset, business_hours)
+type DataSourceParams struct {
+	AccountID         uint
+	Metric            string
+	DimensionType     DimensionType
+	DimensionID       uint
+	Since             time.Time
+	Until             time.Time
+	GroupBy           string // day, week, month
+	TimezoneOffset    int    // hours offset from UTC
+	BusinessHours     bool
+}
+
+// DataSource is the interface for fetching report data (timeseries, aggregate, summary).
+// Reference: Chatwoot Reports::DataSource base class.
+type DataSource interface {
+	// Timeseries returns a time-bucketed series of data points.
+	Timeseries(params DataSourceParams) ([]TimeseriesPoint, error)
+	// Aggregate returns a single aggregate value for the metric.
+	Aggregate(params DataSourceParams) (*AggregateResult, error)
+	// Summary returns total, average, and count for the metric over the range.
+	Summary(params DataSourceParams) (*SummaryResult, error)
+}
+
+// RawDataSource queries raw reporting_events for timeseries/aggregate/summary.
+// Reference: Chatwoot Reports::RawDataSource
+type RawDataSource struct{}
+
+// NewRawDataSource creates a new raw data source.
+func NewRawDataSource() *RawDataSource {
+	return &RawDataSource{}
+}
+
+// Note: Timeseries, Aggregate, Summary implementations on RawDataSource will be
+// wired through ReportingService which holds the DB connection.
+// The DataSource interface allows swapping between RawDataSource and RollupDataSource.