docs: render architecture & flow diagrams as draw.io charts

Replace ASCII-art diagrams across the README and docs/ with editable .drawio sources plus exported PNGs, so the diagrams render clearly in rendered markdown and can be maintained/regenerated instead of being hand-edited as fragile text art. Non-diagram blocks (code, folder trees, UI wireframes) were left as text.
2026-05-31 23:32:53 -04:00
parent 3763f6d2d8
commit bdee12f4e9
71 changed files with 2461 additions and 516 deletions
@@ -32,34 +32,8 @@ We want a strongly-typed model for OPC UA endpoint configuration, a validator th

 ## Architecture

-```
-┌──────────────────────────────────────┐
-│ ZB.MOM.WW.ScadaBridge.Commons                    │
-│  Types/DataConnections/              │
-│    OpcUaEndpointConfig.cs   (POCO)   │
-│    OpcUaHeartbeatConfig.cs  (POCO)   │
-│    OpcUaSecurityMode.cs     (enum)   │
-│  Validators/                         │
-│    OpcUaEndpointConfigValidator.cs   │
-│  Serialization/                      │
-│    OpcUaEndpointConfigSerializer.cs  │
-└──────────────────────────────────────┘
-                ▲
-                │ (referenced by both)
-        ┌───────┴────────────────────────┐
-        ▼                                ▼
-┌──────────────────────────┐   ┌────────────────────────────┐
-│ ZB.MOM.WW.ScadaBridge.CentralUI      │   │ ZB.MOM.WW.ScadaBridge.SiteRuntime      │
-│  Components/Forms/       │   │  Actors/                   │
-│   OpcUaEndpointEditor    │   │   DeploymentManagerActor   │
-│   .razor (shared)        │   │     (passes raw JSON to    │
-│                          │   │      DataConnectionFactory)│
-│  Pages/Admin/            │   │                            │
-│   DataConnectionForm     │   │ DataConnections.OpcUa/     │
-│   .razor                 │   │   OpcUaDataConnection.cs   │
-└──────────────────────────┘   │     (consumes typed model) │
-                               └────────────────────────────┘
-```
+![opcua-config-model-architecture](diagrams/opcua-config-model-architecture.png)
+<!-- source: diagrams/opcua-config-model-architecture.drawio — edit, then re-export with export-drawio.sh -->

 Both sides deserialize from `DataConnection.PrimaryConfiguration` / `BackupConfiguration` strings into the same `OpcUaEndpointConfig` instance. The DB column type does not change.