dev day #90 🥳

diagrams/system-architecture.md

@@ -0,0 +1,56 @@
+# 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
+```