3. Systemkontext

Der zentrale Architekturgegenstand ist das Produkt CIMgate.HUB nach den Vernetzungsarten UC1-UC4. CIMgate.HUB sitzt zwischen der eigenen CX5-Datenbank und der Ausenwelt. Er Kommuniziert als Schnittstelle mit den Hub-Knoten der Partner. Als Verbindungsweg und für den Datenaustausch wird ausschließlich NATS genutzt. Nutzer interagieren über CX5 und Administratoren können zusätzlich über die HUB-UI Mertriken einsehen. Daten verlassen die Organisation nur über den HUB, CX5 selbst spricht nie direkt mit Partnern.

Fachlicher Kontext

Element	Eingang in den HUB	Ausgang aus dem HUB
CX5-Instanz (eigene Org.)	Datenänderungen (CDC), Teilen-/Einladen-/Annehmen-Aktionen, Kopplungskonfiguration	Synchronisierte Datensätze, Partner- und Verbindungsstatus, Konflikt- und Fehlerhinweise, Einsatztagebuch-Einträge
Partner-HUB (UC1, UC2, UC4: vorab gekoppelt)	Änderungen der Gegenseite, Snapshots, Statusmeldungen, Teilungsangebote	Eigene freigegebene Änderungen, Snapshots, Bestätigungen
Partner-HUB (UC3: ad hoc)	Einlösung einer Einladung, Änderungen des geteilten Einsatzes	Einladung (Code/Datei), Einsatzdaten gemäß Freigabe
Systemadministration	Kopplung einrichten/bestätigen/auflösen, Annahmemodus, Freigaben	Dashboard, Systemprotokoll, Fehlerliste
Nutzer mit Recht „Ad-hoc teilen/annehmen“	Einladung erzeugen/widerrufen, annehmen, Teilen beenden, Zugriff anfragen	Einladungscode, Status, Zugriffsanfragen
Monitoring	-	Metriken, Traces, Logs (OTLP)

Technischer Kontext

Schnittstelle	Protokoll	Inhalt
CX5-DB lesen	PostgreSQL logische Replikation (pgoutput) → Debezium	Zeilenänderungen aller klassifizierten Tabellen
CX5-DB schreiben	EF Core, Transaktion je Nachricht/Batch	Anwenden eingehender Änderungen inkl. Sync-Metadaten
CX5-UI ↔ HUB	HTTPS/JSON (lokale Control-Plane-API)	Einladungen, Kopplungen, Status, Zugriffsanfragen
HUB ↔ HUB Data Plane	NATS-Leafnode über TLS 1.3, Credentials je Peer	Collab-, Snapshot-, Status- und Objekt-Subjects
HUB ↔ HUB Control Plane	HTTPS + kurzlebige JWT	Handshake, Versionsprüfung, Einlösung, Kopplungsbestätigung
LAN-Erkennung (optional)	mDNS _cimgate-hub._tcp.local	Ankündigung von HUB-Knoten
Monitoring	OTLP → Grafana	Telemetrie

Zeilendaten fließen ausschließlich über NATS, nie über HTTP. Bei UC4 ist der Netzweg vorab freigeschaltet und wird laufend geprüft; bei UC3 muss der Teilende-Partner eine Seite für die Gegenseite direkt erreichen können.