WIP: Starting to design a Software Architecture Chart

Author: raimannma

SoftwareArchitecture.md

@@ -0,0 +1,75 @@
+# Software Architecture
+
+This chart is a high-level overview of the software architecture of the project.
+
+_It is a work in progress and will be updated as the project progresses._
+
+```mermaid
+flowchart TB
+    subgraph D["Data & Analytics"]
+        S["S3-Storage"]
+        
+        DS["
+            Data Scrapers
+            Active Matches, HLTV-Stream, Metadata
+        "]
+        DS -- Match data --> S
+        DS -- Add to Validate Queue --> RMQV
+        
+        H["Housekeeper"]
+        H == SCAN for unprocessed old matches === S
+        H == Compress and Archive old matches === S
+        H -- Add to Validate Queue --> RMQV
+        
+        subgraph rmq["RabbitMQ"]
+            RMQV["RabbitMQ - Validate Queue"]
+            RMQI["RabbitMQ - Ingest Queue (Exchange)"]
+        end
+        
+        V["Validator & Parser"]
+        RMQV -- Get from Validate Queue --> V
+        S -- Match Data --> V
+        V -- Parsed Match Data --> S
+        V -- Add to Parser Queue --> RMQI
+        
+        subgraph ingest["Ingest Workers"]
+            IC["Clickhouse Ingest Worker"]
+            IP["Postgres Ingest Worker"]
+        end
+        
+        subgraph databases["Databases"]
+            DBC["Clickhouse"]
+            DBP["PostgreSQL"]
+        end
+        
+        RMQI -- Get from Ingest Queue --> IC
+        RMQI -- Get from Ingest Queue --> IP
+        S -- Parsed Match Data --> IP
+        S -- Parsed Match Data --> IC
+        IC -- Ingest Data --> DBC
+        IP -- Ingest Data --> DBP
+    end
+    
+    subgraph T["Telemetry & Metrics"]
+        %% Not designed yet
+        P["Prometheus"]
+        G["Grafana"]
+        P -- Metrics --> G
+    end
+    
+    subgraph B["Backend"]
+    %% Not designed yet
+    end
+    DBC -- Application Data --> B
+    DBP -- Application Data --> B
+
+    subgraph AP["Admin Panel"]
+    %% Not designed yet
+    end
+    B -- Application Data --> AP
+    
+    subgraph F["Public Frontend"]
+    %% Not designed yet
+    end
+    B -- Application Data --> F
+```