Architecture

Architecture

Aktueller Stand 16.10.2026

Verbindlich: main@8fb581b730f7a3833566c4bbb7c87875ad921e69; veröffentlicht bleibt v1.9.0. PR #74–#97 sind integriert. Deployment/Discovery, Imagebuilder, Pi-VPN und Syslog sind auf main, nicht mehr nur historische Vorschau. 26 reguläre Rollen einschließlich Deployment-VM; Provisioning ist optional zusätzlich.

Betreiberbestätigt: KDE-Boot, Rufe, SDS, Aufnahme/RF-Wiedergabe und WLAN am 13.10.; 28/28 Discovery-Agenten aktualisiert und keine ungeklärten Remote-Aufträge mehr am 15.10. Ein aktueller Backend-Gesamtrollout, NAS-Entlastung, SIP/Telegram, VPN-Wechsel und Dauerlauf bleiben separat offen. Vier alte Git-/Timeoutfehler bleiben Fehler.

Gesamtroadmap · Upstream-Vergleich · Roadmap und Releases. NETCORE-IAM-01 ist weiterhin Planung; AD-SSO-Pilot und Gruppenmapping sind konkretisiert, Produkt-/Betriebsentscheidung und Umsetzung offen.

Aktuelle Fachreferenz

Kanonische Anleitung am aktuellen main-Stand. Für neue Bedienwege, vollständige Rollen-/Portzählung und geänderte Grenzen ist diese Fassung maßgeblich; die früheren Beispiele unten bleiben als Historie erhalten.

Historischer Seitenstand bis 07.10.2026

Die folgende frühere Fassung bleibt als datierte Historie erhalten. Frühere Dienstzahlen, Featurebranch-Aussagen, offene Tests und Prioritäten sind keine aktuelle Statusaussage; heutige Verfahren stehen oben beziehungsweise in den verlinkten kanonischen Docs.

Architektur und Datenwege

Aktueller Quellenstand 07.10.2026: main 990bffb2; Release weiterhin v1.9.0. PR #59 mit Hell/Dunkel ist integriert, PR #60 ergänzt Projektarchive. Nur main ist als Branch vorhanden. Deployment/Discovery, Imagebuilder, Pi-VPN und neuere Syslog-Pipeline bleiben ausschließlich am historischen Featurecommit bbf0397 vorhanden. Keine neue Live-Abnahme. Roadmap und Releases · Upstream-Vergleich

Aktuelle Einordnung

Das neue Design ist implementiert; IAM/Drive bleiben Planung. Discovery, Imagebuilder, Pi-VPN und neuere Syslog-Funktionen sind weiterhin historische Entwicklung ohne main-Integration. Die aktuelle Reihenfolge und Nachweise stehen unter Roadmap und Releases und Projektstand.

NetCore Tetra trennt die zeitkritische Funkkante von netzweiten Fachkernen. Eine TBS betreibt die Luftschnittstelle und kann im lokalen Modus weiterarbeiten. Der Node Gateway vermittelt die Anbindung an zentrale Dienste; Control Room und andere Oberflächen greifen auf deren Zustände zu.

flowchart TD
    MS["Funkgeräte"] -->|"TETRA AI"| TBS["TBS / bluestation-bs"]
    TBS -->|"WebSocket /ws/node"| NG["Node Gateway"]
    NG -->|"/ws/backend + APIs"| C["Subscriber · Group · Mobility · Call Control"]
    NG -->|"Frames und Ereignisse"| M["Media Switch · SDS Router · Packet Core"]
    C --> UI["Control Room und Fach-WebUIs"]
    M --> UI

Loading

Die Pfeile zeigen Verantwortungsbereiche, keine vollständige Portliste. Netzwerk-und-Ports nennt die tatsächlich konfigurierbaren Transportwege.

Zuständigkeiten

