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
@@ -80,8 +80,39 @@ Data connections support an optional backup endpoint for automatic failover when

 **Failover state machine:**

-![dcl-endpoint-redundancy](diagrams/dcl-endpoint-redundancy.png)
-<!-- source: diagrams/dcl-endpoint-redundancy.drawio — edit, then re-export with export-drawio.sh -->
+```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
+flowchart TD
+    connected(["Connected"])
+    pushbad["push bad quality"]
+    retry["retry active endpoint<br/>(5s)"]
+    decide{"N failures<br/>(≥ FailoverRetryCount)?"}
+    switch["switch to other endpoint"]
+    dispose["dispose adapter,<br/>create fresh adapter<br/>with other config"]
+    reconnect["reconnect"]
+    resub["ReSubscribeAll"]
+
+    connected -->|disconnect| pushbad
+    pushbad --> retry
+    retry --> decide
+    decide -->|"no (retry again)"| retry
+    decide -->|yes| switch
+    switch --> dispose
+    dispose --> reconnect
+    reconnect --> resub
+    resub -->|back to Connected| connected
+
+    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;
+    class connected start
+    class pushbad bad
+    class retry,reconnect,resub proc
+    class decide dec
+    class switch,dispose warn
+```

 - **Round-robin**: primary → backup → primary → backup. No preferred endpoint after first failover — the connection stays on whichever endpoint is working.
 - **No auto-failback**: The connection remains on the active endpoint until it fails.