weekly

type Candidate struct {
	User     uuid.UUID
	Email    string
	Timezone string
	Model    string
}

type Job struct {
	Source    Source
	Summarize SummaryFunc
	Mailer    Mailer
	Signer    *statement.Signer
	BaseURL   string
	Engage    *engage.Engage
	Now       func() time.Time
	Logger    *slog.Logger
	// Pause is called between sends (the throttle); nil uses 500 ms.
	Pause func(ctx context.Context)
}

type LeasePace struct {
	// MilesOver is positive when they are over pace, negative when under.
	MilesOver float64
}

type Mailer interface {
	Send(ctx context.Context, m email.Message) error
}

type Source interface {
	Candidates(ctx context.Context) ([]Candidate, error)
	// Enabled reads the live toggle.
	Enabled(ctx context.Context, uid uuid.UUID) (bool, error)
}

type Stats struct{ Considered, Due, Sent, Skipped, Failed int }

type Summary struct {
	Model      string
	Currency   string
	Miles      float64
	Drives     int
	KWhUsed    float64 // 0: unknown
	MiPerKWh   float64 // 0: unknown
	KWhCharged float64
	Cost       float64
	// HomePct is the share of charged energy done at home; nil when no home
	// place is set or nothing was charged.
	HomePct *int
	// BestMiles and BestMiPerKWh describe the most efficient drive; zero when the
	// week had fewer than two drives.
	BestMiles, BestMiPerKWh float64
	Lease                   *LeasePace
	// Charges counts charging sessions in the week.
	Charges int
}

type SummaryFunc func(ctx context.Context, c Candidate, start, end time.Time, loc *time.Location) (Summary, error)