Ebene	Komponenten	Autorität
Funkkante	SDR, PHY/MAC/LLC/MLE, lokale MM/CMCE, TBS-Dashboard, Mediencache	aktuelle Zelle, lokale Registrierung, Signalisierung, RF-Timing, lokaler Fallback
Vermittlung	Node Gateway, Subscriber/Group/Mobility, Call Control, Media Switch, SDS Router	netzweite Teilnehmer-/Gruppen- und Rufzustände, codierte Sprachframes, SDS-Verteilung
Paket und Sicherheit	Packet Core, IP Gateway, Security Core, KMF, Transit	PDP/IPv4, Policies/Schlüssel, regionale Verbindungen
Anwendungen	SIP Switch, IoT Gateway, Media Library, Workflows, RF Monitor, weitere	Telefonie, MQTT, Medien, Alarme und Diagnosen
Bedienung	lokales Dashboard, Directory, Provisioning Core, Control Room, Observability	lokale Steuerung, Metadatenpflege, Teilnehmeranlage, Leitstellenansicht, Metriken

Die vollständige Zuordnung aller 25 Inventory-Dienste steht im Dienstkatalog. Directory ist der Namens-/Metadatendienst; Subscriber Core und Group Core führen die zugehörigen netzweiten Profile und Policies. Gleiche Bezeichnungen ersetzen keine fachliche Zuständigkeit.

Kritische Abläufe

Registrierung und Affiliation

Das Funkgerät findet SYNC/SYSINFO, meldet sich per Location Update an der TBS und affiliiert sich gegebenenfalls mit einer GSSI. Lokale Zulassung, zentrale Policy, aktuelle Registrierung und tatsächliche Erreichbarkeit sind getrennt zu prüfen. Mehr dazu unter Registration-and-Affiliation und ISSI-and-GSSI.

Ruf und Sprache

Die TBS führt ihre CMCE- und Floor-Zustände am Funk. Für zentrale Rufe entscheidet Call Control über Rufzweige; Media Switch transportiert codierte TETRA-Sprachframes zwischen den Knoten. Ein registrierter SIP-Trunk ist ein anderer Pfad: native TBS-Bridge → lokaler Asterisk → zentraler SIP Switch → bestehende PBX. Calls · SIP-und-Brew

SDS, Status und Automationen

SDS und U-STATUS können lokal verarbeitet werden; der zentrale SDS Router ergänzt Routing und Warteschlangen. Der IoT Gateway veröffentlicht Ereignisse und Zustände per MQTT. Eine Nachricht im TBS-Log belegt noch nicht, dass sie beim Broker oder in Home Assistant ankam. SDS-and-U-STATUS · MQTT-und-Home-Assistant

Packet Data

SNDCP und lokale TBS-Funktionen treffen auf Packet Core und IP Gateway. TUN, NAT, Firewall und WAP/Testdienste sind eigenständige Grenzen. Der Zugang zu einer WebUI beweist keinen funktionierenden Datentransfer über das Endgerät. Paketdaten-und-WAP

Ausfall und Wiederkehr

Im Edge-Fallback-Konzept unterscheidet die TBS online, degraded, isolated und recovering. Eine Service-Matrix besitzt eine Ablaufzeit; lokale Calls, SDS und installierte Schlüssel können je nach Konfiguration weiterlaufen. Zentrale Routen, neue Schlüsselverteilung und netzweite Dienste sind im Ausfall begrenzt. Ein altes Sprachframe wird nicht „nachgesendet“; begrenzte SDS-/Steuerereignisse können aus einem lokalen Spool wieder eingespielt werden. Backup-and-Fallback · Mehrzellenbetrieb

Quellorte

• TBS: bins/bluestation-bs, crates/tetra-entities
• Backends: system-backend
• Deployment: deploy/open-lab
• Verträge und Befunde: Docs/, insbesondere Integrationshinweise

Die Warnzentrale ergänzt die Anwendungsebene: Sie liest Lage aus Control Room und sendet über den SDS Router. Ihre persistente Duplikatsperre und Tokenpflicht sind dienstspezifisch.

Entwicklungsvorschau vom 28 September 2026

Entwicklungsvorschau vom 28.09.2026: Historischer Featurecommit bbf0397, Deployment-Komponente 0.2.3. Diese Funktionen sind noch nicht auf main und kein neuer Gesamtrelease. PR #57 wurde in den Entwicklungsbranch gemergt. Eine Ubuntu-VM verwaltet Images und gezielte Rollouts; Agenten speichern die letzte gültige Dienstzuordnung lokal. Die VM liegt außerhalb des zeitkritischen Funk-/Medienpfads. Observability bleibt separat; sein rsyslog-Empfänger ist zusätzlich von NMS-WebUI und Controller entkoppelt. Deployment-und-Discovery · Syslog-und-Archivierung