MyClub/diagrams/system-architecture.md

# System Architecture

```mermaid
graph LR
  subgraph Clients
    A["Public site React SPA"]
    B["Admin SPA"]
    C["Scoreboard Overlay"]
  end

  subgraph Frontend
    FE["React 18 + Chakra UI; Router + Query"]
  end

  subgraph Backend
    BE["Go Gin REST API api v1; GORM services"]
    JOBS["Background jobs; Prefetcher; Newsletter automation"]
  end

  subgraph Data
    DB["PostgreSQL"]
    UP["uploads static dist"]
  end

  subgraph Integrations_optional
    FACR["FACR API"]
    YT["YouTube API"]
    ZON["Zonerama"]
    SMTP["SMTP email"]
    MAPS["Google Maps"]
    UMAMI["Umami Analytics"]
  end

  A --> FE
  B --> FE
  C --> FE

  FE -->|REST JSON| BE
  FE -->|uploads static| UP

  BE --> DB
  BE --> UP

  %% External calls
  BE --> FACR
  BE --> YT
  BE --> ZON
  BE --> SMTP
  BE -. "telemetry" .-> UMAMI
  BE --> MAPS

  %% Jobs
  JOBS --> BE
  JOBS --> DB
  JOBS --> SMTP
```