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.