docs: convert standard diagrams from draw.io PNGs to inline Mermaid

Gitea renders mermaid inline, so the flow/state/hierarchy/DAG diagrams move to text-in-markdown: auto-layout (removes the manual overlap-prone draw.io step), diffable source, no committed binaries, and a dark-text theme so labels stay legible. Keep draw.io PNGs only for the two complex bespoke diagrams (logical architecture, env2 topology) where pixel control still wins. All 24 mermaid blocks validated by rendering.
2026-06-01 00:23:00 -04:00
parent e3ca5ac0cf
commit 43228185b4
65 changed files with 848 additions and 2145 deletions
@@ -115,5 +115,47 @@ Both stacks share the infrastructure services in [`infra/`](infra/) (MS SQL, LDA

 ### Site Runtime Actor Hierarchy

-![Site runtime actor hierarchy](diagrams/site-runtime-actor-hierarchy.png)
-<!-- source: diagrams/site-runtime-actor-hierarchy.drawio — edit, then re-export with export-drawio.sh -->
+```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
+flowchart TD
+    DMS["Deployment Manager Singleton<br/>(Cluster Singleton)"]
+    IA["Instance Actor<br/>(one per deployed, enabled instance)"]
+    IA2["Instance Actor<br/>( … )"]
+    MOREIA["… more Instance Actors"]
+    DMS --> IA
+    DMS --> IA2
+    DMS -.-> MOREIA
+
+    SA["Script Actor<br/>(coordinator, one per instance script)"]
+    AA["Alarm Actor<br/>(coordinator, one per alarm definition)"]
+    MORE1["… more Script /<br/>Alarm Actors"]
+    IA --> SA
+    IA --> AA
+    IA -.-> MORE1
+
+    SEA["Script Execution Actor<br/>(short-lived, per invocation)"]
+    AEA["Alarm Execution Actor<br/>(short-lived, per on-trigger invocation)"]
+    IA2C["… (Script / Alarm Actors)"]
+    SA --> SEA
+    AA --> AEA
+    IA2 -.-> IA2C
+
+    subgraph STREAM["Site-Wide Akka Stream"]
+        PUB["All Instance Actors"]
+        STR["Site-Wide Akka Stream<br/>(attribute + alarm state changes)"]
+        DBG["Debug view<br/>(instance-level filtering)"]
+        PUB -->|publish| STR
+        STR -->|subscribe filtered| DBG
+    end
+
+    classDef start fill:#d5e8d4,stroke:#82b366,color:#111111;
+    classDef proc fill:#dae8fc,stroke:#6c8ebf,color:#111111;
+    classDef warn fill:#ffe6cc,stroke:#d79b00,color:#111111;
+    classDef alt fill:#e1d5e7,stroke:#9673a6,color:#111111;
+    classDef muted fill:#f5f5f5,stroke:#999999,color:#666666;
+    class DMS,STR alt
+    class IA,IA2,PUB proc
+    class SA,AA,DBG start
+    class SEA,AEA warn
+    class MOREIA,MORE1,IA2C muted
+```