mirror of
https://github.com/IS1DI/x0gp.git
synced 2026-07-16 20:47:55 +00:00
x0gp
978d36c505
This commit captures the full server code accumulated across
several development sessions. It includes the following layers,
applied in roughly this order during development:
1. Base infrastructure
- cmd/poc-server HTTP+WebSocket server, /health, /stats
- internal/transport wire types (Envelope + all message types)
- internal/catalog, internal/realtime, internal/stats
- internal/storage/postgres with migrations 001-004
- .env, .env.example, docker-compose, Dockerfile, scripts/
2. Swagger documentation
- go get github.com/swaggo/http-swagger
- swag init produces docs/docs.go
- /swagger/index.html UI, /swagger/doc.json spec
- annotations on health/stats/ws and catalog handlers
3. Races API
- internal/races/{store,service,keyset,types}.go
- migration 005_races.sql: finished_races, race_plans, race_queue
- GET /api/races with keyset pagination, status filter
- GET /api/races/upcoming
- POST /api/races/queue/join, GET, DELETE
- POST/GET /api/races/plans, DELETE /{id}
- lobby.RaceMeta simplification (no host_id/host_name)
4. Races seeder
- internal/races/seed with deterministic generator
- --seed-races / --reset CLI flags in main.go
- 30 finished + 5 live + 5 plans + 4 queue entries
5. Drivers and clans
- internal/drivers, internal/clans (CRUD, validation)
- migration 008_drivers_clans.sql
- /api/clans and /api/drivers endpoints
- 3-letter uppercase nickname/tag validation
- lobby.DriverMeta: Nickname, AvatarURL, ClanID, ClanTag
6. Podium
- internal/transport.RacePodiumEntry
- lobby.SetDriverProfile for in-memory metadata sync
- migration 007_podium.sql (podium JSONB column)
- seeder populates top-3 per finished race
7. Live races persistence
- migration 009_live_persistence.sql: live_races,
live_race_drivers, lobby_drivers
- internal/races/live_store.go: LiveStore with write-side
mirror for lobby.Service mutations
- Service.collectLive and Upcoming read from Postgres
- main.go RestoreFromDB rehydrates lobby on startup
8. Unify live + finished into one races table
- migration 010_unify_races.sql: rename finished_races to
races, expand status CHECK, merge live rows
- PgStore now hosts both write paths; LiveStore is a
thin facade implementing lobby.Persistence
- seeder resetAll drops only finished/cancelled rows and
race_plans / race_queue / lobby_drivers
Each layer is consistent on its own; cross-layer changes are
visible in the file history. A future refactor may split this
commit into the per-stage boundaries listed above.
76 lines
2.5 KiB
Go
76 lines
2.5 KiB
Go
package races
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/x0gp/server/internal/lobby"
|
|
)
|
|
|
|
// LiveStore is a thin facade over PgStore that exposes only the live
|
|
// race persistence methods. It implements the lobby.Persistence
|
|
// contract so the lobby can write through it.
|
|
//
|
|
// Methods on this type are kept separate from the rest of PgStore
|
|
// purely for clarity: the lobby-facing surface is small and
|
|
// well-defined. All actual work is delegated to PgStore.
|
|
type LiveStore struct {
|
|
pg *PgStore
|
|
}
|
|
|
|
// NewLiveStore wraps an existing PgStore.
|
|
func NewLiveStore(pg *PgStore) *LiveStore { return &LiveStore{pg: pg} }
|
|
|
|
func (s *LiveStore) UpsertRace(ctx context.Context, r lobby.RaceMeta) error {
|
|
return s.pg.UpsertLive(ctx, r)
|
|
}
|
|
|
|
func (s *LiveStore) DeleteRace(ctx context.Context, raceID string) error {
|
|
return s.pg.DeleteLive(ctx, raceID)
|
|
}
|
|
|
|
func (s *LiveStore) AddDriver(ctx context.Context, raceID, driverID string, slot int) error {
|
|
return s.pg.AddLiveDriver(ctx, raceID, driverID, slot)
|
|
}
|
|
|
|
func (s *LiveStore) RemoveDriver(ctx context.Context, raceID, driverID string) error {
|
|
return s.pg.RemoveLiveDriver(ctx, raceID, driverID)
|
|
}
|
|
|
|
func (s *LiveStore) SetRaceStatus(ctx context.Context, raceID string, status lobby.RaceStatus, startedMs int64) error {
|
|
return s.pg.SetLiveStatus(ctx, raceID, status, startedMs)
|
|
}
|
|
|
|
func (s *LiveStore) UpsertDriver(ctx context.Context, d lobby.DriverMeta) error {
|
|
return s.pg.UpsertLobbyDriver(ctx, d)
|
|
}
|
|
|
|
func (s *LiveStore) DeleteDriver(ctx context.Context, driverID string) error {
|
|
return s.pg.DeleteLobbyDriver(ctx, driverID)
|
|
}
|
|
|
|
// ListAllRaces returns every live row in the unified races table.
|
|
// Used by RestoreFromDB to rehydrate the in-memory lobby.
|
|
func (s *LiveStore) ListAllRaces(ctx context.Context) ([]lobby.RaceMeta, error) {
|
|
return s.pg.ListAllRaces(ctx)
|
|
}
|
|
|
|
// ListAllDrivers returns all lobby drivers from the lobby_drivers table.
|
|
func (s *LiveStore) ListAllDrivers(ctx context.Context) ([]lobby.DriverMeta, error) {
|
|
return s.pg.ListLobbyDrivers(ctx)
|
|
}
|
|
|
|
// ListLivePaged exposes a keyset page of live races.
|
|
func (s *LiveStore) ListLivePaged(ctx context.Context, statuses []string, trackID string, cur Cursor, limit int) ([]lobby.RaceMeta, error) {
|
|
return s.pg.ListLivePaged(ctx, statuses, trackID, cur, limit)
|
|
}
|
|
|
|
// ListUpcoming returns the next N open live races.
|
|
func (s *LiveStore) ListUpcoming(ctx context.Context, limit int) ([]lobby.RaceMeta, error) {
|
|
return s.pg.ListLiveUpcoming(ctx, limit)
|
|
}
|
|
|
|
// Exec exposes raw SQL for the seeder.
|
|
func (s *LiveStore) Exec(ctx context.Context, sql string) (int64, error) {
|
|
return s.pg.Exec(ctx, sql)
|
|
}
|