CheckCourt

Kiosk einrichten

Schritt-für-Schritt-Anleitung zur Einrichtung eines Kiosk-Terminals im CheckCourt.

Diese Anleitung beschreibt die vollständige Einrichtung eines Kiosk-Terminals, von der Registrierung im Admin-Bereich bis zur Verbindung des Geräts.

Voraussetzungen

  • Das Recht, Kiosk-Geräte zu verwalten, zum Beispiel als Administrator
  • Kiosk-Hardware: Ein Tablet, Touchscreen-Display oder Computer mit Webbrowser
  • Netzwerkverbindung: Das Kiosk-Gerät muss den CheckCourt-Server erreichen können

Schritt 1: Gerät im Admin-Bereich registrieren

  1. Melde dich im CheckCourt an
  2. Navigiere zu Admin → Kiosk-Geräte
  3. Klicke auf Gerät hinzufügen
  4. Vergib unter Gerätename einen aussagekräftigen Namen (z.B. „Kiosk Eingang“, „Kiosk Clubhaus“) und klicke auf Erstellen
  5. Das System generiert einen API-Key
  6. Kopiere den API-Key. Er wird nur einmal vollständig angezeigt. Danach schließt du den Dialog mit Fertig

Wichtig: Speichere den API-Key sofort an einem sicheren Ort (z.B. Passwort-Manager). Er kann nach dem Schließen des Dialogs nicht mehr vollständig angezeigt werden.

