Kiosk einrichten

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

Voraussetzungen

• Administrator-Zugriff im CheckCourt
• 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-Panel registrieren

1. Melde dich als Administrator im CheckCourt an
2. Navigiere zu Verwaltung → Kiosk-Geräte
3. Klicke auf Neues Gerät
4. Vergib einen aussagekräftigen Namen (z.B. „Kiosk Eingang", „Kiosk Clubhaus")
5. Das System generiert einen API-Key
6. Kopiere den API-Key — er wird nur einmal vollständig angezeigt

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 an

Schritt 3: API-Key eingeben

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

Schritt 4: Verbindung herstellen

1. Klicke auf Verbinden
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-Panel ü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-Panel — 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
• Automatische Aktualisierung — Die Ansicht aktualisiert sich alle 5 Minuten
• Verbindungsstatus — Das Admin-Panel zeigt unter „Zuletzt gesehen", wann sich das Gerät zuletzt verbunden 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-Panel unter Verwaltung → Kiosk-Geräte. Damit wird der API-Key ungültig und das Terminal kann sich nicht mehr verbinden, auch wenn der Key auf dem Gerät noch gespeichert ist. Siehe Kiosk-Geräte für Details.

Fehlerbehebung