analytics.go

package fastbi

import (
	"context"
	"net/http"
)


type RevenueInsightsFilter struct {
	StartDate string
	EndDate   string
	Category  string
	Region    string
}


type ExpansionOpportunitiesRequest struct {
	MinRevenueThreshold float64 `json:"min_revenue_threshold"`
}


type ProductMixRequest struct {
	OrganizationName string  `json:"organization_name"`
	StartDate        *string `json:"start_date,omitempty"`
	EndDate          *string `json:"end_date,omitempty"`
}


type ForecastRequest struct {
	OrganizationName       string `json:"organization_name"`
	MonthsAhead            int    `json:"months_ahead"`
	IncludeExternalFactors bool   `json:"include_external_factors"`
}


type AnalyticsService struct{ c *Client }


func (s *AnalyticsService) RevenueInsights(ctx context.Context, f *RevenueInsightsFilter) (map[string]any, error) {
	params := []string{}
	if f != nil {
		if f.StartDate != "" {
			params = append(params, "start_date", f.StartDate)
		}
		if f.EndDate != "" {
			params = append(params, "end_date", f.EndDate)
		}
		if f.Category != "" {
			params = append(params, "category", f.Category)
		}
		if f.Region != "" {
			params = append(params, "region", f.Region)
		}
	}
	var out map[string]any
	if err := s.c.do(ctx, http.MethodGet, s.c.url("/analytics/revenue-insights", params...), nil, &out); err != nil {
		return nil, err
	}
	return out, nil
}


func (s *AnalyticsService) ExpansionOpportunities(ctx context.Context, req *ExpansionOpportunitiesRequest) (map[string]any, error) {
	var out map[string]any
	if err := s.c.do(ctx, http.MethodGet, "/analytics/expansion-opportunities", req, &out); err != nil {
		return nil, err
	}
	return out, nil
}


func (s *AnalyticsService) OptimizeProductMix(ctx context.Context, req *ProductMixRequest) (map[string]any, error) {
	var out map[string]any
	if err := s.c.do(ctx, http.MethodPost, "/analytics/product-mix", req, &out); err != nil {
		return nil, err
	}
	return out, nil
}


func (s *AnalyticsService) ForecastRevenue(ctx context.Context, req *ForecastRequest) (map[string]any, error) {
	var out map[string]any
	if err := s.c.do(ctx, http.MethodPost, "/analytics/forecast", req, &out); err != nil {
		return nil, err
	}
	return out, nil
}