receipts

type ChargeRef struct {
	ID        uuid.UUID
	StartedAt time.Time
	EndedAt   time.Time
	EnergyKWh float64
}

type EnergyCand struct {
	ChargeID   uuid.UUID
	ReceiptID  uuid.UUID
	TxnID      string
	FinalState string
	ChargeEnd  time.Time
	MaxPowerKW float64
	// Energy is the charge's energy now; Recorded is what the recorder saved first (the metadata
	// original once a receipt value is in, else Energy); AvgRecorded and CostRecorded the same for
	// the average power and the cost.
	Energy, Recorded, AvgPower float64
	AvgRecorded                *float64
	Cost                       *float64
	CostRecorded               *float64
	CostSource                 string
	PricePerKWh                float64
	FromReceipt                bool

	ReceiptStart, ReceiptEnd time.Time
	ReceiptEnergy            *float64
	IsHome                   *bool
	DetailFetched            bool
}

type EnergyUpdate struct {
	Energy      float64
	AvgPower    float64
	Cost        *float64 // nil: leave the cost alone
	Meta        map[string]any
	ExpectedNow float64
}

type PaidRate struct {
	Slug     string
	Currency string
	// PerKWh is total paid over total energy across Sessions receipts (energy-weighted,
	// not an average of per-session prices).
	PerKWh   float64
	Sessions int
}

type Pair struct {
	ReceiptID uuid.UUID
	ChargeID  uuid.UUID
}

type Receipt struct {
	ID            uuid.UUID
	TransactionID string
	StartedAt     time.Time
	EndedAt       time.Time
	TotalCost     *float64
	Currency      string
	EnergyKWh     *float64
	RangeAddedKm  *float64
	Vendor        string
	City          string
	ChargerName   string
	IsHome        *bool
	DetailFetched bool
	ChargeID      *uuid.UUID
}

type Result struct {
	Skipped     bool // claimed by another run within the interval, or not this pod's user
	NotOwner    bool // skipped because another pod owns the user's group (lead mode)
	Fetched     int  // summaries returned
	Matched     int  // new receipt-to-charge links
	Details     int  // detail calls that succeeded
	DetailsLeft bool
}

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

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

type UserFencer interface {
	FenceUser(ctx context.Context, uid string) (fence.Token, fence.State, error)
}