Zum Inhalt

Netzwerk & Ports

flowchart LR
    ST["<span style='color:#111111'>nestris-station</span>"]:::core -- "TCP 1883 · MQTT" --> MQ["<span style='color:#ffffff'>Mosquitto</span>"]:::ext
    ST -- "TCP 7990 · HTTP PUT .ngf" --> LTM["<span style='color:#111111'>NestrisLTM</span>"]:::ltm
    MQ <-- "TCP 1883 · MQTT" --> LTM
    LTM -- "TCP 5432 · SQL" --> PG[("<span style='color:#ffffff'>PostgreSQL</span>")]:::ext
    TERM["<span style='color:#111111'>nestris-terminal-Bridge<br/>127.0.0.1:7991</span>"]:::term -- "TCP 7990 · REST" --> LTM
    BR["<span style='color:#ffffff'>Browser · OBS · Anzeigen</span>"]:::ext -- "TCP 7990 · HTTP + WebSocket" --> LTM
    RD1["<span style='color:#111111'>Leser</span>"]:::rfid -- "USB-Seriell 115200" --> ST
    RD2["<span style='color:#111111'>Leser</span>"]:::rfid -- "USB-Seriell 115200" --> TERM
    LTM -. "HTTPS 443 · Update-Prüfung (optional)" .-> GH["<span style='color:#ffffff'>GitHub</span>"]:::ext

    classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
    classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
    classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
    classDef rfid fill:#f472b6,stroke:#be185d,color:#111,stroke-width:2px
    classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px

Portübersicht

Port Protokoll Dienst Lauscht auf Clients Erreichbarkeit
7990 HTTP / WebSocket NestrisLTM Host, 0.0.0.0 Stationen, Terminal, Browser, OBS lokales Subnetz (Firewall-Regel)
1883 MQTT Mosquitto Host Stationen, NestrisLTM lokales Subnetz (Firewall-Regel)
5432 PostgreSQL PostgreSQL Host NestrisLTM standardmäßig nur lokal
7991 HTTP / WebSocket Terminal-Bridge 127.0.0.1 nur das Kiosk-Fenster aus dem Netz nicht erreichbar
443 HTTPS GitHub – Update-Prüfung von NestrisLTM ausgehend, optional
– USB-Seriell, 115200 8N1 RFID-Leser – Station oder Terminal lokales USB

HTTP-Endpunkte von NestrisLTM

Pfad Zugriff Zweck
/ Admin-Login Admin-Oberfläche
/o/<slug> öffentlich (LAN) OBS-Overlay einer Szene
/view/highscore öffentlich (LAN) Highscore- und Turnierbaum-Anzeige
/view/tournament-admin Admin-Login Turnierkonsole
/status öffentlich (LAN) Statusseite
/api/terminal/v1/* Token terminal API für das Spieler-Terminal
/api/stations/{id}/games/{game_id}/ngf Token stations Upload der Aufzeichnung
/api/scenes/{slug}/rounds Token scenes Neue Runde starten (Stream Deck)
/api/health öffentlich (LAN) Zustandsprüfung (Datenbank, Broker)
/api/diagnostics Admin oder lokal Diagnose und Logs
/ws/live, /ws/kiosk, /ws/scene/{slug} öffentlich (LAN) WebSocket-Feeds für Oberfläche, Anzeigen und Overlays

Token-Scopes

Scope Verwendet von
admin Voller Zugriff auf die Admin-API
players:write Werkzeuge, die Spieler anlegen oder bearbeiten
games:write Werkzeuge, die Spiele anlegen oder bearbeiten
stations Capture-Stationen (Upload der Aufzeichnung)
scenes Stream Deck / Rundensteuerung
terminal Das Spieler-Terminal

Tokens beginnen mit nltm_ und werden in der Admin-Oberfläche unter Einstellungen → API-Tokens angelegt.