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
@@ -27,8 +27,57 @@ Site clusters only.

 ## Actor Hierarchy

-![siteruntime-actor-hierarchy](diagrams/siteruntime-actor-hierarchy.png)
-<!-- source: diagrams/siteruntime-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)"]
+    IA1["Instance Actor<br/>('MachineA-001')"]
+    IA2["Instance Actor<br/>('MachineA-002')"]
+    IAMORE["… more Instance Actors"]
+
+    SA1["Script Actor ('MonitorSpeed')<br/>— coordinator"]
+    SA2["Script Actor ('CalculateOEE')<br/>— coordinator"]
+    AA1["Alarm Actor ('OverTemp')<br/>— coordinator (computed)"]
+    AA2["Alarm Actor ('LowPressure')<br/>— coordinator (computed)"]
+    NAA1["Native Alarm Actor ('OpcUaServer1')<br/>— read-only mirror, peer to Alarm Actor"]
+
+    SEA1["Script Execution Actor<br/>— short-lived, per invocation"]
+    SEA2["Script Execution Actor<br/>— short-lived, per invocation"]
+    AEA1["Alarm Execution Actor<br/>— short-lived, per on-trigger invocation"]
+
+    IA2CHILD["… (Script / Alarm Actors)"]
+
+    DMS --> IA1
+    DMS --> IA2
+    DMS -.-> IAMORE
+
+    IA1 --> SA1
+    IA1 --> SA2
+    IA1 --> AA1
+    IA1 --> AA2
+    IA1 --> NAA1
+
+    SA1 --> SEA1
+    SA2 --> SEA2
+    AA1 --> AEA1
+
+    IA2 -.-> IA2CHILD
+
+    classDef start fill:#d5e8d4,stroke:#82b366,color:#111111;
+    classDef proc fill:#dae8fc,stroke:#6c8ebf,color:#111111;
+    classDef dec fill:#fff2cc,stroke:#d6b656,color:#111111;
+    classDef warn fill:#ffe6cc,stroke:#d79b00,color:#111111;
+    classDef bad fill:#f8cecc,stroke:#b85450,color:#111111;
+    classDef alt fill:#e1d5e7,stroke:#9673a6,color:#111111;
+    classDef muted fill:#f5f5f5,stroke:#999999,color:#666666;
+    class DMS proc
+    class IA1,IA2 start
+    class SA1,SA2 dec
+    class AA1,AA2 bad
+    class NAA1 alt
+    class SEA1,SEA2,AEA1 warn
+    class IAMORE,IA2CHILD muted
+```

 ---