samples

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

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

type Sample struct {
	VehicleID       string
	At              time.Time
	BatteryLevelPct float64
	RangeMi         float64
	OdometerMi      float64
	Lat, Lon        float64
	// LocationFixAt is the timestamp Rivian's GNSS module reported on
	// the (Lat, Lon) fix itself, NOT the wall-clock time the recorder
	// observed it. Differs from At when the modem loses sky view and
	// keeps replaying the last known fix — see migration 0013 for
	// the field rationale and the Fort Stockton incident that
	// motivated it. Pointer (rather than time.Time + omitempty)
	// because Go's encoding/json doesn't honor omitempty on struct
	// types: a zero time.Time would serialize as "0001-01-01T00:00:00Z"
	// and the frontend would compute a 2000-year fix age. nil
	// renders as "fix age unknown" upstream.
	LocationFixAt  *time.Time `json:",omitempty"`
	SpeedMph       float64
	ShiftState     string
	DriveMode      string `json:"drive_mode,omitempty"` // "everyday", "sport", "all-terrain", etc.; nullable in DB for legacy samples
	ChargingState  string
	ChargerPowerKW float64
	ChargeLimitPct float64
	InsideTempC    float64
	OutsideTempC   float64
	DriveNumber    int64
	ChargeNumber   int64
	Source         string // "live" | "electrafi_import"
	// AltitudeM is the elevation above sea level (meters) at
	// (Lat, Lon), looked up by the live recorder against the
	// Mapzen Terrarium DEM at sample-write time. Pointer because
	// it's nullable: NULL on legacy rows written before migration
	// 0019, on samples without a GPS fix, on ElectraFi imports,
	// and on cold-cache misses where the tile fetch was kicked
	// off async (the next sample on that tile will hit the cache).
	AltitudeM *float64 `json:"altitude_m,omitempty"`
	// TirePressureMinBar is the minimum of the four corner pressures
	// at sample time, in bar. Pointer because nullable: NULL on
	// legacy rows pre-migration 0024, ElectraFi imports, and live
	// rows where Rivian reported zero on all four corners (sensor
	// outage / vehicle parked w/ no recent reading). The efficiency
	// analyzer pulls the median across a drive's samples; min-of-4
	// keeps the worst tire (the one that actually hurts efficiency)
	// dominant without bloating the schema with all four corners.
	TirePressureMinBar *float64 `json:"tire_pressure_min_bar,omitempty"`
}

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