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.
91 lines
2.2 KiB
YAML
91 lines
2.2 KiB
YAML
name: x0gp-dev
|
|
|
|
# Dev stack for the PoC. Mirrors what Coolify will provision on the Orange
|
|
# Pi 5 Pro. Services run on a private network; only the api-gateway is
|
|
# published to localhost.
|
|
#
|
|
# Usage:
|
|
# make compose-up
|
|
# make compose-down
|
|
#
|
|
# Notes:
|
|
# - All images use linux/arm64 by default (Orange Pi 5 Pro). Override with
|
|
# --platform=linux/amd64 if you're on x86.
|
|
# - Persistent volumes: postgres-data, redis-data, prom-data, grafana-data.
|
|
# - On a fresh install, run `make proto` first to generate proto/gen/.
|
|
|
|
services:
|
|
postgres:
|
|
image: timescale/timescaledb:latest-pg16
|
|
restart: unless-stopped
|
|
platform: linux/arm64
|
|
environment:
|
|
POSTGRES_USER: x0gp
|
|
POSTGRES_PASSWORD: x0gp
|
|
POSTGRES_DB: x0gp
|
|
volumes:
|
|
- postgres-data:/var/lib/postgresql/data
|
|
ports:
|
|
- "127.0.0.1:5434:5432"
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "pg_isready -U x0gp"]
|
|
interval: 5s
|
|
timeout: 3s
|
|
retries: 10
|
|
|
|
redis:
|
|
image: redis:7-alpine
|
|
restart: unless-stopped
|
|
command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
|
|
volumes:
|
|
- redis-data:/data
|
|
ports:
|
|
- "127.0.0.1:6379:6379"
|
|
|
|
api-gateway:
|
|
build:
|
|
context: .
|
|
dockerfile: Dockerfile
|
|
args:
|
|
GOARCH: arm64
|
|
CMD: poc-server
|
|
restart: unless-stopped
|
|
depends_on:
|
|
postgres:
|
|
condition: service_healthy
|
|
redis:
|
|
condition: service_started
|
|
environment:
|
|
X0GP_HTTP_ADDR: ":8080"
|
|
X0GP_TICK_RATE: "60"
|
|
X0GP_SNAPSHOT_RATE: "30"
|
|
X0GP_LOG_LEVEL: "info"
|
|
X0GP_DEV_MODE: "true"
|
|
DATABASE_URL: "postgres://x0gp:x0gp@postgres:5432/x0gp?sslmode=disable"
|
|
REDIS_URL: "redis://redis:6379"
|
|
ports:
|
|
- "127.0.0.1:8080:8080"
|
|
|
|
prometheus:
|
|
image: prom/prometheus:latest
|
|
restart: unless-stopped
|
|
volumes:
|
|
- ./deploy/prometheus.yml:/etc/prometheus/prometheus.yml:ro
|
|
- prom-data:/prometheus
|
|
ports:
|
|
- "127.0.0.1:9090:9090"
|
|
|
|
grafana:
|
|
image: grafana/grafana:latest
|
|
restart: unless-stopped
|
|
volumes:
|
|
- grafana-data:/var/lib/grafana
|
|
ports:
|
|
- "127.0.0.1:3000:3000"
|
|
|
|
volumes:
|
|
postgres-data:
|
|
redis-data:
|
|
prom-data:
|
|
grafana-data:
|