Gerät registrieren

Jedes Android-Gerät und jeder ESP32-Gateway erhält einen eigenen Token. Nur der eigene Telemetrie-Endpunkt ist damit zugänglich.

REST-API

Header: Authorization: Bearer GERÄTE_TOKEN

{
  "timestamp":"2026-10-15T07:30:00Z",
  "sequence":42,
  "gps":{"latitude":50.1109,"longitude":8.6821,
    "speedMps":6.9,"altitudeMeters":115,
    "accuracyMeters":5},
  "battery":{"levelPercent":84},
  "sensors":{"cadenceRpm":79}
}

Registrierte Geräte

Toursteuerung

Letzte Position

Datengenauigkeit

GPS-Sprünge und Höhenrauschen sind in dieser ersten Version nur einfach gefiltert. Für genaue kumulierte Höhenmeter ist eine spätere Sensorfusion geplant.

Tourhistorie

OBS-Browserquelle

Erzeuge eine Overlay-URL, kopiere sie in OBS und verwende eine Browserquelle (z. B. 600 × 180). Die Quelle zeigt Geschwindigkeit und Höhe sowie optional den freigegebenen ungefähren Ort.

Öffentliche Ortsangaben

Standard: ausgeschaltet. Auch Ortsnamen und genaue Zeitstempel können Rückschlüsse auf deinen Standort erlauben.

Overlay-Vorschau

Ausgegebene Token

SRTLA / OpenIRL überwachen

Der vorhandene OpenIRL-Server verarbeitet weiterhin Video/SRTLA. Hier wird seine Statistik-URL überwacht; unser Dashboard ist selbst kein SRTLA-Receiver.

Noch keine Daten.

Übliche Netzwerkports (OpenIRL)

Diese Ports gelten für typische OpenIRL-Beispiele. Prüfe die tatsächlich eingesetzte Konfiguration. Port 8080 sollte nicht ungeschützt öffentlich sein.

Twitch-Verknüpfung

Offizieller OAuth Authorization-Code-Flow. Nach Domain-/HTTPS-Einrichtung registrierst du bei Twitch die Callback-URL https://DEINE-DOMAIN/twitch/callback.

Benötigte Berechtigungen: user:read:chat und user:write:chat. Empfangender Live-Chat über EventSub folgt in einer späteren Version.

Konto- und Streamstatus

Noch keine Abfrage.

Nur mit verknüpftem Twitch-Konto und ausreichenden Rechten.

Externe Streaming-Server

SSH-Server kann hinterlegt und seine TCP-Erreichbarkeit geprüft werden. Read-only-Diagnosen (Uptime, RAM, Datenträger) verwenden einen fest geprüften SSH-Hostfingerprint.

Noch keine Prüfung.

Sicherheitsgrundsätze

Für die spätere Fernadministration werden überprüfte Host-Schlüssel, eingeschränkte SSH-Benutzer und eine feste Befehls-Allowlist benötigt. Docker-Socket und Host-Bind-Mounts werden nicht verwendet.

Aktueller Softwarestand

Mitgeliefertes Installationspaket

Ein installierbares Release-ZIP der aktuell ausgelieferten Version liegt im Container bereit. Dieses ZIP ist funktional identisch, sein Datei-Hash kann vom äußeren Upload-Paket abweichen.

Update-ZIP hinterlegen

Du kannst ein neues, zum Projekt gehörendes ZIP-Paket hier ablegen, prüfen lassen und anschließend wieder herunterladen. Die Installation selbst erfolgt weiterhin über deinen ZIP Docker Installer. Ohne Docker-Socket und Host-Zugriff kann das Dashboard keinen Compose-Stack selbst austauschen.

Archivierte ZIP-Pakete

Projektbeschreibung (PDF)

Die aktuelle Projektspezifikation liegt auch direkt in der Anwendung. Sie beschreibt Gesamtziel, Architektur, Funktionen, API und alle noch offenen Erweiterungen.

Was enthält diese Version?

Weitere Ausbaustufen

Installations-Checkliste

Spätere Domain eintragen

Die Domain ist bei der Erstinstallation optional. Danach DNS, HTTPS-Reverse-Proxy und öffentliche URL konfigurieren.

Netzwerk & Firewall

Port 18787 bietet zunächst HTTP und eine Passwort-Anmeldung. Für öffentlichen Zugriff zuerst HTTPS und Zugriffsschutz vorsehen.