box-box/internal/store/models.go

package store

import "time"

// RawPayload stores a fetched source payload with provenance metadata.
type RawPayload struct {
	ID              int64
	Source          string
	Endpoint        string
	RequestKey      string
	MeetingKey      *int
	SessionKey      *int
	Payload         string
	PayloadHash     string
	FetchedAt       time.Time
	ProvenanceJSON  string
}

// IngestionRun tracks a scoped ingestion attempt.
type IngestionRun struct {
	ID          int64
	ScopeType   string
	ScopeKey    string
	StartedAt   time.Time
	FinishedAt  *time.Time
	Status      string
	Refresh     bool
	SummaryJSON string
}

// Meeting is a race weekend record.
type Meeting struct {
	MeetingKey          int
	MeetingName         string
	MeetingOfficialName string
	Location            string
	CountryCode         string
	CountryName         string
	CircuitKey          int
	CircuitShortName    string
	GMTOffset           string
	DateStart           string
	DateEnd             string
	Year                int
	UpdatedAt           time.Time
}

// Session is a session within a meeting.
type Session struct {
	SessionKey  int
	MeetingKey  int
	SessionName string
	SessionType string
	CircuitKey  int
	DateStart   string
	DateEnd     string
	GMTOffset   string
	UpdatedAt   time.Time
}

// Driver is a driver identity record.
type Driver struct {
	DriverNumber  int
	BroadcastName string
	FirstName     string
	FullName      string
	LastName      string
	NameAcronym   string
	HeadshotURL   string
	TeamName      string
	TeamColour    string
	UpdatedAt     time.Time
}

// SessionDriver links a driver to a session with session-specific team info.
type SessionDriver struct {
	SessionKey   int
	DriverNumber int
	MeetingKey   int
	TeamName     string
	TeamColour   string
}

// SessionResult is a final classification row for a session.
type SessionResult struct {
	SessionKey      int
	DriverNumber    int
	MeetingKey      int
	Position        int
	Points          float64
	NumberOfLaps    int
	DurationJSON    string
	GapToLeaderJSON string
	DNF             bool
	DNS             bool
	DSQ             bool
}

// StartingGridEntry is a starting grid position for a session.
type StartingGridEntry struct {
	SessionKey   int
	DriverNumber int
	MeetingKey   int
	Position     int
	LapDuration  float64
}