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.
This commit is contained in:
Joseph Doherty
@@ -39,8 +39,43 @@ Both endpoints use the same `Protocol`. EF Core migration renames `Configuration
|
||||
|
||||
The `DataConnectionActor` Reconnecting state is extended:
|
||||
|
||||
|
||||
<!-- source: diagrams/primary-backup-failover-state-machine.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
C(["Connected"])
|
||||
BQ["Push bad quality<br/>to all subscribers"]
|
||||
RT["Retry active endpoint<br/>(5s interval)"]
|
||||
INC["_consecutiveFailures++"]
|
||||
BR{"Evaluate<br/>_consecutiveFailures"}
|
||||
SAME["Retry same endpoint"]
|
||||
FO["Failover<br/>- dispose adapter, switch _activeEndpoint, reset counter<br/>- create fresh adapter with other config<br/>- attempt connect"]
|
||||
NB["Keep retrying indefinitely<br/>(current behavior)"]
|
||||
RC(["On successful reconnect (either endpoint)<br/>1. Reset _consecutiveFailures = 0<br/>2. ReSubscribeAll() — re-create subscriptions on new adapter<br/>3. Transition to Connected<br/>4. Log failover event if endpoint changed<br/>5. Report active endpoint in health metrics"])
|
||||
|
||||
C -->|"disconnect detected"| BQ
|
||||
BQ --> RT
|
||||
RT -->|"failure"| INC
|
||||
INC --> BR
|
||||
BR -->|"< FailoverRetryCount"| SAME
|
||||
SAME -.->|"retry"| RT
|
||||
BR -->|">= FailoverRetryCount AND backup exists"| FO
|
||||
BR -->|">= FailoverRetryCount AND no backup"| NB
|
||||
NB -.->|"retry (round-robin n/a)"| RT
|
||||
FO -->|"connect succeeds"| RC
|
||||
FO -.->|"connect fails (round-robin: primary to backup to primary...)"| RT
|
||||
RC -->|"Transition to Connected"| C
|
||||
|
||||
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 C,RC start
|
||||
class BQ,RT,SAME proc
|
||||
class INC,BR dec
|
||||
class FO warn
|
||||
class NB bad
|
||||
```
|
||||
|
||||
**On successful reconnect (either endpoint):**
|
||||
1. Reset `_consecutiveFailures = 0`
|
||||
|
||||
@@ -32,8 +32,46 @@ We want a strongly-typed model for OPC UA endpoint configuration, a validator th
|
||||
|
||||
## Architecture
|
||||
|
||||
|
||||
<!-- source: diagrams/opcua-config-model-architecture.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
subgraph COMMONS["ZB.MOM.WW.ScadaBridge.Commons"]
|
||||
TYPES["Types/DataConnections/<br/>OpcUaEndpointConfig.cs (POCO)<br/>OpcUaHeartbeatConfig.cs (POCO)<br/>OpcUaSecurityMode.cs (enum)"]
|
||||
VALID["Validators/<br/>OpcUaEndpointConfigValidator.cs"]
|
||||
SER["Serialization/<br/>OpcUaEndpointConfigSerializer.cs"]
|
||||
TYPES ~~~ VALID ~~~ SER
|
||||
end
|
||||
|
||||
subgraph CENTRALUI["ZB.MOM.WW.ScadaBridge.CentralUI"]
|
||||
CUIFORMS["Components/Forms/<br/>OpcUaEndpointEditor.razor (shared)"]
|
||||
CUIPAGES["Pages/Admin/<br/>DataConnectionForm.razor"]
|
||||
CUIFORMS ~~~ CUIPAGES
|
||||
end
|
||||
|
||||
subgraph SITERUNTIME["ZB.MOM.WW.ScadaBridge.SiteRuntime"]
|
||||
SRACTORS["Actors/<br/>DeploymentManagerActor<br/>(passes raw JSON to DataConnectionFactory)"]
|
||||
SRDC["DataConnections.OpcUa/<br/>OpcUaDataConnection.cs<br/>(consumes typed model)"]
|
||||
SRACTORS ~~~ SRDC
|
||||
end
|
||||
|
||||
COMMONS -->|referenced by| CENTRALUI
|
||||
COMMONS -->|referenced by| SITERUNTIME
|
||||
|
||||
NOTE["Both sides deserialize DataConnection.PrimaryConfiguration / BackupConfiguration<br/>into the same OpcUaEndpointConfig instance. The DB column type does not change."]
|
||||
CENTRALUI -.- NOTE
|
||||
SITERUNTIME -.- NOTE
|
||||
|
||||
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 muted fill:#f5f5f5,stroke:#999999,color:#666666;
|
||||
class COMMONS dec
|
||||
class TYPES,VALID,SER warn
|
||||
class CENTRALUI,CUIFORMS,CUIPAGES proc
|
||||
class SITERUNTIME,SRACTORS,SRDC start
|
||||
class NOTE muted
|
||||
```
|
||||
|
||||
Both sides deserialize from `DataConnection.PrimaryConfiguration` / `BackupConfiguration` strings into the same `OpcUaEndpointConfig` instance. The DB column type does not change.
|
||||
|
||||
|
||||
@@ -14,8 +14,44 @@
|
||||
|
||||
## Task Dependency Graph
|
||||
|
||||
|
||||
<!-- source: diagrams/env2-task-dependency-graph.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart LR
|
||||
GRP["all independent, all parallelizable, all ready from the start"]
|
||||
T0["T0"]
|
||||
T1["T1"]
|
||||
T2["T2"]
|
||||
T3["T3"]
|
||||
T4["T4"]
|
||||
T6["T6"]
|
||||
T7["T7"]
|
||||
T8["T8"]
|
||||
T9["T9"]
|
||||
T5["T5<br/>lifecycle scripts"]
|
||||
T10(["T10<br/>manual smoke test"])
|
||||
NOTE["T10 is the only task that requires all of T0–T9 done. Everything else runs in parallel."]
|
||||
|
||||
T0 --> T10
|
||||
T1 --> T10
|
||||
T2 --> T10
|
||||
T3 --> T10
|
||||
T6 --> T10
|
||||
T7 --> T10
|
||||
T8 --> T10
|
||||
T9 --> T10
|
||||
T0 --> T5
|
||||
T4 --> T5
|
||||
T5 --> T10
|
||||
|
||||
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 muted fill:#f5f5f5,stroke:#999999,color:#666666;
|
||||
class T0,T1,T2,T3,T4,T6,T7,T8,T9 proc
|
||||
class T5 warn
|
||||
class T10 start
|
||||
class GRP,NOTE muted
|
||||
```
|
||||
|
||||
T10 is the only task that requires all of T0–T9 done. Everything else can run in parallel.
|
||||
|
||||
|
||||
@@ -18,8 +18,33 @@
|
||||
|
||||
## Section 1 — Architecture
|
||||
|
||||
|
||||
<!-- source: diagrams/opcua-tag-browser-architecture.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
N1["Blazor Server browser"]
|
||||
N2["CentralUI: InstanceConfigure.razor"]
|
||||
N3["CentralUI: OpcUaBrowserDialog component"]
|
||||
N4["CentralUI: IOpcUaBrowseService"]
|
||||
N5["CommunicationService.SendCommandToSiteAsync of BrowseOpcUaNodeResult (siteId, BrowseOpcUaNodeCommand)"]
|
||||
N6["Site: CentralCommunicationActor → DataConnectionManagerActor"]
|
||||
N7["OPC UA server"]
|
||||
|
||||
N1 -->|SignalR| N2
|
||||
N2 -->|opens| N3
|
||||
N3 -->|uses| N4
|
||||
N4 -->|implementation calls| N5
|
||||
N5 -->|"ClusterClient Ask<br/>ManagementEnvelope { User, Command, CorrelationId }"| N6
|
||||
N6 -->|"dispatches to IBrowsableDataConnection (RealOpcUaClient)<br/>OPC Foundation .NET SDK Browse service"| N7
|
||||
|
||||
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;
|
||||
class N1,N2,N3,N4 proc
|
||||
class N5 alt
|
||||
class N6 start
|
||||
class N7 warn
|
||||
```
|
||||
|
||||
Three slices, top-to-bottom:
|
||||
1. **Data model.** Add a per-instance OPC UA address override (new column on `InstanceConnectionBinding`).
|
||||
@@ -145,8 +170,48 @@ Returning failure inside `BrowseOpcUaNodeResult` (rather than exceptions across
|
||||
|
||||
**Wire flow.**
|
||||
|
||||
|
||||
<!-- source: diagrams/opcua-tag-browser-command-flow.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
S1["CentralUI.OpcUaBrowseService.BrowseChildrenAsync(siteId, connId, parent)"]
|
||||
S2["CommunicationService.SendCommandToSiteAsync of BrowseOpcUaNodeResult (siteId, new BrowseOpcUaNodeCommand(connId, parent))"]
|
||||
S3["ManagementEnvelope { User, Command, CorrelationId }<br/>over ClusterClient"]
|
||||
S4["Site: CentralCommunicationActor unwraps envelope"]
|
||||
S5["Site: DataConnectionManagerActor receives BrowseOpcUaNodeCommand<br/>(DCL coordinator actor — owns the per-connection IDataConnection instances)"]
|
||||
|
||||
S1 --> S2 --> S3 --> S4 --> S5
|
||||
|
||||
subgraph HANDLER["Handler logic"]
|
||||
direction TB
|
||||
HL["Look up IDataConnection by Id"]
|
||||
HNF["if not found → ConnectionNotFound"]
|
||||
HNB["if not (conn is IBrowsableDataConnection) → NotBrowsable"]
|
||||
HAW["else await conn.BrowseChildrenAsync(ParentNodeId, ct)"]
|
||||
HNC["Catch ConnectionNotConnectedException → ConnectionNotConnected"]
|
||||
HCN["Catch OperationCanceledException → Timeout"]
|
||||
HSVC["Catch ServiceResultException → ServerError + verbatim msg"]
|
||||
HSUC["Else success: BrowseOpcUaNodeResult(children, truncated, null)"]
|
||||
HL --- HNF --- HNB --- HAW --- HNC --- HCN --- HSVC --- HSUC
|
||||
end
|
||||
|
||||
S5 -->|processes| HANDLER
|
||||
|
||||
R1["Reply travels back via<br/>CentralCommunicationActor → CommunicationService"]
|
||||
R2["returned to CentralUI page"]
|
||||
HANDLER -->|result / failure| R1
|
||||
R1 --> R2
|
||||
|
||||
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 bad fill:#f8cecc,stroke:#b85450,color:#111111;
|
||||
classDef alt fill:#e1d5e7,stroke:#9673a6,color:#111111;
|
||||
class S1,R1,R2 proc
|
||||
class S2,S3 alt
|
||||
class S4,S5,HSUC start
|
||||
class HANDLER,HL,HAW dec
|
||||
class HNF,HNB,HNC,HCN,HSVC bad
|
||||
```
|
||||
|
||||
Handler lives in the **DCL coordinator actor** (the same actor that owns the per-connection `IDataConnection` instances) — keeps lifecycle and browse co-located so we don't race against reconnect.
|
||||
|
||||
|
||||
@@ -16,8 +16,87 @@
|
||||
|
||||
## Task dependency overview
|
||||
|
||||
|
||||
<!-- source: diagrams/native-alarms-task-dependency.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart LR
|
||||
T1["T1"]
|
||||
T3["T3"]
|
||||
T2["T2"]
|
||||
T10["T10<br/>DCL actor"]
|
||||
T11["T11<br/>OPC UA adapter"]
|
||||
T12["T12<br/>MxGateway adapter"]
|
||||
T17["T17<br/>computed AlarmActor enrich"]
|
||||
T18["T18<br/>proto"]
|
||||
T19["T19<br/>grpc mapping"]
|
||||
T23["T23<br/>DebugView"]
|
||||
|
||||
T4["T4"]
|
||||
T5["T5"]
|
||||
T6["T6"]
|
||||
T7["T7<br/>migration"]
|
||||
T8["T8"]
|
||||
T9["T9<br/>validation"]
|
||||
T20["T20"]
|
||||
T21["T21<br/>mgmt handlers"]
|
||||
T26["T26<br/>seed"]
|
||||
T22["T22<br/>CLI"]
|
||||
T24["T24<br/>template UI"]
|
||||
T25["T25<br/>instance UI"]
|
||||
|
||||
T13["T13"]
|
||||
T14["T14"]
|
||||
T15["T15<br/>NativeAlarmActor"]
|
||||
T16["T16<br/>InstanceActor wiring"]
|
||||
|
||||
T15IN["inputs to T15:<br/>T1, T2, T3, T4 (Resolved), T13, T14"]
|
||||
T27["T27<br/>docs"]
|
||||
T28["T28<br/>integration / manual verify"]
|
||||
EVT["(everything) emits to T27 and T28"]
|
||||
|
||||
T1 --> T2
|
||||
T1 --> T10
|
||||
T1 --> T11
|
||||
T1 --> T12
|
||||
T3 --> T2
|
||||
T3 --> T10
|
||||
T3 --> T11
|
||||
T3 --> T12
|
||||
|
||||
T2 --> T17
|
||||
T2 --> T18
|
||||
T18 --> T19
|
||||
T19 --> T23
|
||||
|
||||
T4 --> T5
|
||||
T4 --> T7
|
||||
T4 --> T8
|
||||
T4 --> T20
|
||||
T5 --> T6
|
||||
T6 --> T21
|
||||
T8 --> T9
|
||||
T20 --> T21
|
||||
T20 --> T22
|
||||
T20 --> T24
|
||||
T20 --> T25
|
||||
T21 --> T26
|
||||
|
||||
T13 --> T15
|
||||
T14 --> T15
|
||||
T15 --> T16
|
||||
|
||||
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 alt fill:#e1d5e7,stroke:#9673a6,color:#111111;
|
||||
classDef muted fill:#f5f5f5,stroke:#999999,color:#666666;
|
||||
class T1,T2,T3,T10,T11,T12 proc
|
||||
class T17,T18,T19,T23 alt
|
||||
class T4,T5,T6,T7,T8,T9,T20,T21,T22,T24,T25,T26 start
|
||||
class T13,T14 dec
|
||||
class T15,T16 warn
|
||||
class T27,T28,T15IN,EVT muted
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,98 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="env2dag" name="Env2 Task Dependency Graph">
|
||||
<mxGraphModel dx="1200" dy="900" grid="1" gridSize="10" guides="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1000" pageHeight="800" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- Independent / parallelizable group label -->
|
||||
<mxCell id="grpLabel" value="all independent, all parallelizable, all ready from the start" style="text;html=1;align=center;verticalAlign=middle;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="40" y="30" width="300" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Independent task nodes (T0..T9 minus T5) -->
|
||||
<mxCell id="t0" value="T0" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="80" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t1" value="T1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="130" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t2" value="T2" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="180" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t3" value="T3" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="230" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t4" value="T4" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="280" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t6" value="T6" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="330" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t7" value="T7" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="380" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t8" value="T8" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="430" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t9" value="T9" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="480" width="80" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T5: lifecycle scripts (fed by T0 and T4) -->
|
||||
<mxCell id="t5" value="T5 lifecycle scripts" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="440" y="430" width="160" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T10: manual smoke test -->
|
||||
<mxCell id="t10" value="T10 manual smoke test" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="780" y="255" width="160" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Edges: each independent task -> T10 -->
|
||||
<mxCell id="e0" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t0" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t1" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t2" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t3" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t6" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t7" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e8" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t8" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e9" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;exitX=1;exitY=0.5;exitDx=0;exitDy=0;" edge="1" parent="1" source="t9" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T0,T4 -> T5 -->
|
||||
<mxCell id="e05" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#d79b00;" edge="1" parent="1" source="t0" target="t5">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e45" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#d79b00;" edge="1" parent="1" source="t4" target="t5">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T5 -> T10 -->
|
||||
<mxCell id="e510" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#d79b00;" edge="1" parent="1" source="t5" target="t10">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Note -->
|
||||
<mxCell id="note" value="T10 is the only task that requires all of T0–T9 done. Everything else runs in parallel." style="text;html=1;align=left;verticalAlign=middle;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="640" y="360" width="320" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 102 KiB |
@@ -1,41 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="perwp" name="Per-Work-Package Execution">
|
||||
<mxGraphModel dx="900" dy="1100" grid="1" gridSize="10" guides="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="700" pageHeight="1200" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<mxCell id="s1" value="1. READ the WP description and acceptance criteria" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;align=left;spacingLeft=12;verticalAlign=middle;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="40" width="380" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="s2" value="2. READ all traced requirements (HLR bullets, KDD, CD constraints) to understand intent" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;align=left;spacingLeft=12;verticalAlign=middle;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="130" width="380" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="s3" value="3. IMPLEMENT the WP • Write code • Write unit tests for acceptance criteria • Write negative tests for prohibition criteria" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;align=left;spacingLeft=12;verticalAlign=middle;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="230" width="380" height="100" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="s4" value="4. VERIFY acceptance criteria • Run tests: all must pass • Walk each acceptance criterion line by line • If a criterion cannot be verified yet (depends on a later WP), note it as "deferred to WP-N"" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;align=left;spacingLeft=12;verticalAlign=middle;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="370" width="380" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="s5" value="5. UPDATE the phase execution checklist • Mark WP as complete with date • Note any deferred criteria • Note any questions logged" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;align=left;spacingLeft=12;verticalAlign=middle;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="530" width="380" height="100" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="s6" value="6. COMMIT with message: "Phase N WP-M: <summary>"" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;align=left;spacingLeft=12;verticalAlign=middle;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="670" width="380" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Edges -->
|
||||
<mxCell id="e12" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;" edge="1" parent="1" source="s1" target="s2"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e23" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;" edge="1" parent="1" source="s2" target="s3"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e34" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;" edge="1" parent="1" source="s3" target="s4"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e45" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;" edge="1" parent="1" source="s4" target="s5"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e56" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;" edge="1" parent="1" source="s5" target="s6"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 257 KiB |
@@ -1,41 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="channelbridge" name="Channel Bridging">
|
||||
<mxGraphModel dx="1000" dy="700" grid="1" gridSize="10" guides="1" arrows="1"
|
||||
fold="1" page="1" pageScale="1" pageWidth="900" pageHeight="640" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- Producer side: Akka Actor Thread(s) -->
|
||||
<mxCell id="akka" value="Akka Actor Thread(s)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="60" width="240" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Consumer side: gRPC Response Stream -->
|
||||
<mxCell id="grpc" value="gRPC Response Stream" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="560" y="60" width="240" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Channel box -->
|
||||
<mxCell id="channel" value="Channel<SiteStreamEvent> BoundedChannelOptions(1000) FullMode = DropOldest" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=13;fontStyle=1;verticalAlign=middle;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="280" width="400" height="120" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Producer writes into channel -->
|
||||
<mxCell id="write" value="channel.Writer.TryWrite(evt)" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;fontSize=12;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.25;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="akka" target="channel">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Channel read out to gRPC stream -->
|
||||
<mxCell id="read" value="await responseStream.WriteAsync(evt)" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;fontSize=12;exitX=0.75;exitY=0;exitDx=0;exitDy=0;entryX=0.5;entryY=1;entryDx=0;entryDy=0;" edge="1" parent="1" source="channel" target="grpc">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Notes -->
|
||||
<mxCell id="note" value="• Bounded capacity (1000): prevents unbounded memory growth if the gRPC client is slow • DropOldest: matches the existing SiteStreamManager overflow strategy • ReadAllAsync: yields items as they arrive, naturally async" style="text;html=1;align=left;verticalAlign=middle;fontSize=11;fontColor=#666666;spacingLeft=4;" vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="450" width="720" height="80" as="geometry" />
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 133 KiB |
@@ -1,83 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="statemachine" name="Reconnection State Machine">
|
||||
<mxGraphModel dx="1000" dy="800" grid="1" gridSize="10" guides="1" arrows="1"
|
||||
fold="1" page="1" pageScale="1" pageWidth="900" pageHeight="820" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- Streaming state -->
|
||||
<mxCell id="streaming" value="Streaming" style="rounded=1;arcSize=30;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="360" y="60" width="180" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="streamingNote" value="Normal state: gRPC stream active" style="text;html=1;align=left;verticalAlign=middle;fontSize=11;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="560" y="70" width="170" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Reconnecting state -->
|
||||
<mxCell id="reconnecting" value="Reconnecting" style="rounded=1;arcSize=30;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="360" y="240" width="180" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="reconnectingNote" value="try other node endpoint" style="text;html=1;align=left;verticalAlign=middle;fontSize=11;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="560" y="250" width="170" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Decision diamond -->
|
||||
<mxCell id="decide" value="reconnect result?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="380" y="400" width="140" height="90" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Schedule retry box -->
|
||||
<mxCell id="retry" value="schedule retry (5s backoff)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="100" y="410" width="170" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Terminated state -->
|
||||
<mxCell id="terminated" value="Terminated" style="rounded=1;arcSize=30;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=14;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="360" y="620" width="180" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="terminatedNote" value="notify consumer, stop actor" style="text;html=1;align=left;verticalAlign=middle;fontSize=11;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="560" y="630" width="170" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Transitions -->
|
||||
<mxCell id="t_stream_recon" value="gRPC stream error / keepalive timeout" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;fontSize=11;" edge="1" parent="1" source="streaming" target="reconnecting">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="t_recon_decide" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;" edge="1" parent="1" source="reconnecting" target="decide">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- success -> Streaming -->
|
||||
<mxCell id="t_success" value="success" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;fontSize=11;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="decide" target="streaming">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="700" y="445" />
|
||||
<mxPoint x="700" y="90" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
<!-- failure (retry < max) -> schedule retry -->
|
||||
<mxCell id="t_retry" value="failure (retry < max)" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;fontSize=11;exitX=0;exitY=0.5;exitDx=0;exitDy=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="decide" target="retry">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- schedule retry -> Reconnecting (loop back) -->
|
||||
<mxCell id="t_loop" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="retry" target="reconnecting">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="185" y="270" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
<!-- failure (retry >= max) -> Terminated -->
|
||||
<mxCell id="t_term" value="failure (retry >= max)" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;fontSize=11;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="decide" target="terminated">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 134 KiB |
@@ -1,102 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="grpcarch" name="gRPC Streams Architecture">
|
||||
<mxGraphModel dx="1200" dy="900" grid="1" gridSize="10" guides="1" arrows="1"
|
||||
fold="1" page="1" pageScale="1" pageWidth="1100" pageHeight="1000" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- Column headers -->
|
||||
<mxCell id="hdrCentral" value="Central Cluster" style="text;html=1;align=center;verticalAlign=middle;fontSize=16;fontStyle=1;fontColor=#333333;" vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="30" width="280" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="hdrSite" value="Site Cluster" style="text;html=1;align=center;verticalAlign=middle;fontSize=16;fontStyle=1;fontColor=#333333;" vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="30" width="280" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="ruleC" value="" style="line;strokeWidth=2;html=1;strokeColor=#6c8ebf;" vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="60" width="280" height="10" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="ruleS" value="" style="line;strokeWidth=2;html=1;strokeColor=#d79b00;" vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="60" width="280" height="10" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- CENTRAL column -->
|
||||
<mxCell id="bridgeTop" value="DebugStreamBridgeActor" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="110" width="280" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- SITE column -->
|
||||
<mxCell id="instance" value="InstanceActor" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="110" width="280" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- ClusterClient command/control between bridge and instance -->
|
||||
<mxCell id="ccSub" value="SubscribeDebugView ►" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;dashed=1;fontSize=11;exitX=1;exitY=0.3;exitDx=0;exitDy=0;entryX=0;entryY=0.3;entryDx=0;entryDy=0;verticalAlign=bottom;labelBackgroundColor=#ffffff;" edge="1" parent="1" source="bridgeTop" target="instance">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="0" y="-8" as="offset" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="ccSnap" value="◄ DebugViewSnapshot" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;dashed=1;fontSize=11;exitX=0;exitY=0.7;exitDx=0;exitDy=0;entryX=1;entryY=0.7;entryDx=0;entryDy=0;verticalAlign=top;labelBackgroundColor=#ffffff;" edge="1" parent="1" source="instance" target="bridgeTop">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="0" y="8" as="offset" />
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="ccLabel" value="ClusterClient: command / control" style="text;html=1;align=center;verticalAlign=middle;fontSize=10;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="455" y="178" width="170" height="34" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Instance publishes -->
|
||||
<mxCell id="publishes" value="publishes AttributeValueChanged AlarmStateChanged" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="220" width="280" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="instPub" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;" edge="1" parent="1" source="instance" target="publishes">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- gRPC server (site) -->
|
||||
<mxCell id="grpcServer" value="SiteStreamGrpcServer (Kestrel, on site)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="340" width="280" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="pub2srv" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;" edge="1" parent="1" source="publishes" target="grpcServer">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="srvNote1" value="receives from SiteStreamManager" style="text;html=1;align=left;verticalAlign=middle;fontSize=10;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="970" y="345" width="120" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="srvNote2" value="filters by instance name" style="text;html=1;align=left;verticalAlign=middle;fontSize=10;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="970" y="375" width="120" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- gRPC client (central) -->
|
||||
<mxCell id="grpcClient" value="SiteStreamGrpcClient (per-site, on central)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="340" width="280" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- gRPC stream: server -> client -->
|
||||
<mxCell id="grpcStream" value="gRPC stream (HTTP/2)" style="edgeStyle=none;html=1;endArrow=block;rounded=0;strokeWidth=2;strokeColor=#82b366;fontSize=12;fontStyle=1;exitX=0;exitY=0.5;exitDx=0;exitDy=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="grpcServer" target="grpcClient">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="cliNote" value="reads from gRPC stream routes by correlationId" style="text;html=1;align=center;verticalAlign=middle;fontSize=10;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="410" width="280" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- bridge (central, lower) -->
|
||||
<mxCell id="bridgeBottom" value="DebugStreamBridgeActor" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="460" width="280" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="cli2bridge" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;" edge="1" parent="1" source="grpcClient" target="bridgeBottom">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- SignalR / Blazor -->
|
||||
<mxCell id="signalr" value="SignalR Hub / Blazor UI" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=13;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="560" width="280" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="bridge2signalr" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;rounded=0;" edge="1" parent="1" source="bridgeBottom" target="signalr">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 216 KiB |
@@ -1,158 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="nadag" name="Native Alarms Task Dependency">
|
||||
<mxGraphModel dx="1600" dy="1100" grid="1" gridSize="10" guides="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1200" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- ============ Block 1: T1/T3 sources ============ -->
|
||||
<mxCell id="t1" value="T1" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="40" y="60" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t3" value="T3" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="40" y="200" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T2 and the DCL/adapter fan-out from T1+T3 -->
|
||||
<mxCell id="t2" value="T2" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="60" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t10" value="T10 DCL actor" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="180" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t11" value="T11 OPC UA adapter" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="240" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t12" value="T12 MxGateway adapter" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="300" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T2 fan-out: T17, T18->T19->T23 -->
|
||||
<mxCell id="t17" value="T17 computed AlarmActor enrich" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;" vertex="1" parent="1">
|
||||
<mxGeometry x="460" y="20" width="180" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t18" value="T18 proto" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;" vertex="1" parent="1">
|
||||
<mxGeometry x="460" y="100" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t19" value="T19 grpc mapping" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;" vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="100" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t23" value="T23 DebugView" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;" vertex="1" parent="1">
|
||||
<mxGeometry x="900" y="100" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- ============ Block 2: T4 source ============ -->
|
||||
<mxCell id="t4" value="T4" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="40" y="500" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T4 fan-out -->
|
||||
<mxCell id="t5" value="T5" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="420" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t6" value="T6" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="400" y="420" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t7" value="T7 migration" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="480" width="120" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t8" value="T8" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="540" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t9" value="T9 validation" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
||||
<mxGeometry x="400" y="540" width="120" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t20" value="T20" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="640" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T21: fed by both T6 and T20 -->
|
||||
<mxCell id="t21" value="T21 mgmt handlers" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
||||
<mxGeometry x="600" y="480" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t26" value="T26 seed" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
||||
<mxGeometry x="820" y="480" width="120" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- T20 fan-out (others) -->
|
||||
<mxCell id="t22" value="T22 CLI" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
||||
<mxGeometry x="460" y="620" width="120" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t24" value="T24 template UI" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
||||
<mxGeometry x="460" y="680" width="120" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t25" value="T25 instance UI" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
||||
<mxGeometry x="460" y="740" width="120" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- ============ Block 3: T13/T14 -> T15 -> T16 ============ -->
|
||||
<mxCell id="t13" value="T13" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="40" y="860" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t14" value="T14" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="40" y="920" width="90" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t15" value="T15 NativeAlarmActor" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontStyle=1;" vertex="1" parent="1">
|
||||
<mxGeometry x="600" y="880" width="160" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t16" value="T16 InstanceActor wiring" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;" vertex="1" parent="1">
|
||||
<mxGeometry x="820" y="880" width="160" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t15in" value="inputs to T15: T1, T2, T3, T4 (Resolved), T13, T14" style="text;html=1;align=left;verticalAlign=middle;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="880" width="380" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- ============ Block 4: everything -> T27, T28 ============ -->
|
||||
<mxCell id="t27" value="T27 docs" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="1060" y="980" width="140" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="t28" value="T28 integration / manual verify" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="1060" y="1040" width="200" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="evt" value="(everything) ──►" style="text;html=1;align=right;verticalAlign=middle;fontStyle=2;fontColor=#666666;" vertex="1" parent="1">
|
||||
<mxGeometry x="880" y="990" width="170" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- ============ Edges ============ -->
|
||||
<!-- T1 + T3 -> T2, T10, T11, T12 -->
|
||||
<mxCell id="b1t2a" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t1" target="t2"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="b1t10a" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t1" target="t10"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="b1t11a" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t1" target="t11"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="b1t12a" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t1" target="t12"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="b1t2b" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t3" target="t2"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="b1t10b" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t3" target="t10"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="b1t11b" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t3" target="t11"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="b1t12b" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#6c8ebf;" edge="1" parent="1" source="t3" target="t12"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
|
||||
<!-- T2 -> T17, T18; T18 -> T19 -> T23 -->
|
||||
<mxCell id="e_t2_17" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#9673a6;" edge="1" parent="1" source="t2" target="t17"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_t2_18" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#9673a6;" edge="1" parent="1" source="t2" target="t18"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_18_19" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#9673a6;" edge="1" parent="1" source="t18" target="t19"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_19_23" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#9673a6;" edge="1" parent="1" source="t19" target="t23"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
|
||||
<!-- T4 -> T5, T7, T8, T20 -->
|
||||
<mxCell id="e_4_5" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t4" target="t5"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_4_7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t4" target="t7"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_4_8" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t4" target="t8"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_4_20" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t4" target="t20"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
|
||||
<!-- T5 -> T6 -> T21; T8 -> T9 -->
|
||||
<mxCell id="e_5_6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t5" target="t6"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_6_21" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t6" target="t21"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_8_9" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t8" target="t9"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
|
||||
<!-- T20 -> T21, T22, T24, T25; T21 -> T26 -->
|
||||
<mxCell id="e_20_21" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t20" target="t21"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_20_22" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t20" target="t22"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_20_24" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t20" target="t24"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_20_25" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t20" target="t25"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_21_26" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#82b366;" edge="1" parent="1" source="t21" target="t26"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
|
||||
<!-- T13, T14 -> T15 -> T16 -->
|
||||
<mxCell id="e_13_15" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#d79b00;" edge="1" parent="1" source="t13" target="t15"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_14_15" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#d79b00;" edge="1" parent="1" source="t14" target="t15"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
<mxCell id="e_15_16" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;strokeColor=#d79b00;" edge="1" parent="1" source="t15" target="t16"><mxGeometry relative="1" as="geometry" /></mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 238 KiB |
@@ -1,105 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="arch" name="Config Model Architecture">
|
||||
<mxGraphModel dx="1200" dy="900" grid="1" gridSize="10" guides="1" arrows="1"
|
||||
fold="1" page="1" pageScale="1" pageWidth="1100" pageHeight="900" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- Commons container -->
|
||||
<mxCell id="commons" value="ZB.MOM.WW.ScadaBridge.Commons"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=14;fontStyle=1;verticalAlign=top;spacingTop=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="360" y="40" width="380" height="270" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Types/DataConnections group -->
|
||||
<mxCell id="types" value="Types/DataConnections/ OpcUaEndpointConfig.cs (POCO) OpcUaHeartbeatConfig.cs (POCO) OpcUaSecurityMode.cs (enum)"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="380" y="80" width="340" height="100" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Validators group -->
|
||||
<mxCell id="validators" value="Validators/ OpcUaEndpointConfigValidator.cs"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="380" y="190" width="340" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Serialization group -->
|
||||
<mxCell id="serialization" value="Serialization/ OpcUaEndpointConfigSerializer.cs"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="380" y="250" width="340" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- CentralUI container -->
|
||||
<mxCell id="centralui" value="ZB.MOM.WW.ScadaBridge.CentralUI"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;fontStyle=1;verticalAlign=top;spacingTop=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="480" width="320" height="220" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="cui_forms" value="Components/Forms/ OpcUaEndpointEditor.razor (shared)"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="140" y="520" width="280" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="cui_pages" value="Pages/Admin/ DataConnectionForm.razor"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="140" y="600" width="280" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- SiteRuntime container -->
|
||||
<mxCell id="siteruntime" value="ZB.MOM.WW.ScadaBridge.SiteRuntime"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;fontStyle=1;verticalAlign=top;spacingTop=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="660" y="480" width="340" height="220" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="sr_actors" value="Actors/ DeploymentManagerActor (passes raw JSON to DataConnectionFactory)"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="520" width="300" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="sr_dc" value="DataConnections.OpcUa/ OpcUaDataConnection.cs (consumes typed model)"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="600" width="300" height="70" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- referenced-by edges: both sides reference Commons -->
|
||||
<mxCell id="ref_cui" value="referenced by"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;startArrow=none;fontSize=12;dashed=0;"
|
||||
edge="1" parent="1" source="commons" target="centralui">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="280" y="400" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="ref_sr" value="referenced by"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;startArrow=none;fontSize=12;dashed=0;"
|
||||
edge="1" parent="1" source="commons" target="siteruntime">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="830" y="400" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
<!-- caption note -->
|
||||
<mxCell id="note" value="Both sides deserialize DataConnection.PrimaryConfiguration / BackupConfiguration into the same OpcUaEndpointConfig instance. The DB column type does not change."
|
||||
style="text;html=1;align=center;verticalAlign=middle;fontSize=12;fontStyle=2;fontColor=#555555;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="200" y="730" width="720" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 331 KiB |
@@ -1,93 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="browserarch" name="Tag Browser Architecture">
|
||||
<mxGraphModel dx="1000" dy="1200" grid="1" gridSize="10" guides="1" arrows="1"
|
||||
fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1300" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- 1. Blazor Server browser -->
|
||||
<mxCell id="n1" value="Blazor Server browser"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="40" width="320" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- 2. CentralUI: InstanceConfigure.razor -->
|
||||
<mxCell id="n2" value="CentralUI: InstanceConfigure.razor"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="150" width="320" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- 3. CentralUI: <OpcUaBrowserDialog/> -->
|
||||
<mxCell id="n3" value="CentralUI: &lt;OpcUaBrowserDialog/&gt;"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="260" width="320" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- 4. CentralUI: IOpcUaBrowseService -->
|
||||
<mxCell id="n4" value="CentralUI: IOpcUaBrowseService"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="240" y="370" width="320" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- 5. CommunicationService.SendCommandToSiteAsync -->
|
||||
<mxCell id="n5" value="CommunicationService.SendCommandToSiteAsync<BrowseOpcUaNodeResult>(siteId, BrowseOpcUaNodeCommand)"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="180" y="480" width="440" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- 6. Site: CentralCommunicationActor -> DataConnectionManagerActor -->
|
||||
<mxCell id="n6" value="Site: CentralCommunicationActor → DataConnectionManagerActor"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="200" y="600" width="400" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- 7. OPC UA server -->
|
||||
<mxCell id="n7" value="OPC UA server"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=13;fontStyle=1;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="280" y="710" width="240" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Edges with labels -->
|
||||
<mxCell id="e1" value="SignalR"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=12;"
|
||||
edge="1" parent="1" source="n1" target="n2">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e2" value="opens"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=12;"
|
||||
edge="1" parent="1" source="n2" target="n3">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e3" value="uses"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=12;"
|
||||
edge="1" parent="1" source="n3" target="n4">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e4" value="implementation calls"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=12;"
|
||||
edge="1" parent="1" source="n4" target="n5">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e5" value="ClusterClient Ask ManagementEnvelope { User, Command, CorrelationId }"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="n5" target="n6">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e6" value="dispatches to IBrowsableDataConnection (RealOpcUaClient) OPC Foundation .NET SDK Browse service"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="n6" target="n7">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 205 KiB |
@@ -1,155 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="cmdflow" name="Browse Command Flow">
|
||||
<mxGraphModel dx="1200" dy="1400" grid="1" gridSize="10" guides="1" arrows="1"
|
||||
fold="1" page="1" pageScale="1" pageWidth="1100" pageHeight="1500" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- Step 1: CentralUI.OpcUaBrowseService -->
|
||||
<mxCell id="s1" value="CentralUI.OpcUaBrowseService.BrowseChildrenAsync(siteId, connId, parent)"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="40" width="440" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Step 2: CommunicationService.SendCommandToSiteAsync -->
|
||||
<mxCell id="s2" value="CommunicationService.SendCommandToSiteAsync<BrowseOpcUaNodeResult>( siteId, new BrowseOpcUaNodeCommand(connId, parent))"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="150" width="440" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Step 3: ManagementEnvelope over ClusterClient -->
|
||||
<mxCell id="s3" value="ManagementEnvelope { User, Command, CorrelationId } over ClusterClient"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="160" y="270" width="360" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Step 4: Site: CentralCommunicationActor unwraps envelope -->
|
||||
<mxCell id="s4" value="Site: CentralCommunicationActor unwraps envelope"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="160" y="390" width="360" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Step 5: Site: DataConnectionManagerActor receives command -->
|
||||
<mxCell id="s5" value="Site: DataConnectionManagerActor receives BrowseOpcUaNodeCommand (DCL coordinator actor — owns the per-connection IDataConnection instances)"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="490" width="440" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Handler logic box (the bulleted sub-steps) -->
|
||||
<mxCell id="handler" value="Handler logic"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=12;fontStyle=1;verticalAlign=top;spacingTop=6;align=center;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="660" y="470" width="380" height="380" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="h_lookup" value="Look up IDataConnection by Id"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#d6b656;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="500" width="340" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="h_notfound" value="if not found → ConnectionNotFound"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="540" width="340" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="h_notbrowsable" value="if !(conn is IBrowsableDataConnection) → NotBrowsable"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="580" width="340" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="h_await" value="else await conn.BrowseChildrenAsync(ParentNodeId, ct)"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#d6b656;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="620" width="340" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="h_notconn" value="Catch ConnectionNotConnectedException → ConnectionNotConnected"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="660" width="340" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="h_cancel" value="Catch OperationCanceledException → Timeout"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="700" width="340" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="h_svc" value="Catch ServiceResultException → ServerError + verbatim msg"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="740" width="340" height="30" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="h_success" value="Else success: BrowseOpcUaNodeResult(children, truncated, null)"
|
||||
style="rounded=0;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=11;align=left;spacingLeft=8;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="680" y="790" width="340" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- auth note -->
|
||||
<mxCell id="authnote" value="Auth: site-side handler validates ManagementEnvelope.User has the Design role; otherwise reply ServerError ("Not authorized to browse data connections")."
|
||||
style="text;html=1;align=left;verticalAlign=middle;fontSize=11;fontStyle=2;fontColor=#555555;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="570" width="430" height="40" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Reply path -->
|
||||
<mxCell id="r1" value="Reply travels back via CentralCommunicationActor → CommunicationService"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="120" y="900" width="440" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="r2" value="returned to CentralUI page"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="200" y="1010" width="280" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Main chain edges -->
|
||||
<mxCell id="e1" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;"
|
||||
edge="1" parent="1" source="s1" target="s2">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;"
|
||||
edge="1" parent="1" source="s2" target="s3">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;"
|
||||
edge="1" parent="1" source="s3" target="s4">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e4" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;"
|
||||
edge="1" parent="1" source="s4" target="s5">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- s5 -> handler logic -->
|
||||
<mxCell id="e5" value="processes"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="s5" target="handler">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- handler -> reply -->
|
||||
<mxCell id="e6" value="result / failure"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="handler" target="r1">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="850" y="930" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
<mxCell id="e7" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;"
|
||||
edge="1" parent="1" source="r1" target="r2">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 436 KiB |
@@ -1,166 +0,0 @@
|
||||
<mxfile host="app.diagrams.net">
|
||||
<diagram id="failover" name="Failover State Machine">
|
||||
<mxGraphModel dx="1200" dy="900" grid="1" gridSize="10" guides="1" arrows="1"
|
||||
fold="1" page="1" pageScale="1" pageWidth="1100" pageHeight="1300" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
|
||||
<!-- Connected (start state) -->
|
||||
<mxCell id="connected" value="Connected"
|
||||
style="rounded=1;arcSize=40;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=14;fontStyle=1;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="40" width="200" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Push bad quality -->
|
||||
<mxCell id="badquality" value="Push bad quality to all subscribers"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="150" width="200" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Retry active endpoint -->
|
||||
<mxCell id="retry" value="Retry active endpoint (5s interval)"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="260" width="200" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- _consecutiveFailures++ -->
|
||||
<mxCell id="incr" value="_consecutiveFailures++"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="370" width="200" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Branch decision diamond -->
|
||||
<mxCell id="branch" value="Evaluate _consecutiveFailures"
|
||||
style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=12;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="450" y="470" width="140" height="100" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Branch 1: retry same endpoint -->
|
||||
<mxCell id="same" value="Retry same endpoint"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="80" y="495" width="200" height="50" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Branch 2: failover to backup -->
|
||||
<mxCell id="failover" value="Failover • dispose adapter, switch _activeEndpoint, reset counter • create fresh adapter with other config • attempt connect"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;fontSize=12;align=left;spacingLeft=8;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="380" y="640" width="280" height="110" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Branch 3: no backup -->
|
||||
<mxCell id="nobackup" value="Keep retrying indefinitely (current behavior)"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=13;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="760" y="495" width="220" height="60" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Successful reconnect outcome -->
|
||||
<mxCell id="reconnect" value="On successful reconnect (either endpoint) 1. Reset _consecutiveFailures = 0 2. ReSubscribeAll() — re-create subscriptions on new adapter 3. Transition to Connected 4. Log failover event if endpoint changed 5. Report active endpoint in health metrics"
|
||||
style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=12;align=left;spacingLeft=10;verticalAlign=middle;"
|
||||
vertex="1" parent="1">
|
||||
<mxGeometry x="360" y="830" width="320" height="140" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Edges -->
|
||||
<mxCell id="e1" value="disconnect detected"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=12;"
|
||||
edge="1" parent="1" source="connected" target="badquality">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;"
|
||||
edge="1" parent="1" source="badquality" target="retry">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e3" value="failure"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=12;"
|
||||
edge="1" parent="1" source="retry" target="incr">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e4" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;"
|
||||
edge="1" parent="1" source="incr" target="branch">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Branch 1 edge -->
|
||||
<mxCell id="b1" value="< FailoverRetryCount"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="branch" target="same">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<!-- Branch 1 loops back to retry -->
|
||||
<mxCell id="b1loop" value="retry"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;dashed=1;"
|
||||
edge="1" parent="1" source="same" target="retry">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="180" y="285" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
<!-- Branch 2 edge -->
|
||||
<mxCell id="b2" value="≥ FailoverRetryCount AND backup exists"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="branch" target="failover">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
|
||||
<!-- Branch 3 edge -->
|
||||
<mxCell id="b3" value="≥ FailoverRetryCount AND no backup"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="branch" target="nobackup">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<!-- no backup loops back to retry -->
|
||||
<mxCell id="b3loop" value="retry (round-robin n/a)"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;dashed=1;"
|
||||
edge="1" parent="1" source="nobackup" target="retry">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="870" y="285" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
<!-- failover -> attempt connect -> success -> reconnect -->
|
||||
<mxCell id="b2ok" value="connect succeeds"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="failover" target="reconnect">
|
||||
<mxGeometry relative="1" as="geometry" />
|
||||
</mxCell>
|
||||
<!-- failover -> attempt connect -> failure -> back to retry loop -->
|
||||
<mxCell id="b2fail" value="connect fails (round-robin: primary → backup → primary...)"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;dashed=1;"
|
||||
edge="1" parent="1" source="failover" target="retry">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="700" y="695" />
|
||||
<mxPoint x="700" y="285" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
<!-- reconnect -> Connected -->
|
||||
<mxCell id="bdone" value="Transition to Connected"
|
||||
style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;endArrow=block;fontSize=11;"
|
||||
edge="1" parent="1" source="reconnect" target="connected">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<Array as="points">
|
||||
<mxPoint x="320" y="900" />
|
||||
<mxPoint x="320" y="65" />
|
||||
</Array>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 366 KiB |
@@ -547,8 +547,27 @@ This section governs how implementation plans are executed. The goal is autonomo
|
||||
|
||||
For each work package, follow this sequence:
|
||||
|
||||
|
||||
<!-- source: diagrams/generate-plans-per-work-package.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
S1["1. READ the WP description and acceptance criteria"]
|
||||
S2["2. READ all traced requirements (HLR bullets, KDD, CD constraints) to understand intent"]
|
||||
S3["3. IMPLEMENT the WP<br/>• Write code<br/>• Write unit tests for acceptance criteria<br/>• Write negative tests for prohibition criteria"]
|
||||
S4["4. VERIFY acceptance criteria<br/>• Run tests: all must pass<br/>• Walk each acceptance criterion line by line<br/>• If a criterion cannot be verified yet (depends on a later WP), note it as deferred to WP-N"]
|
||||
S5["5. UPDATE the phase execution checklist<br/>• Mark WP as complete with date<br/>• Note any deferred criteria<br/>• Note any questions logged"]
|
||||
S6["6. COMMIT with message:<br/>Phase N WP-M: summary"]
|
||||
|
||||
S1 --> S2 --> S3 --> S4 --> S5 --> S6
|
||||
|
||||
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;
|
||||
class S1,S2 proc
|
||||
class S3 start
|
||||
class S4,S5 dec
|
||||
class S6 warn
|
||||
```
|
||||
|
||||
### Mid-Phase Compliance Check
|
||||
|
||||
|
||||
@@ -23,8 +23,39 @@ gRPC server-streaming is an established pattern for real-time tag value updates;
|
||||
|
||||
## Architecture
|
||||
|
||||
|
||||
<!-- source: diagrams/grpc-streams-architecture.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
subgraph CENTRAL["Central Cluster"]
|
||||
BT["DebugStreamBridgeActor"]
|
||||
GC["SiteStreamGrpcClient<br/>(per-site, on central)"]
|
||||
BB["DebugStreamBridgeActor"]
|
||||
SR(["SignalR Hub / Blazor UI"])
|
||||
end
|
||||
|
||||
subgraph SITE["Site Cluster"]
|
||||
IN["InstanceActor"]
|
||||
PB{"publishes<br/>AttributeValueChanged<br/>AlarmStateChanged"}
|
||||
GS["SiteStreamGrpcServer<br/>(Kestrel, on site)"]
|
||||
end
|
||||
|
||||
BT -.->|"SubscribeDebugView"| IN
|
||||
IN -.->|"DebugViewSnapshot"| BT
|
||||
IN --> PB
|
||||
PB --> GS
|
||||
GS -->|"gRPC stream (HTTP/2)"| GC
|
||||
GC --> BB
|
||||
BB --> SR
|
||||
|
||||
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;
|
||||
class BT,GC,BB proc
|
||||
class SR start
|
||||
class IN,GS warn
|
||||
class PB dec
|
||||
```
|
||||
|
||||
**Key separation**: ClusterClient handles subscribe/unsubscribe/snapshot (request-response). gRPC handles the ongoing value stream (server-streaming).
|
||||
|
||||
@@ -250,8 +281,23 @@ public override async Task SubscribeInstance(
|
||||
|
||||
`IServerStreamWriter<T>` is **not thread-safe**. Multiple Akka actors may publish events concurrently. The `Channel<SiteStreamEvent>` bridges these worlds:
|
||||
|
||||
|
||||
<!-- source: diagrams/grpc-channel-bridging.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
AKKA["Akka Actor Thread(s)"]
|
||||
CH(["Channel<SiteStreamEvent><br/><br/>BoundedChannelOptions(1000)<br/>FullMode = DropOldest"])
|
||||
GRPC["gRPC Response Stream"]
|
||||
|
||||
AKKA -->|"channel.Writer.TryWrite(evt)"| CH
|
||||
CH -->|"await responseStream.WriteAsync(evt)"| GRPC
|
||||
|
||||
classDef start fill:#d5e8d4,stroke:#82b366,color:#111111;
|
||||
classDef proc fill:#dae8fc,stroke:#6c8ebf,color:#111111;
|
||||
classDef warn fill:#ffe6cc,stroke:#d79b00,color:#111111;
|
||||
class AKKA warn
|
||||
class CH start
|
||||
class GRPC proc
|
||||
```
|
||||
|
||||
- **Bounded capacity** (1000): prevents unbounded memory growth if the gRPC client is slow
|
||||
- **DropOldest**: matches the existing `SiteStreamManager` overflow strategy
|
||||
@@ -401,8 +447,33 @@ private void HandleGrpcStreamError(Exception ex)
|
||||
|
||||
### Reconnection State Machine (DebugStreamBridgeActor)
|
||||
|
||||
|
||||
<!-- source: diagrams/grpc-reconnection-state-machine.drawio — edit, then re-export with export-drawio.sh -->
|
||||
```mermaid
|
||||
%%{init: {'theme':'base', 'themeVariables': {'textColor':'#111111','lineColor':'#555555','edgeLabelBackground':'#ffffff','fontSize':'15px'}}}%%
|
||||
flowchart TD
|
||||
S(["Streaming<br/><i>Normal state: gRPC stream active</i>"])
|
||||
R(["Reconnecting<br/><i>try other node endpoint</i>"])
|
||||
D{"reconnect result?"}
|
||||
RT["schedule retry<br/>(5s backoff)"]
|
||||
T(["Terminated<br/><i>notify consumer, stop actor</i>"])
|
||||
|
||||
S -->|"gRPC stream error / keepalive timeout"| R
|
||||
R --> D
|
||||
D -->|"success"| S
|
||||
D -->|"failure (retry < max)"| RT
|
||||
RT --> R
|
||||
D -->|"failure (retry >= max)"| T
|
||||
|
||||
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 S start
|
||||
class R dec
|
||||
class D proc
|
||||
class RT warn
|
||||
class T bad
|
||||
```
|
||||
|
||||
### Summary
|
||||
|
||||
|
||||
Reference in New Issue
Block a user