Schritt 2: Kiosk-App auf dem Gerät öffnen

  1. Öffne den Webbrowser auf dem Kiosk-Gerät
  2. Navigiere zu deiner CheckCourt-URL mit dem Pfad /kiosk (https://app.checkcourt.de/kiosk)
  3. Die Kiosk-App zeigt den Einrichtungsbildschirm Kiosk einrichten an

Schritt 3: API-Key eingeben

  1. Auf dem Einrichtungsbildschirm gibst du den zuvor kopierten Key in das Feld API-Key ein
  2. Du kannst den Key auch per Einfügen (Strg+V / Cmd+V) einfügen

Soll der Kiosk mit einem anderen Server als app.checkcourt.de sprechen, drückst du auf dem Einrichtungsbildschirm Strg + Shift + D. Dann erscheint zusätzlich das Feld Server-URL (optional).

Schritt 4: Verbindung herstellen

  1. Klicke auf Verbinden oder drücke die Eingabetaste
  2. Die App prüft die Verbindung zum Server
  3. Bei erfolgreicher Verbindung wechselt die App automatisch zur Platzübersicht

Bei Verbindungsfehlern

Falls die Meldung „Verbindung fehlgeschlagen. Prüfe den API-Key." erscheint:

  • Prüfe den API-Key: Stimmt der Key mit dem aus dem Admin-Bereich überein?
  • Prüfe die Netzwerkverbindung: Hat das Gerät Internetzugang?
  • Prüfe Firewall-Einstellungen: Ist der Zugriff auf den Server erlaubt?
  • Prüfe das Gerät im Admin-Bereich: Wurde es eventuell gelöscht?

Schritt 5: Kiosk-Modus einrichten

Nach erfolgreicher Verbindung empfehlen wir, das Gerät in den Kiosk-Modus zu versetzen:

iPad / iOS

  1. Gehe zu Einstellungen → Bedienungshilfen → Geführter Zugriff
  2. Aktiviere Geführter Zugriff
  3. Lege einen Code fest
  4. Öffne Safari mit der Kiosk-App
  5. Drücke dreimal die Seitentaste, um den geführten Zugriff zu starten
  6. Tippe auf Starten

Android-Tablet

  1. Öffne Einstellungen → Sicherheit → Bildschirmfixierung (oder „App-Fixierung")
  2. Aktiviere die Funktion
  3. Öffne Chrome mit der Kiosk-App
  4. Tippe auf die Übersichtstaste (Quadrat)
  5. Tippe auf das App-Symbol oben und wähle Fixieren

Windows / Chrome

  1. Öffne Chrome und navigiere zur Kiosk-App-URL
  2. Drücke F11 für den Vollbildmodus
  3. Optional: Starte Chrome im Kiosk-Modus über die Kommandozeile:
    chrome.exe --kiosk https://app.checkcourt.de/kiosk

Linux / Raspberry Pi

  1. Installiere Chromium
  2. Starte Chromium im Kiosk-Modus:
    chromium-browser --kiosk --noerrdialogs --disable-infobars https://app.checkcourt.de/kiosk
  3. Optional: Richte einen automatischen Start beim Hochfahren ein (z.B. über ~/.config/autostart/)

Schritt 6: Funktion testen

  1. Gib einen Test-PIN am Nummernfeld ein (nutze deinen eigenen Mitgliedscode)
  2. Prüfe, ob die Platzübersicht korrekt angezeigt wird
  3. Führe eine Testbuchung durch
  4. Prüfe, ob die Buchung im CheckCourt erscheint
  5. Teste den Check-in mit einer bestehenden Buchung

Betrieb

Nach der Einrichtung arbeitet das Kiosk-Terminal vollautomatisch:

  • Echtzeit-Updates: Platzänderungen werden per WebSocket sofort angezeigt. Bricht die Verbindung ab, baut der Kiosk sie nach wenigen Sekunden selbst wieder auf
  • Automatische Aktualisierung: Die Ansicht aktualisiert sich zusätzlich alle 5 Minuten
  • Verbindungsstatus: Der Admin-Bereich zeigt unter „Zuletzt gesehen“, wann sich das Gerät zuletzt gemeldet hat

Verbindung trennen

Du kannst ein Kiosk-Terminal jederzeit vom Server trennen, etwa um es auf einen anderen Server umzustellen, den API-Key zu wechseln oder das Gerät auszumustern.

Direkt am Gerät

  1. Drücke am Kiosk-Terminal die Tastenkombination Strg + Shift + D
  2. Die App löscht den gespeicherten API-Key und kehrt zum Einrichtungsbildschirm zurück
  3. Die Echtzeit-Verbindung (WebSocket) wird dabei sofort geschlossen

Danach lässt sich das Gerät mit einem neuen API-Key oder einer anderen Server-URL neu verbinden (siehe Schritt 3 und 4).

Tipp: Da Kiosk-Terminals meist im fixierten Vollbildmodus laufen, ist eine angeschlossene Tastatur der einfachste Weg, diese Kombination auszulösen. Der gespeicherte Key liegt nur lokal im Browser des Geräts. Beim Trennen wird er dort entfernt.

Serverseitig (durch den Administrator)

Soll ein Gerät dauerhaft keinen Zugriff mehr haben, lösche es im Admin-Bereich unter Admin → Kiosk-Geräte mit Löschen und Wirklich?. Damit wird der API-Key ungültig. Das Terminal kehrt beim nächsten Abruf von selbst zum Einrichtungsbildschirm zurück und kann sich nicht mehr verbinden. Siehe Kiosk-Geräte für Details.

Fehlerbehebung

ProblemLösung
Verbindung fehlgeschlagenURL und API-Key prüfen, Netzwerk prüfen
Plätze werden nicht angezeigtServer-Status prüfen, Seite neu laden
PIN wird nicht erkanntMitgliedscode in den Einstellungen prüfen
Kein Live-UpdateWebSocket-Verbindung prüfen, Firewall-Einstellungen prüfen
„Zuletzt gesehen“ ist veraltetPrüfen, ob das Gerät läuft und Netzwerk hat
Kiosk zeigt plötzlich den EinrichtungsbildschirmDas Gerät wurde im Admin-Bereich gelöscht oder der Key ist ungültig. Neues Gerät anlegen und verbinden
Kiosk trennen oder zurücksetzenAm Gerät Strg + Shift + D drücken (siehe „Verbindung trennen")

On this page