docs: add architecture diagrams

Author: markus-wa

docs/out/parallel-processing/parallel-processing.png

@@ -0,0 +1,30 @@
+@startuml
+participant Consumer
+participant Parser
+participant Queue
+
+Consumer ++
+Consumer -> Parser ++: ParseToEnd
+par
+    loop parsing loop
+        Parser -> Parser ++: parseFrame
+        Parser -> Queue ++: enqueue net-msg
+        Parser --
+    end
+    Parser --
+
+    else
+
+    loop processing loop
+        Queue --> Parser --: receive net-msg
+        Parser ++
+        Parser -> Parser ++: process
+        Parser -> Consumer ++: call EventHandler
+        Consumer --> Parser --
+        Parser --
+    end
+end
+Parser -> Consumer --
+Consumer --
+
+@enduml

docs/out/parsing-loop/parsing-loop.png

@@ -0,0 +1,27 @@
+@startuml
+participant Consumer
+participant Parser
+participant BitReader
+participant Message
+participant Queue
+
+Consumer -> Parser ++: ParseToEnd
+
+loop while more messages to read
+    Parser -> Parser ++: parseFrame
+    
+    Parser -> BitReader ++: read
+    BitReader --> Parser --
+
+    Parser -> Message ++: decode
+    Message --> Parser --
+
+    Parser -> Queue: enqueue net-msg
+    Parser --
+end
+
+Parser -> Parser: wait for processing loop
+
+Parser --> Consumer --
+
+@enduml

docs/out/processing-loop/processing-loop.png

@@ -0,0 +1,31 @@
+@startuml
+participant Consumer
+participant Queue
+participant NetMessageDispatcher
+participant Parser
+participant GameState
+participant EventDispatcher
+participant Consumer
+
+loop while messages in queue
+    Queue -> NetMessageDispatcher ++: receive net-msg
+
+    NetMessageDispatcher -> Parser ++: handle
+
+    Parser -> GameState ++: update
+    GameState --> Parser --
+
+    Parser -> EventDispatcher ++: dispatch
+    EventDispatcher -> Consumer ++: handle
+    Consumer --> EventDispatcher --
+    EventDispatcher --> Parser --
+
+    Parser --> NetMessageDispatcher --
+
+    NetMessageDispatcher -> Consumer ++: handle
+    Consumer --> NetMessageDispatcher --
+
+    NetMessageDispatcher --
+end
+
+@enduml