Benutzerhandbuch — Tischtennis Turniersystem

Version: MVP Sprache: Deutsch Zielgruppen: Administratoren · Spieler · Betreuer

Inhaltsverzeichnis

1. Systemübersicht
2. Administrator-Anleitung
   • 2.1 Anmeldung
   • 2.2 Spieler verwalten
   • 2.3 Turnier erstellen
   • 2.4 Spieler für ein Turnier anmelden
   • 2.5 Auslosung durchführen
   • 2.6 Turnier durchführen — Übersicht & Tische
   • 2.7 Einsprüche bearbeiten
   • 2.8 Betreuer verwalten
   • 2.9 Nutzerverwaltung & Rollenzuweisung
   • 2.10 Spielbearbeitung & Kampflos
   • 2.11 Gruppen-Darstellung (STTV-Format)
   • 2.12 Nutzerverwaltung & SMTP-Konfiguration
   • 2.13 Gruppen-Detailansicht
   • 2.14 Öffentlicher Turnier-Zugang (Spectator)
   • 2.15 Tisch-Display (Zuschauer-Anzeige)
   • 2.16 API-Dokumentation (Swagger)
   • 2.17 Urkunden erstellen & drucken
   • 2.18 Abschlussberichte & CSV-Export
   • 2.19 Turnier-Fotogalerie
   • 2.20 Dynamisches Doppel
   • 2.21 Venue-Tischpool
   • 2.22 Tischverwaltung (Live-Übersicht)
   • 2.23 Spectator Live-Board (Venue-Anzeige)
   • 2.24 Jeder gegen Jeden (Round Robin)
   • 2.25 Turnier kopieren
   • 2.26 Statistik-Dashboard
   • 2.27 Mandanten-Verwaltung (Multi-Tenancy)
   • 2.28 Spieler-Ampelstatus & Tischzuweisung
   • 2.29 Daten-Export
   • 2.30 Spieler importieren (Excel/CSV)
3. Spieler-Anleitung
   • 3.1 Registrierung
   • 3.2 Anmeldung & Passwort vergessen
   • 3.3 Mein Dashboard
   • 3.4 Spielergebnis bestätigen (PIN)
   • 3.5 Einspruch erheben
   • 3.6 Profil & PIN verwalten
   • 3.7 Betreuer verknüpfen
4. Betreuer-Anleitung
   • 4.1 Registrierung als Betreuer
   • 4.2 Betreuer-Dashboard
   • 4.3 Spieler-Anfragen annehmen
   • 4.4 Spieler betreuen & Bracket verfolgen
5. Tablet-Bedienung (Spieleingabe am Tisch)
   • 5.1 Aufschlag festlegen
   • 5.2 Spielstand eingeben
   • 5.3 Satzende & Spielende
   • 5.4 Auszeit & Timer
   • 5.5 Schiedsrichter-Funktionen
   • 5.6 Ergebnisbestätigung am Tablet
6. Häufige Fragen & Fehlerbehandlung

1. Systemübersicht

Das Tischtennis-Turniersystem ersetzt Papierbögen und manuelle Tabellen durch eine vollständig digitale Lösung. Alle Geräte am Veranstaltungsort greifen über den Browser auf das System zu — keine App-Installation erforderlich.

Dark Mode

Das System unterstützt einen Dark Mode, der über das Sonne/Mond-Icon im Header jeder Seite umgeschaltet werden kann.

Die Einstellung wird im Browser gespeichert und bleibt über Sitzungen hinweg erhalten.

Startseite (Landingpage)

Die Startseite unter / bietet einen Überblick über das gesamte System:

• Feature-Übersicht — Was das System für jede Rolle bietet (Admin, Spieler, Betreuer, Schiedsrichter)
• Screenshot-Karussell — Visuelle Eindrücke der wichtigsten Ansichten (Auto-Play, Touch-fähig). Neue Screenshots im Ordner /public/screenshots/ werden automatisch erkannt und angezeigt — die Anzahl im Text passt sich dynamisch an.
• Direkt einsteigen — Login-Karten für jede Rolle mit direkten Links zu den Anmeldeseiten
• Registrierung — Spieler und Betreuer können sich direkt über die Startseite registrieren

Die Startseite ist öffentlich zugänglich — keine Anmeldung erforderlich.

Rollen im System

Voraussetzungen

• WLAN am Veranstaltungsort ist zwingend erforderlich — das System funktioniert nicht offline.
• Für jeden Tisch wird ein Tablet (beliebiges Modell, Browser genügt) benötigt.
• Spieler benötigen für die digitale Bestätigung ein eigenes Gerät (Smartphone oder PC) oder bestätigen direkt am Tablet.

2. Administrator-Anleitung

2.1 Anmeldung

1. Öffne /admin/login im Browser.
2. Gib deine E-Mail-Adresse und dein Passwort ein.
3. Klicke auf Anmelden — du wirst automatisch zum Admin-Dashboard weitergeleitet.

Die Admin-Zugangsdaten werden beim ersten Setup eingerichtet. Bei Verlust des Passworts wende dich an den Systembetreiber.

2.2 Spieler verwalten

Alle Spieler werden zentral in einer Datenbank verwaltet, unabhängig von einzelnen Turnieren.

Neuen Spieler anlegen:

1. Navigiere zu Spieler im Admin-Dashboard.
2. Klicke auf Spieler hinzufügen.
3. Fülle das Formular aus:
   • Vorname und Nachname (Pflicht)
   • Verein (optional)
   • TTR-Wert (optional) — die aktuelle Tischtennis-Rangliste des Spielers. Wird für die Lostopf-Einteilung bei Auslosungen verwendet.
   • Jahrgang (optional) — Geburtsjahr des Spielers, relevant für Altersklassen-Turniere.
   • Lizenznummer (optional) — Spielerlizenz des Verbands (z. B. click-TT-Nummer).
   • Verband (optional) — Tischtennisverband des Spielers (z. B. „STTV", „DTTB").
   • Display-Name (automatisch generiert aus Vorname + erster Buchstabe Nachname, z. B. „Max M.") — max. 20 Zeichen, kann manuell angepasst werden. Wird auf Scoreboards und in Brackets angezeigt.
   • PIN (4-stellig, numerisch) — wird für die Spielbestätigung am Tablet und im Portal benötigt. Die PIN wird verschlüsselt gespeichert.
4. Klicke auf Speichern.

Spieler bearbeiten:

1. Klicke in der Spielerliste auf das Stift-Symbol neben dem Spieler.
2. Ändere die gewünschten Felder.
3. Klicke auf Speichern.

PIN zurücksetzen (Admin):

1. Klicke in der Spielerliste auf das Schlüssel-Symbol neben dem Spieler.
2. Gib die neue 4-stellige PIN ein und bestätige.
3. Der Spieler wird in seinem Portal benachrichtigt, dass seine PIN geändert wurde.

Portal-Zugang einrichten:

Im Bearbeitungsdialog eines Spielers findest du den aufklappbaren Bereich „Portal-Zugang". Hier kannst du einem Spieler ohne eigenes Konto einen Portal-Zugang einrichten:

1. Klappe den Bereich Portal-Zugang auf.
2. Gib eine E-Mail-Adresse und ein Passwort (mindestens 8 Zeichen) für den Spieler ein.
3. Klicke auf Speichern — der Spieler kann sich ab sofort unter /player/login anmelden.

Spieler mit Portal-Zugang werden in der Spielertabelle mit einem grünen „Portal"-Badge gekennzeichnet.

E-Mail ändern (Spieler mit Portal):

1. Öffne den Bearbeitungsdialog des Spielers.
2. Im Bereich Portal-Zugang ist die aktuelle E-Mail-Adresse sichtbar.
3. Ändere die E-Mail-Adresse und klicke auf Speichern.

Passwort zurücksetzen (Spieler mit Portal):

1. Öffne den Bearbeitungsdialog des Spielers.
2. Im Bereich Portal-Zugang klicke auf Passwort zurücksetzen.
3. Gib das neue Passwort ein und bestätige.

TTR-Plausibilitätshinweise:

Beim Eintragen oder Ändern des TTR-Werts zeigt das System Hinweise zur Einordnung:

Bei ungewöhnlich hohen oder niedrigen Werten erscheint eine Warnmeldung (z. B. „TTR-Wert liegt im Spitzenspieler-Bereich — bitte prüfen"). Dies ist nur ein Hinweis, der Wert kann trotzdem gespeichert werden.

CSV-Import (click-TT):

Du kannst Spieler aus einer click-TT-Exportdatei importieren, anstatt sie einzeln anzulegen:

1. Klicke in der Spielerverwaltung auf „CSV importieren".
2. Schritt 1 — Upload: Wähle eine CSV-Datei aus (Semikolon- oder Komma-getrennt, UTF-8-Kodierung).
3. Schritt 2 — Vorschau: Das System zeigt eine Vorschau aller erkannten Spieler:

4. Schritt 3 — Ergebnis: Nach dem Import siehst du eine Zusammenfassung (neu angelegt, aktualisiert, übersprungen).

Unterstützte Felder: Nachname, Vorname, Verein, TTR, Lizenznummer, Verband, Jahrgang.

Matching-Logik: Bestehende Spieler werden anhand der Lizenznummer (exakter Abgleich) oder des Namens (Fuzzy-Matching) erkannt. Neue Spieler erhalten automatisch eine PIN.

Hinweis: Die CSV-Datei muss im click-TT-Exportformat vorliegen. Andere Formate werden nicht unterstützt.

Spieler löschen:

• Ein Spieler kann nur gelöscht werden, wenn er in keinem aktiven Turnier angemeldet ist.

Hinweis: Spieler können sich auch selbst über /player/register registrieren. Diese Selbstregistrierung verknüpft ihr Portal-Konto automatisch mit dem entsprechenden Spieler-Eintrag in der Datenbank.

2.3 Turnier erstellen

1. Navigiere zu Turniere → Neues Turnier.
2. Fülle das Formular aus:

3. Optional: Lege unter Teilnahmebeschränkungen einen TTR-Bereich und/oder eine Jahrgangsgrenze fest (siehe unten).
4. Optional: Aktiviere Kleines Finale, wenn ein Spiel um Platz 3 ausgetragen werden soll. Die Halbfinal-Verlierer werden automatisch in dieses Spiel eingesetzt.
5. Klicke auf Turnier erstellen. Das Turnier startet im Status Entwurf.

Hinweis: Das Format „Gruppe + KO" wird nicht mehr direkt im Erstellungsformular konfiguriert. Die Gruppeneinstellungen (Anzahl Gruppen, Gruppenstärke) werden erst im Auslosungs-Tab über den Modus-Slider festgelegt.

Im Status Entwurf können alle Einstellungen noch geändert werden. Nach der Auslosung sind Einstellungen gesperrt.

Teilnahmebeschränkungen (optional)

Du kannst für ein Turnier folgende Einschränkungen festlegen:

Alle Felder sind optional. Wenn kein Wert eingetragen wird, gibt es keine Einschränkung.

Hinweis: Einschränkungen können nur im Status Entwurf gesetzt werden. Nach der Auslosung sind sie eingefroren — bestehende Spieler sind davon nicht betroffen.

2.4 Spieler für ein Turnier anmelden

1. Öffne das Turnier unter Turniere → gewünschtes Turnier → Tab Spieler.
2. Alle verfügbaren Spieler aus der Datenbank werden angezeigt.
3. Klicke auf Hinzufügen neben jedem Spieler, der teilnehmen soll.
4. Um einen Spieler zu entfernen, klicke auf Entfernen (nur möglich, solange keine Auslosung stattgefunden hat).

Mindestens 2 Spieler müssen angemeldet sein, bevor die Auslosung gestartet werden kann.

Warnungen bei Teilnahmebeschränkungen

Wenn ein Turnier TTR- oder Jahrgangs-Einschränkungen hat und ein Spieler die Kriterien nicht erfüllt, erscheint eine Warnmeldung beim Einschreiben (kein harter Block — du kannst den Spieler trotzdem anmelden):

Nach der Warnung wirst du gefragt, ob du den Spieler trotzdem einschreiben möchtest. Als Admin hast du immer das letzte Wort.

2.5 Auslosung durchführen

1. Öffne das Turnier → Tab Auslosung.
2. Prüfe, dass alle Spieler korrekt eingetragen sind.

Modus wählen:

3. Verwende den Modus-Slider oben im Tab, um den Turniermodus festzulegen:

4. Bei Gruppe + KO wählst du zusätzlich die Gruppenstärke (z. B. 3er- oder 4er-Gruppen). Das System berechnet automatisch die Anzahl der Gruppen.

Live-Vorschau:

Sobald du den Modus und die Gruppenstärke einstellst, zeigt das System eine Live-Vorschau mit folgenden Informationen:

TTR-Lostöpfe:

Wenn Spieler mit TTR-Werten eingetragen sind, werden sie automatisch in Lostöpfe eingeteilt. Die Töpfe sind farblich unterschieden und sorgen für eine ausgewogene Verteilung der Spielstärke auf die Gruppen.

5. Klicke auf Auslosung starten.
6. Das System generiert die Gruppen- und/oder Bracket-Struktur und verteilt die Erstrundenspiele automatisch auf die verfügbaren Tische.
7. Setze das Turnier auf Aktiv, um es freizuschalten.

Nach der Gruppenphase:

Wenn alle Gruppenspiele abgeschlossen sind, erscheint der Button „KO-Runde starten". Damit werden die qualifizierten Spieler in ein KO-Bracket überführt.

Freilose: Bei ungerader Spieleranzahl erhält der zufällig ausgeloste Spieler ein Freilos und rückt automatisch in die nächste Runde vor.

Achtung: Nach der Auslosung können keine Spieler mehr hinzugefügt oder entfernt werden und die Turniereinstellungen sind gesperrt.

2.6 Turnier durchführen — Übersicht & Tische

Hinweis: Nach der Auslosung wechselt der Tab-Name automatisch von „Auslosung" zu „Tischzuweisung und Spielablauf".

Spielstand verfolgen:

• Auf der Turnier-Detailseite siehst du alle Partien mit aktuellem Status:
  • Ausstehend — noch nicht begonnen
  • Tisch festgelegt — Admin hat einen Tisch zugewiesen, Spiel wartet auf Beginn
  • Läuft — aktuell am Tisch
  • Beendet — Ergebnis eingetragen, Bestätigung ausstehend
  • Bestätigt — von beiden Spielern bestätigt
  • Einspruch — ein Spieler hat widersprochen

Tischzuweisung:

Der Admin weist jedem Spiel einen Tisch zu:

1. Öffne den Tab Tischzuweisung und Spielablauf.
2. Wähle ein ausstehendes Spiel und weise ihm einen verfügbaren Tisch zu.
3. Der Status wechselt auf „Tisch festgelegt" — das Spiel erscheint auf dem zugewiesenen Tablet.

Tisch-Zugang für Schiedsrichter:

Jeder Tisch hat eine eindeutige URL. Diese kann auf dem Tablet-Browser geöffnet werden:

https://[deine-domain]/table/[Tisch-ID]

Die Tisch-ID ist in der Turnierverwaltung einsehbar. Der Zugang zum Tablet erfordert keine Anmeldung — einfach URL öffnen und losspielen.

Nächste Runde freischalten:

• Sobald alle Partien einer Runde bestätigt sind, rücken die Gewinner automatisch in die nächste Runde vor.
• Das Bracket aktualisiert sich automatisch.

2.7 Einsprüche bearbeiten

Wenn ein Spieler ein Ergebnis anficht, erscheint die Partie im Tab Einsprüche des Admin-Dashboards.

Ablauf:

1. Navigiere zu Admin-Dashboard → Tab Einsprüche.
2. Alle strittigen Partien werden tabellarisch angezeigt (Turnier, Spieler, Ergebnis, Einreicher, Zeitpunkt).
3. Klicke auf Bearbeiten neben der entsprechenden Partie.
4. Wähle eine Aktion:

5. Gib eine Admin-Notiz ein (Pflichtfeld bei allen Aktionen) — diese wird zur Dokumentation gespeichert.
6. Klicke auf Entscheidung speichern.

Die Entscheidung wird mit deiner Benutzer-ID und dem Zeitstempel protokolliert.

2.8 Betreuer verwalten

Auf der Seite /admin/betreuer kannst du Spieler manuell Betreuern zuweisen:

1. Wähle links in der Spielerliste einen oder mehrere Spieler aus (Checkbox).
2. Wähle rechts den gewünschten Betreuer aus.
3. Weise die Spieler per Drag & Drop oder über den Zuweisen-Button zu.
4. Mit dem X-Button neben einem Spieler kann die Zuweisung wieder aufgehoben werden.

Admin-Zuweisungen überschreiben bestehende Betreuer-Anfragen und sind sofort wirksam.

2.9 Nutzerverwaltung & Rollenzuweisung

Unter /admin/users siehst du alle Nutzer des Systems und kannst ihnen Rollen zuweisen.

Übersicht:

• Alle Spieler aus der Datenbank werden aufgelistet, inklusive Information ob ein Portal-Konto vorhanden ist.
• Nutzer mit Portal-Konto aber ohne Spieler-Eintrag (z. B. reine Admins) erscheinen ebenfalls.
• Die Liste ist nach Name und E-Mail durchsuchbar.

Rollen zuweisen:

1. Klicke auf den Rollen-Button neben einem Nutzer.
2. Ein Popover mit Checkboxen öffnet sich — wähle eine oder mehrere Rollen:

3. Klicke auf Speichern — die Änderung wird sofort wirksam.

Hinweis: Du kannst deine eigene admin-Rolle nicht entziehen — der entsprechende Button ist gesperrt.

Rollenwechsel für Nutzer mit mehreren Rollen:

Ein Nutzer, dem mehrere Rollen zugewiesen wurden, sieht in seiner jeweiligen Ansicht einen Wechsel-Button:

• Im Admin-Dashboard: „Betreuer-Ansicht" und/oder „Schiedsrichter-Ansicht" (wenn entsprechende Rolle vorhanden)
• Im Betreuer-Dashboard: „Admin-Ansicht" (wenn Admin-Rolle vorhanden)
• Im Schiedsrichter-Dashboard: „Admin-Ansicht" (wenn Admin-Rolle vorhanden)

Rollenwechsel erfordern keine erneute Anmeldung — ein Klick genügt.

Audit-Log:

Alle Rollenzuweisungen werden protokolliert. Das Log ist am unteren Ende der /admin/users-Seite einsehbar und zeigt: Wer hat wann welche Rolle geändert.

2.10 Spielbearbeitung & Kampflos

Spiel manuell bearbeiten:

1. Öffne das Turnier → Tab Bracket oder Spielplan.
2. Klicke auf ein Spiel — das Bearbeitungs-Modal öffnet sich.
3. Folgende Felder sind editierbar:

Achtung: Bei laufenden Spielen (Status „Läuft") erscheint ein Warnhinweis. Änderungen werden trotzdem sofort gespeichert.

Kampflos & Spielbeendigung (Walkover):

Ein Spiel kann auf verschiedene Arten vorzeitig beendet werden:

1. Öffne das Spiel-Modal über den Bracket-Tab.
2. Klicke auf „Kampflos vergeben".
3. Wähle den betroffenen Spieler und den Grund:

4. Gib den aktuellen Score ein — das System ermittelt automatisch den Gewinner und setzt den passenden Status.
5. Der Gewinner wird sofort in die nächste KO-Runde übertragen (Auto-Advancement).

3-Aufrufe-System & Kampflos-Banner:

Sobald ein Spiel den Status „Spielbereit" erhält, startet automatisch ein Aufruf-Zähler:

• Aufruf 1: Sofort bei Spielbereit-Status
• Aufruf 2: Nach 2 Minuten
• Aufruf 3: Nach weiteren 2 Minuten

Wenn nach dem 3. Aufruf kein Spieler erschienen ist, erscheint im Bracket und im Spielplan ein roter „Kampflos möglich"-Banner neben dem betroffenen Spiel. Du kannst dann über das Bearbeitungs-Modal Kampflos vergeben.

2.11 Gruppen-Darstellung (STTV-Format)

Wenn ein Turnier im Modus Gruppe + KO ausgelost wurde, zeigt das System für jede Gruppe drei Ansichten:

Kreuztabelle:

• Zeigt alle Spieler der Gruppe in einer Matrix (Zeilen und Spalten).
• An jeder Kreuzung steht das Ergebnis des direkten Duells (z. B. „3:1").
• Das eigene Feld (Diagonale) ist ausgegraut.
• Format entspricht dem STTV-Standard (Schweizerischer Tischtennisverband).

Runden-Spielplan:

• Listet alle Spiele der Gruppe runden-weise auf.
• Jede Runde zeigt: Paarung, Tisch, Status und Ergebnis.
• Laufende Spiele werden hervorgehoben.

Abschlusstabelle:

Nach Abschluss aller Gruppenspiele wird die Abschlusstabelle berechnet. Die Sortierung erfolgt nach:

1. Siege (absteigend)
2. Satzverhältnis (absteigend)
3. Direktvergleich (bei Gleichstand)

Die Tabelle zeigt pro Spieler: Platzierung, Name, Spiele, Siege, Niederlagen, Sätze (gewonnen:verloren) und Punkte (gewonnen:verloren).

2.12 Nutzerverwaltung & SMTP-Konfiguration

Unter /admin/settings findest du erweiterte Verwaltungsfunktionen.

Mein Konto:

1. Öffne /admin/settings → Tab Mein Konto.
2. Hier kannst du dein eigenes Admin-Passwort ändern:
   • Gib dein aktuelles Passwort ein.
   • Gib das neue Passwort ein (mindestens 8 Zeichen).
   • Bestätige das neue Passwort.
   • Klicke auf Passwort ändern.

Nutzerverwaltung (erweitert):

Über /admin/settings kannst du zusätzlich zur Rollenzuweisung (siehe 2.9):

Hinweis: Du kannst dein eigenes Konto nicht deaktivieren oder löschen.

SMTP-Konfiguration:

1. Öffne /admin/settings → Tab E-Mail / SMTP.
2. Konfiguriere den E-Mail-Server, über den das System Benachrichtigungen versendet:

3. Klicke auf Test-E-Mail senden, um die Konfiguration zu prüfen.
4. Klicke auf Speichern.

Hinweis: Ohne SMTP-Konfiguration können keine E-Mails versendet werden (z. B. Passwort-Reset, Bestätigungs-E-Mails). Die Konfiguration ist für den Produktivbetrieb empfohlen.

2.13 Gruppen-Detailansicht

Im Modus Gruppe + KO kannst du jede Gruppe im Detail einsehen:

1. Navigiere zur Turnier-Detailseite → Tab Gruppen.
2. Klicke auf eine Gruppen-Karte — ein seitliches Panel (Sheet) öffnet sich.

Inhalte des Panels:

Hinweis: Das Panel schließt sich über den X-Button oder durch Klick außerhalb des Panels.

2.14 Öffentlicher Turnier-Zugang (Spectator)

Du kannst den aktuellen Turnierstand mit Zuschauern teilen — ohne dass diese sich anmelden müssen.

Öffentliche Seite:

Jedes Turnier hat eine öffentlich zugängliche Seite unter:

https://[deine-domain]/tournament/[Turnier-ID]

Diese Seite zeigt:

• Gruppenphase: Alle Gruppen mit Kreuztabellen und Abschlusstabellen
• KO-Bracket: Vollständiger Bracket-Baum mit Live-Ergebnissen
• Live-Aktualisierung: Die Seite aktualisiert sich automatisch alle 10 Sekunden
• Vollbild-Modus: Über den Button „Vollbild" kann die Ansicht auf TV oder Monitor im Vollbildmodus angezeigt werden — ideal für Zuschauer-Displays in der Halle
• Auto-Scroll: Über den Auto-Scroll-Button (Doppelpfeil-Icon) wird ein automatisches Pingpong-Scrolling aktiviert — die Seite scrollt langsam von oben nach unten und zurück. Ideal für große Brackets auf TV-Displays. Bei Berührung des Bildschirms pausiert das Scrolling für 5 Sekunden und setzt dann automatisch fort.

Link teilen:

1. Öffne die Turnier-Detailseite im Admin-Dashboard.
2. Klicke auf „Link kopieren" — der öffentliche Link wird in die Zwischenablage kopiert.
3. Alternativ: Klicke auf den QR-Code-Button — ein QR-Code wird generiert, den Zuschauer mit dem Smartphone scannen können.

Hinweis: Für die öffentliche Seite ist kein Login erforderlich. Jeder mit dem Link kann den Turnierstand live verfolgen.

2.15 Tisch-Display (Zuschauer-Anzeige)

Jeder Tisch hat eine eigene Display-Seite unter /display/table/[Tisch-ID], die auf einem Monitor oder Fernseher am Tisch angezeigt werden kann. Sie zeigt in Echtzeit:

• Aktueller Spielstand (Sätze und Punkte, 10rem grosse Ziffern)
• Spieler-Namen und Aufschlag-Anzeige (oranger Punkt)
• Timeout-Status pro Spieler
• Karten-Badges: Gelbe, Gelb-Rote und Rote Karten werden neben dem Spielernamen angezeigt
• Satz-Historie (alle abgeschlossenen Sätze)
• Endergebnis: Nach Spielende wird der Endstand 30 Sekunden lang angezeigt (Sieger hervorgehoben, komplette Satz-Historie inkl. letztem Satz)
• Danach wechselt die Anzeige auf "Bereit" oder das nächste anstehende Spiel

Tipp: Nutze den Vollbild-Modus des Browsers (F11) für eine optimale Darstellung auf TV-Displays.

2.16 API-Dokumentation (Swagger)

Die vollständige REST-API-Dokumentation ist unter /api-docs erreichbar. Sie zeigt alle verfügbaren Endpunkte mit Parametern und Beispiel-Antworten im interaktiven Swagger-UI-Format.

2.17 Urkunden erstellen & drucken

Unter Turniere → gewünschtes Turnier → Tab Urkunden kannst du individuelle Urkunden für die Platzierten erstellen.

Drei Modi stehen zur Verfügung:

Designer-Funktionen:

• Textbausteine: Spielername, Platzierung, Turniername, Datum, Spielklasse, Freitext (mehrfach platzierbar)
• Bildelemente: 13 hochwertige SVG-Symbole (Pokale Gold/Silber/Bronze, Schläger, Ball, Tisch, Rahmen, Lorbeerkranz, Stern, Medaille)
• Drag & Drop: Elemente per Maus verschieben
• Maus-Resize: Bildelemente an der Ecke mit der Maus vergrößern/verkleinern
• Layer-Reihenfolge: Elemente nach vorn/hinten verschieben über das Layer-Panel
• Platzierungs-Zuordnung: Jedes Element kann auf bestimmte Platzierungen beschränkt werden (z. B. goldener Pokal nur für 1. Platz)
• Orientierung: Hochformat oder Querformat wählbar

Drucken:

1. Wähle, ob die Urkunde auch den 4. Platz einschließen soll (Checkbox).
2. Klicke auf Drucken — es wird für jeden Platzierten eine eigene Seite erzeugt.
3. Im Druckdialog des Browsers „Als PDF speichern" wählen oder direkt drucken.

Hinweis: Die Urkundeneinstellungen werden pro Turnier gespeichert. Du kannst sie jederzeit anpassen und neu drucken.

2.18 Abschlussberichte & CSV-Export

Nach Abschluss eines Turniers stehen verschiedene Berichte zur Verfügung:

Admin-Turnierbericht (/admin/tournaments/[id]/report):

• Gesamtübersicht: Teilnehmeranzahl, Format, Datum
• Endplatzierungen (1.–8. Platz je nach Turniergröße)
• Statistiken: Spieldauer, längstes Spiel, Durchschnittswerte
• CSV-Export: Alle Ergebnisse als CSV-Datei herunterladen

Spieler-Turnierbericht (/player/report/[tournamentId]):

• Persönlicher Bericht mit allen eigenen Spielen, Ergebnissen und Endplatzierung
• Druckbar als PDF über den Browser-Druckdialog

Betreuer-Turnierbericht (/coaches/report/[tournamentId]):

• Übersicht aller betreuten Spieler mit deren Ergebnissen und Platzierungen

Tipp: Im Druckdialog „Als PDF speichern" wählen, um den Bericht digital zu archivieren.

2.19 Turnier-Fotogalerie

Teilnehmer, Betreuer, Schiedsrichter und Admins können Fotos zu einem Turnier hochladen und in einer öffentlichen Galerie teilen.

Admin-Ansicht:

Unter Turniere → gewünschtes Turnier → Tab Fotos siehst du als Admin:

• Freigabe-Warteschlange (oben): Fotos, die noch auf deine Freigabe warten — mit Angabe des Grundes (z. B. „Aufnahmedatum weicht ab"). Für jedes Foto: Freigeben oder Ablehnen.
• Freigegebene Fotos (unten): Alle öffentlich sichtbaren Fotos.
• Der Tab zeigt eine Zahl neben „Fotos", wenn Freigaben ausstehen.

Plausibilitätsprüfung:

Beim Hochladen prüft das System automatisch die Foto-Metadaten:

Limits:

• Max. 10 Fotos pro Person pro Turnier
• Max. 100 Fotos pro Turnier insgesamt

Fotos hochladen (Spieler / Betreuer / Schiedsrichter):

1. Öffne dein Dashboard.
2. Klicke auf den Kamera-Button neben dem Turnier.
3. Im Upload-Dialog:
   • Fotos auswählen (Drag & Drop oder Klick) — mehrere gleichzeitig möglich
   • Foto aufnehmen — öffnet direkt die Handy-Kamera (auf Mobilgeräten)
   • Optional: Bildunterschrift eingeben (max. 200 Zeichen)
4. Klicke auf Hochladen — Bilder werden automatisch komprimiert.
5. Ergebnis: grüne Meldung (sofort sichtbar) oder gelbe Meldung (wartet auf Freigabe).

Galerie ansehen:

• Zuschauer: Öffne die öffentliche Turnierseite → Tab Fotos — kein Login nötig.
• Klicke auf ein Foto für die Großansicht (Lightbox) mit Pfeiltasten, Wisch-Gesten und Bildunterschrift.

Hinweis: Fotos werden beim Hochladen automatisch komprimiert und GPS-Daten aus dem gespeicherten Bild entfernt (Datenschutz). Die Metadaten werden nur zur Plausibilitätsprüfung verwendet.

2.20 Dynamisches Doppel

Der Modus Dynamisches Doppel ist ein besonderer Turniermodus, bei dem die Doppelpartner in jeder Runde neu zusammengestellt werden. Am Ende zählt die Einzelwertung — jeder Spieler sammelt individuell Punkte über alle Runden hinweg.

Turnier im Modus „Dynamisches Doppel" erstellen:

1. Navigiere zu Turniere → Neues Turnier.
2. Wähle als Format Dynamisches Doppel.
3. Stelle die Rundenanzahl über den Schieberegler ein (2 bis 15 Runden).
4. Fülle die übrigen Felder wie gewohnt aus (Name, Datum, Startzeit, Veranstaltungsort, Tische).

Option „Mit Vorgabe" (TTR-Handicap):

Wenn die Spieler unterschiedlich stark sind, kannst du die Option „Mit Vorgabe" aktivieren. Das System berechnet dann automatisch ein Handicap basierend auf der TTR-Differenz der beiden Doppelpartner gegenüber den Gegnern.

Der Vorgabe-Kurven-Editor zeigt 10 Drag-Punkte, die du mit der Maus verschieben kannst. Jeder Punkt entspricht einer TTR-Differenz-Stufe und bestimmt, wie viele Vorgabepunkte das schwächere Team erhält. So kannst du die Kurve exakt an das Spielniveau deines Turniers anpassen.

Auslosung:

1. Öffne das Turnier → Tab Auslosung.
2. Klicke auf Auslosung starten — das System generiert automatisch für jede Runde wechselnde Doppelpartner.
3. Die Tischzuweisung funktioniert wie bei anderen Modi mit der grün/rot-Ampel:
   • Grün — Tisch frei, Spiel kann zugewiesen werden
   • Rot — Tisch belegt

Tablet-Ansicht:

Am Tablet werden beide Spieler eines Doppelteams im Format angezeigt:

M. Fuchs / S. Holler  vs.  L. Wagner / K. Braun

Hinweis: Beim Dynamischen Doppel ist keine PIN-Bestätigung durch die Spieler erforderlich (wie beim regulären Doppel).

Ranking (Einzelwertung):

Obwohl als Doppel gespielt wird, erhält jeder Spieler eine individuelle Wertung. Die Sortierung erfolgt nach:

1. Siege (absteigend)
2. Satzdifferenz (gewonnene minus verlorene Sätze)
3. Punktedifferenz (gewonnene minus verlorene Punkte)
4. Direktvergleich (bei Gleichstand zwischen zwei Spielern)
5. TTR-Wert (als letztes Kriterium)

Spectator-Ansicht:

Die öffentliche Turnierseite zeigt für Dynamisches Doppel:

• Ranking-Tabelle mit der aktuellen Einzelwertung aller Spieler
• Aktuelle Runde mit allen laufenden Doppelpaarungen und Live-Ergebnissen

2.21 Venue-Tischpool

Wenn am selben Veranstaltungsort und am selben Tag mehrere Turniere stattfinden, können sich diese einen gemeinsamen Tischpool teilen. So werden physische Tische effizient zwischen den Turnieren aufgeteilt — ohne Konflikte oder doppelte Belegung.

Automatische Pool-Erkennung:

Beim Erstellen eines neuen Turniers prüft das System automatisch, ob am gewählten Veranstaltungsort und Datum bereits ein anderes Turnier existiert. Wenn ja, erscheint ein blauer Hinweis-Banner:

„Am gleichen Ort und Datum existiert bereits ein Turnier. Sie können einem gemeinsamen Tischpool beitreten."

Pool beitreten:

1. Klicke im Hinweis-Banner auf Pool beitreten.
2. Lege fest, wie viele Tische dein Turnier maximal gleichzeitig nutzen darf.
3. Das System teilt die physischen Tische automatisch zwischen den Turnieren auf.

Stabile QR-Codes:

Jeder physische Tisch im Pool erhält einen QR-Code, der den ganzen Tag gültig bleibt — unabhängig davon, welches Turnier gerade auf dem Tisch läuft. Das Tablet muss nicht neu konfiguriert werden, wenn ein Tisch von einem Turnier zum nächsten wechselt.

Pool-Dashboard:

Auf der Turnier-Detailseite findest du einen zusätzlichen Tab Pool-Dashboard. Dort siehst du:

Fließender Tischübergang:

Wenn ein Spiel auf einem Tisch endet, wird dieser automatisch wieder dem Pool zurückgegeben. Andere Turniere können den Tisch sofort für ihre nächsten Spiele nutzen — ohne manuelles Umbuchen.

Schutz vor Doppelzuweisung:

Das System verhindert, dass zwei Turniere denselben Tisch gleichzeitig belegen. Wenn ein Tisch bereits von einem anderen Turnier genutzt wird, ist er für dein Turnier gesperrt (roter Status). So werden versehentliche Überschreibungen ausgeschlossen.

Hinweis: Der Tischpool funktioniert nur, wenn die Turniere denselben Veranstaltungsort und dasselbe Datum haben. Turniere an unterschiedlichen Orten oder Tagen teilen sich keine Tische.

2.22 Tischverwaltung (Live-Übersicht)

Unter /admin/tables sehen Administratoren alle Tische eines Veranstaltungsorts mit Live-Status:

Funktionen:

• Venue-Auswahl: Wähle Ort + Datum — alle Tische des Veranstaltungsorts werden angezeigt
• Live-Polling: Die Ansicht aktualisiert sich automatisch alle 5 Sekunden — ohne manuellen Reload
• Belegungsanzeige: Jede Tischkarte zeigt:
  • Status-Badge: Frei (grün), Reserviert (orange), Belegt (blau)
  • Turniername + Spielnummer
  • Spielernamen mit Satzstand und aktuellen Punkten
  • Einzelne Satz-Ergebnisse als kompakte Badges
• Turnier-Link: Klick auf die Begegnung führt direkt zur Turnier-Detailseite
• Tisch-Anzeige: Monitor-Icon öffnet die Zuschauer-Anzeige des Tisches
• Tischzuweisung aufheben: Bei reservierten Tischen kann die Zuweisung direkt entfernt werden
• Live-Board: Button "Live-Board" öffnet die Venue-weite Zuschauer-Anzeige (siehe 2.23)

Hinweis: Tische die in einem gemeinsamen Tischpool (PROJ-40) liegen, werden turnierübergreifend angezeigt — ein Tisch der in Turnier A belegt ist, erscheint auch in Turnier B als belegt.

2.23 Spectator Live-Board (Venue-Anzeige)

Für Zuschauer gibt es eine Grossanzeige unter /display/venue?location=ORTSNAME&date=YYYY-MM-DD, die auf einem TV oder Beamer im Foyer angezeigt werden kann.

Zugang: Über den Button "Live-Board" in der Tischverwaltung oder der Turnier-Detailseite.

Anzeige:

• Alle Tische des Veranstaltungsorts als Grid (responsive, passt sich an die Tischanzahl an)
• Pro Tisch: Spielernamen, Satzstand, Live-Punktestand
• Farbige Rahmen: Blau = Spiel läuft, Orange = Bereit, Grau = Frei
• Kopfzeile: Veranstaltungsort, Datum, Uhrzeit, Anzahl aktiver Spiele
• Automatische Aktualisierung alle 3 Sekunden

Bedienung:

• Doppelklick wechselt in den Vollbildmodus
• Kein Login erforderlich — die Seite ist öffentlich

2.24 Jeder gegen Jeden (Round Robin)

Neben KO und Gruppe+KO gibt es das Format Jeder gegen Jeden: Alle Spieler spielen gegen alle anderen. Es gibt keine KO-Phase — die Endplatzierung ergibt sich direkt aus der Tabelle.

Turnier erstellen:

1. Unter "Format" → Jeder gegen Jeden wählen
2. Alle anderen Einstellungen (Tische, Satzformat, Restriktionen) wie gewohnt

Auslosung:

Die Info-Karte zeigt die Gesamtzahl der Spiele an (z.B. bei 5 Spielern = 10 Spiele). Klicke auf "Auslosung starten" — die Paarungen werden nach dem Circle-Verfahren erstellt (ausgewogene Reihenfolge).

Tabelle:

Unter dem Spielplan wird eine Live-Tabelle angezeigt mit:

Sortierung: Siege absteigend → Satzdifferenz → Punktdifferenz.

2.25 Turnier kopieren

Jedes Turnier kann als Vorlage für ein neues Turnier kopiert werden.

1. Öffne die Turnier-Detailseite
2. Klicke auf das Kopieren-Symbol (zwei übereinanderliegende Blätter) im Header
3. Ein neues Turnier mit dem Suffix "(Kopie)" wird erstellt
4. Alle Einstellungen werden übernommen: Format, Tischanzahl, Satzformat, Restriktionen
5. Du wirst direkt zum neuen Turnier weitergeleitet

Hinweis: Spieler und Auslosungen werden nicht kopiert — nur die Turnier-Konfiguration.

2.26 Statistik-Dashboard

Unter /admin/stats (erreichbar über "Statistiken" in der Admin-Navigation) siehst du eine Übersicht über alle Turniere:

• KPI-Karten: Gesamtanzahl Turniere, Spieler, Spiele und durchschnittliche Spieldauer
• Turnierformate: Balkendiagramm — wie viele Turniere pro Format (KO, Gruppe+KO, Dynamisches Doppel, Jeder gegen Jeden)
• Turnierstatus: Verteilung Entwurf / Aktiv / Beendet
• Spiele pro Monat: Zeitliche Verteilung der gespielten Spiele
• Letzte Turniere: Die 10 zuletzt erstellten Turniere mit Spieleranzahl und Status (klickbar)

2.27 Mandanten-Verwaltung (Multi-Tenancy)

Das System unterstützt Mandanten (auch „Tenants" genannt). Jeder Mandant ist ein eigenständiger Bereich — z. B. ein Verein oder eine Abteilung — mit eigenen Turnieren, Spielern und Einstellungen. Standardmäßig gibt es einen „Default"-Mandanten, der automatisch angelegt wird.

Was bedeutet das?

Wenn mehrere Vereine dasselbe System nutzen, sieht jeder Verein nur seine eigenen Daten. Turniere, Spieler und Tische sind strikt getrennt. Die Verwaltung der Mandanten ist nur für Super-Admins sichtbar.

Super-Admin Rolle

Nur Benutzer mit der Rolle Super-Admin haben Zugriff auf die Mandanten-Verwaltung. Reguläre Admins sehen nur die Daten ihres eigenen Mandanten und haben keinen Zugriff auf andere Bereiche.

Mandanten-Switcher

Super-Admins sehen im Dashboard-Header ein Dropdown-Menü, mit dem sie zwischen Mandanten wechseln können. Nach dem Wechsel werden automatisch alle Daten (Turniere, Spieler, Tische) des ausgewählten Mandanten geladen.

Mandanten verwalten

Die Mandanten-Verwaltung erreichst du über /admin/tenants (bzw. den Menüpunkt Mandanten in der Admin-Navigation).

Übersicht:

Die Liste zeigt alle Mandanten mit folgenden Informationen:

Neuen Mandanten anlegen:

1. Klicke auf Neuer Mandant.
2. Fülle das Formular aus:
   • Name (Pflicht) — z. B. „TTC Musterstadt"
   • Slug — wird automatisch aus dem Namen generiert (z. B. „ttc-musterstadt")
   • Logo — Vereinslogo hochladen (optional)
   • Primärfarbe — Akzentfarbe für das Branding (optional)
   • Limits — optionale Begrenzungen für Turniere oder Spieler
3. Klicke auf Speichern.

Mandant bearbeiten:

Klicke in der Liste auf den gewünschten Mandanten, um alle Felder zu ändern (Name, Logo, Farbe, Limits).

Mandant löschen:

Ein Mandant kann nur gelöscht werden, wenn er keine aktiven Turniere mehr hat. Beende oder lösche zuerst alle laufenden Turniere des Mandanten.

Tenant-Branding

Jeder Mandant kann ein eigenes Logo und eine Primärfarbe hinterlegen:

• Das Logo wird im Admin-Header anstelle des Standard-Logos angezeigt.
• Die Primärfarbe wird als Akzentfarbe im gesamten Admin-Bereich verwendet.

Admins einem Mandanten zuweisen

Super-Admins können über die Nutzerverwaltung (siehe Abschnitt 2.12) einen Administrator einem bestimmten Mandanten zuweisen. So wird sichergestellt, dass jeder Admin nur die Daten seines Vereins sieht und verwaltet.

2.28 Spieler-Ampelstatus & Tischzuweisung

Jeder Spieler hat einen Live-Status, der als farbiger Punkt neben dem Spielernamen angezeigt wird — in Brackets, Gruppenansichten und Spiellisten.

Statusfarben

Tipp: Wenn du mit der Maus über einen roten Punkt fährst, wird das aktuelle Spiel mit einem Link zum zugehörigen Turnier angezeigt.

Tischverwaltung mit Warteschlange

Die Tischverwaltung erreichst du unter Tische in der Admin-Navigation.

Aufbau:

• Links: Alle Tische des aktuellen Venues mit ihrem Status (frei, belegt, welches Spiel)
• Rechts: Die Warteschlange — alle anstehenden Spiele aller Turniere am selben Venue

Filter in der Warteschlange:

Spiel einem Tisch zuweisen:

• Desktop: Ziehe ein spielbereites Spiel per Drag & Drop auf einen freien Tisch.
• Mobilgerät: Tippe auf ein Spiel in der Warteschlange — es öffnet sich eine Auswahl der freien Tische.

Hinweis: Nur Spiele mit grünem Status (beide Spieler spielbereit) können einem Tisch zugewiesen werden.

2.29 Daten-Export

Unter Einstellungen findest du den Tab Datenexport. Damit kannst du alle Daten deines Mandanten als ZIP-Datei herunterladen.

So funktioniert es:

1. Gehe zu Einstellungen → Tab Datenexport.
2. Klicke auf Alle Daten als ZIP exportieren.
3. Der Download startet automatisch.

Enthaltene Daten:

Wichtig: Der Export enthält keine sensiblen Daten — keine Passwörter, keine PINs, keine Zugangsdaten. Der Export ist konform mit DSGVO Art. 20 (Recht auf Datenübertragbarkeit).

2.30 Spieler importieren (Excel/CSV)

Du kannst Spieler aus einer Datei importieren, anstatt sie einzeln anzulegen.

So funktioniert es:

1. Gehe zur Spieler-Seite in der Admin-Navigation.
2. Klicke auf Spieler importieren.
3. Wähle eine Datei aus:
   • CSV — z. B. ein Export aus click-TT
   • Excel (.xlsx oder .xls) — z. B. die bereitgestellte Vorlage

Erwartete Spalten:

Vorschau vor dem Import:

Nach dem Hochladen siehst du eine Vorschau aller erkannten Spieler:

Erst nach Bestätigung werden die Spieler tatsächlich importiert.

Tipp für Vereine ohne click-TT: Nutze die Excel-Vorlage, die auf der Import-Seite zum Download bereitsteht. Trage die Spielerdaten in die Vorlage ein und lade sie dann hoch.

3. Spieler-Anleitung

3.1 Registrierung

Wenn du noch kein Konto hast, kannst du dich selbst registrieren:

1. Öffne /player/register.
2. Fülle das Formular aus:

3. Klicke auf Registrieren.
4. Du erhältst eine Bestätigungs-E-Mail — klicke auf den Link darin, um dein Konto zu aktivieren.

Wichtig: Dein Konto muss vom Administrator mit deinem Spieler-Datensatz verknüpft werden, bevor du in einem Turnier erscheinst. Informiere den Turnierleiter über deine registrierte E-Mail-Adresse.

3.2 Anmeldung & Passwort vergessen

Anmeldung:

1. Öffne /player/login.
2. Gib deine E-Mail-Adresse und dein Passwort ein.
3. Klicke auf Anmelden — du wirst zum Dashboard weitergeleitet.

Passwort vergessen:

1. Klicke auf der Login-Seite auf Passwort vergessen.
2. Gib deine E-Mail-Adresse ein.
3. Du erhältst eine E-Mail mit einem Reset-Link (gültig für 1 Stunde).
4. Klicke auf den Link und gib ein neues Passwort ein (mindestens 8 Zeichen, zweimal bestätigen).

3.3 Mein Dashboard

Das Dashboard unter /player/dashboard ist deine zentrale Anlaufstelle während des Turniers.

Was du siehst:

• Meine Partien: Alle deine Spiele im aktuellen Turnier, sortiert nach Status
• Aufgerufen-Meldung: Wenn dein Spiel aufgerufen wurde, erscheint ein gelber Banner: „Dein Spiel wurde aufgerufen! → Tisch X". Bei Überschreitung von 10 Minuten wird der Banner rot.
• Gegnerstatus: Siehst du, ob dein nächster Gegner gerade spielt und wie sein aktuelles Ergebnis ist.
• W/L-Bilanz: Siege und Niederlagen deiner Gegner im laufenden Turnier.
• Turnierbeschränkungen: Falls das Turnier TTR- oder Jahrgangs-Einschränkungen hat, werden diese als Badges neben dem Turniernamen angezeigt (z. B. „TTR: 1100–1300", „Jg.: 2005–2010").

Tabs:

Das Dashboard aktualisiert sich automatisch alle 10 Sekunden.

3.4 Spielergebnis bestätigen (PIN)

Nach einer Partie erscheint im Dashboard eine Bestätigungskarte mit dem Ergebnis.

Bestätigung im Portal:

1. Die Karte zeigt: Ergebnis, Gegner, Rundenbezeichnung und dein Ergebnis (Sieg/Niederlage).
2. Klicke auf Ergebnis bestätigen.
3. Gib deine 4-stellige PIN über das Nummernfeld ein.
4. Klicke auf Bestätigen (oder warte, bis das 4. Zeichen eingegeben ist).
5. Bei korrekter PIN erscheint: „Warte auf Bestätigung des Gegners".
6. Sobald auch der Gegner bestätigt hat, wechselt der Status auf „Bestätigt".

Automatische Bestätigung:

Wenn du innerhalb von 5 Minuten nach Spielende nicht bestätigst und keinen Einspruch einreichst, wird das Ergebnis automatisch auf deinen Namen bestätigt. Das System zeigt dir dann: „Automatisch bestätigt (kein Einspruch innerhalb von 5 Minuten)".

PIN-Fehler:

• Nach 3 Fehlversuchen wird die Eingabe gesperrt.
• Du musst dann den Turnierleiter kontaktieren, der deine PIN zurücksetzen kann.

Bestätigung am Tablet:

Wenn du kein Portal-Konto hast oder bevorzugst direkt am Tisch zu bestätigen:

1. Nach Spielende am Tablet erscheint automatisch das Bestätigungsfeld.
2. Spieler 1 gibt seine PIN ein → Spieler 2 gibt seine PIN ein.
3. Nach beiden Bestätigungen erscheint „Ergebnis bestätigt".

3.5 Einspruch erheben

Wenn das eingetragene Ergebnis nicht stimmt:

1. Klicke auf der Bestätigungskarte auf Einspruch erheben.
2. Ein Dialog öffnet sich — du kannst optional einen Kommentar eingeben (max. 500 Zeichen), z. B. „Ergebnis war 3:1, nicht 3:2".
3. Klicke auf Einspruch absenden.

Was danach passiert:

• Das Spiel erhält den Status „Einspruch".
• Der Turnierleiter wird benachrichtigt und bearbeitet den Einspruch im Admin-Dashboard.
• Du siehst in deinem Dashboard: „Einspruch eingereicht. Der Turnierleiter wurde benachrichtigt."
• Nach der Entscheidung des Turnierleiters wird das Ergebnis entsprechend angepasst.

3.6 Profil & PIN verwalten

Unter /player/settings kannst du dein Konto verwalten:

Profil bearbeiten:

• Vorname, Nachname und Verein können geändert werden.
• E-Mail-Adresse ist nicht editierbar.

TTR-Wert & weitere Daten (nur Anzeige):

Im Profil werden zusätzlich folgende Felder angezeigt, die nur vom Admin gepflegt werden können:

Hinweis: Diese Felder sind im Spieler-Portal nicht editierbar. Wende dich an den Turnierleiter, wenn ein Wert korrigiert werden muss.

Der TTR-Wert wird zusätzlich als Badge neben deinem Spielernamen im Dashboard angezeigt, sodass du und andere Spieler die Spielstärke auf einen Blick sehen können.

Passwort ändern:

1. Gib dein aktuelles Passwort ein.
2. Gib das neue Passwort ein (mindestens 8 Zeichen).
3. Bestätige das neue Passwort.
4. Klicke auf Passwort ändern.

PIN ändern:

1. Gib zur Sicherheit dein Passwort ein (nicht die alte PIN).
2. Gib die neue 4-stellige PIN ein.
3. Bestätige die neue PIN.
4. Klicke auf PIN ändern.

Hinweis: Die neue PIN gilt sofort für alle zukünftigen Spielbestätigungen.

3.7 Betreuer verknüpfen

Die Betreuer-Suche findest du direkt auf deinem Dashboard (/player/dashboard), unterhalb der Turnier-Tabs.

Per Name suchen (Standard):

1. Gib mindestens 2 Buchstaben des Vor- oder Nachnamens ein.
2. Klicke auf Suchen oder drücke Enter.
3. Alle passenden Betreuer werden angezeigt — klicke auf Anfrage senden.

Per Coach-ID suchen:

1. Wechsle auf den Tab Per Coach-ID.
2. Gib die 6-stellige Betreuer-ID ein (bekommst du vom Betreuer) und klicke auf Anfrage senden.

Vereinsbetreuer (gleicher Verein) werden automatisch aufgelistet — klicke auf Verknüpfen, kein Code nötig.

Der Betreuer muss die Anfrage in seinem Dashboard bestätigen. Status zeigt: „Anfrage ausstehend" → „Aktiver Betreuer: [Name]".

Eine bestehende Verknüpfung kann jederzeit auf dem Dashboard aufgehoben werden.

4. Betreuer-Anleitung

4.1 Registrierung als Betreuer

1. Öffne /player/register.
2. Aktiviere die Checkbox „Ich bin Betreuer, kein aktiver Turnierspieler".
3. Fülle das Formular aus (Vorname, Nachname, Verein, E-Mail, Passwort).
4. Klicke auf Registrieren und bestätige deine E-Mail-Adresse.

Nach der Registrierung erhältst du eine eindeutige 6-stellige Betreuer-ID (z. B. A3X7KP), die du an deine Spieler weitergeben kannst.

Als Betreuer erscheinst du nicht in Turnier-Teilnehmerlisten. Du hast keinen Spieler-Datensatz und kannst daher nicht in Turnieren angemeldet werden.

4.2 Betreuer-Dashboard

Das Dashboard unter /betreuer/dashboard zeigt dir eine Echtzeit-Übersicht aller betreuten Spieler.

Was du siehst:

• Spieler-Liste: Alle dir zugewiesenen Spieler mit ihrer nächsten Partie (Gegner, Tisch, Runde)
• Live-Spielstand: Für laufende Spiele wird der aktuelle Punktestand aus Spieler-Perspektive angezeigt (orange, gut erkennbar), z. B. „7 : 5". Darunter erscheinen die Satzergebnisse der bisherigen Sätze, z. B. „11:8 · 9:11 · 11:7".
• Tischnummer: Die Tischnummer des laufenden Spiels wird direkt in der Spieler-Karte angezeigt.
• Aufgerufen-Alarm: Wenn ein Spieler aufgerufen wird und noch nicht spielt, erscheint ein Hinweis: „⚠ [Spielername] wurde aufgerufen → Tisch X". Du kannst den Alarm manuell schließen oder er erlischt, wenn das Spiel beginnt.
• Ausstehende Anfragen: Spieler, die dich als Betreuer angefragt haben, erscheinen im Bereich Anfragen.

Das Dashboard aktualisiert sich automatisch alle 10 Sekunden.

4.3 Spieler-Anfragen annehmen

1. Im Tab Anfragen erscheinen alle offenen Anfragen mit Name und Verein des Spielers.
2. Klicke auf Annehmen, um den Spieler deiner Betreuungsliste hinzuzufügen.
3. Klicke auf Ablehnen, um die Anfrage abzuweisen.
4. Mit dem Sperren-Symbol kannst du einen Spieler für zukünftige Anfragen sperren.

4.4 Spieler betreuen & Bracket verfolgen

Bracket-Ansicht:

• Klicke auf den Tab Bracket im Betreuer-Dashboard.
• Das vollständige Turnier-Bracket wird angezeigt.
• Deine betreuten Spieler sind orange hervorgehoben (oranger Ring und Schatten am Spieler-Feld).

Bracket-Popup:

• Klicke auf ein beliebiges Spiel im Bracket — ein Overlay öffnet sich mit:
  • Spielernamen und aktuelles Spielergebnis
  • Satzergebnisse der bereits gespielten Sätze
  • Status-Badge (z. B. „Läuft", „Beendet", „Bestätigt")
• Das Overlay schließt sich mit dem X-Button oder einem Klick außerhalb.

Spieler entfernen:

• Klicke neben einem Spieler auf das Entfernen-Symbol, um die Betreuung zu beenden.

5. Tablet-Bedienung (Spieleingabe am Tisch)

Das Tablet am Tisch dient als Schiedsrichter-Gerät. Es benötigt keine Anmeldung — einfach die URL des entsprechenden Tisches im Browser öffnen.

Zeitslots & Überfälligkeitsanzeige:

Jedes Spiel zeigt den geplanten Beginn als Uhrzeit an (z. B. „14:30 Uhr"). Die Zeitslots werden automatisch vom System berechnet, basierend auf der Turnier-Startzeit, dem Spielformat und der Tischanzahl.

• Pünktlich: Die Uhrzeit wird normal angezeigt.
• Überfällig: Wenn die geplante Startzeit überschritten ist und das Spiel noch nicht begonnen hat, blinkt die Anzeige rosa — sowohl auf dem Tablet als auch im Admin-Dashboard. Dies hilft dem Turnierleiter, Verzögerungen schnell zu erkennen.

Hinweis: Die Zeitslots sind Schätzwerte. Die tatsächliche Spieldauer kann abweichen. Die Berechnung berücksichtigt das Spielformat (Best-of-3/5/7) und die durchschnittliche Satzdauer.

5.1 Aufschlag festlegen

Beim Start eines neuen Spiels erscheint automatisch ein Vollbild-Popup zur Aufschlagauswahl.

• Das Popup zeigt beide Spielernamen mit einer orangenen Schaltfläche.
• Tippe auf den Spieler, der den ersten Aufschlag hat.
• Das Popup schließt sich und das Scoreboard wird freigegeben.

Aufschlag-Anzeige während des Spiels:

• Ein oranger Punkt zeigt immer an, wer gerade aufschlägt.
• Der Aufschlag wechselt automatisch alle 2 Punkte (Regelkonform).
• Im Entscheidungssatz (z. B. Satz 5 bei Best-of-5) wechselt der Aufschlag ab 5:5 nach jedem Punkt.

Hinweis: Das Popup erscheint bei jedem neuen Satz erneut, wenn das Tablet neu geladen wird. Bei einem laufenden Spiel nach Seitenwechsel in der Mitte des Satzes einfach den aufschlagenden Spieler erneut auswählen.

5.2 Spielstand eingeben

Das Scoreboard zeigt links Spieler 1 und rechts Spieler 2.

5.3 Satzende & Spielende

Automatisches Satzende:

• Ein Satz endet automatisch, wenn ein Spieler 11 Punkte erreicht und mindestens 2 Punkte Vorsprung hat.
• Bei 10:10 wird weitergespielt bis zur 2-Punkte-Differenz (Verlängerung).
• Nach Satzende startet automatisch ein 60-Sekunden-Satztimer (Pause zwischen den Sätzen).

Satz-History:

• Alle bereits gespielten Sätze werden in der Mitte des Tablets mit Satznummer und Ergebnis angezeigt (z. B. „1. 11:9", „2. 11:7").
• Die Darstellung ist groß und gut lesbar — auch auf Distanz erkennbar.

Manuelles Satzende:

• Schaltflächen S1 und S2 vergeben einen Satzgewinn manuell (z. B. bei Regelentscheidung des Schiedsrichters).

Spielende:

Das Spiel endet automatisch, wenn ein Spieler die erforderliche Anzahl Sätze gewonnen hat:

• Best-of-3: 2 Sätze
• Best-of-5: 3 Sätze
• Best-of-7: 4 Sätze

Nach dem Spielende erscheint das Ergebnis-Display, gefolgt vom Bestätigungsfeld.

Reset:

• Über die Schaltfläche Reset kann das Spiel komplett zurückgesetzt werden (z. B. bei Fehlstart).
• Es erscheint ein Bestätigungsdialog vor dem endgültigen Reset.

5.4 Auszeit & Timer

• Der Timer wird als Overlay auf dem gesamten Bildschirm angezeigt.
• Nach Ablauf des Timers kehrt das Scoreboard automatisch zur Eingabe zurück.
• Der Auszeit-Indikator neben dem Spielernamen zeigt deutlich sichtbar:
  • Orange / aktiv — Auszeit noch verfügbar
  • Grau / durchgestrichen — Auszeit bereits verbraucht
• Die Anzeige ist auch auf Armeslänge gut erkennbar (großes Format, hoher Kontrast).

5.5 Schiedsrichter-Funktionen

Ein offizieller Schiedsrichter kann das Spiel am Tablet mit einer 4-stelligen PIN übernehmen.

Schiedsrichter-Übernahme:

1. Am unteren Rand des Tablets erscheint die Schaltfläche „Schiedsrichter übernehmen".
2. Klicke darauf — ein Overlay öffnet sich.
3. Gib die 4-stellige Schiedsrichter-PIN ein (vom Turnierleiter erhalten).
4. Nach erfolgreicher Übernahme wird der Schiedsrichtername in der Leiste angezeigt.

Karten ausstellen:

Nach der Übernahme erscheint die Schaltfläche „Karte" in der Schiedsrichterleiste.

1. Klicke auf „Karte" — das Karten-Overlay öffnet sich.
2. Wähle den Spieler und die Kartenfarbe:

Klicke anschließend auf Ausstellen — die Karte wird protokolliert und der Spielstand ggf. angepasst. Das Overlay schließt sich mit dem X-Button.

Satzende durch Kartenpunkt: Wenn der Strafpunkt (Gelb-Rot oder Rot) zum 11. Punkt mit mindestens 2 Punkten Vorsprung führt, wird der Satz automatisch abgeschlossen — inklusive Satzwechsel, Satzpause-Timer und ggf. Spielende. Dies gilt auch für Verlängerungen (ab 10:10).

Karten bei Reset: Beim Zurücksetzen eines Spiels (Reset-Button) erscheint ein zusätzlicher Dialog: "Sollen die ausgesprochenen Karten auch gelöscht werden?" Du kannst wählen zwischen "Karten behalten" und "Karten auch löschen".

Karten auf der Zuschauer-Anzeige: Karten werden auch auf der Tisch-Display-Seite (/display/table/...) neben dem Spielernamen als farbiges Badge angezeigt.

Ergebnis-Bestätigung als Schiedsrichter:

Nach dem Spielende erscheint für den zugewiesenen Schiedsrichter eine zusätzliche Schaltfläche „Ergebnis als Schiedsrichter bestätigen". Diese Bestätigung wird separat protokolliert.

Hinweis: Die Schiedsrichter-PIN ist 4-stellig und numerisch. Sie unterscheidet sich von der Spieler-PIN und wird zentral im Schiedsrichter-Dashboard verwaltet.

5.6 Ergebnisbestätigung am Tablet

Nach dem Spielende erscheint automatisch das Bestätigungsfeld (sequenziell):

Schritt 1 — Spieler 1:

1. Spieler 1 gibt seine 4-stellige PIN über das Nummernfeld ein.
2. Klickt auf Bestätigen.
3. Bei korrekter PIN: ✓ „Spieler 1 hat bestätigt" erscheint.

Schritt 2 — Spieler 2:

1. Spieler 2 gibt seine 4-stellige PIN über das Nummernfeld ein.
2. Klickt auf Bestätigen.
3. Bei korrekter PIN: ✓ „Ergebnis bestätigt — Beide Spieler haben das Ergebnis bestätigt."

Bei Fehler:

• Nach 3 Fehlversuchen wird die PIN-Eingabe gesperrt.
• Es erscheint: „Admin erforderlich — Bitte den Turnierleiter kontaktieren."
• Der Administrator kann die PIN zurücksetzen.

Wenn ein Spieler kein Portal-Konto hat oder vergessen hat zu bestätigen: Das Ergebnis wird 5 Minuten nach Spielende automatisch bestätigt, sofern kein Einspruch eingereicht wurde.

6. Häufige Fragen & Fehlerbehandlung

„Kein aktives Turnier" wird angezeigt: → Der Administrator hat das Turnier noch nicht auf „Aktiv" gesetzt. Bitte den Turnierleiter kontaktieren.

„Spieler-Profil nicht gefunden" nach Login: → Deine E-Mail-Adresse wurde noch nicht mit einem Spieler-Datensatz verknüpft. Gib dem Turnierleiter deine registrierte E-Mail, damit er die Verknüpfung vornehmen kann.

PIN-Eingabe gesperrt: → Du hast 3 Mal die falsche PIN eingegeben. Wende dich an den Turnierleiter, der deine PIN zurücksetzen kann (Admin-Dashboard → Spieler → Schlüssel-Symbol).

Bestätigungsfenster erscheint nicht, obwohl das Spiel beendet ist: → Lade das Dashboard einmal neu (Seite aktualisieren). Das Dashboard pollt alle 10 Sekunden — bei langsamer Verbindung kann es kurz verzögert sein.

Tablet zeigt kein Spiel an / Seite ist leer: → Prüfe, ob die korrekte Tisch-URL geöffnet ist. Stelle sicher, dass dem Tisch eine aktive Partie zugewiesen wurde (sichtbar im Admin-Dashboard → Turnier → Bracket).

WLAN-Verbindung unterbrochen: → Das System kann ohne WLAN nicht genutzt werden. Stelle die Verbindung wieder her und lade die Seite neu. Alle Eingaben seit der letzten Synchronisierung können verloren gegangen sein — überprüfe den Spielstand nach Reconnect.

Einspruch wurde versehentlich eingereicht: → Informiere sofort den Turnierleiter. Ein Einspruch kann im Admin-Dashboard mit der Aktion „Ergebnis bestätigen (Original)" geschlossen werden.

Das Turnier zeigt nach der Auslosung falsche Ergebnisse: → Wende dich an den Administrator. Korrekturen sind über den Einspruchs-Mechanismus oder eine Admin-Überschreibung möglich.

Schiedsrichter-PIN funktioniert nicht / wird abgelehnt: → Die Schiedsrichter-PIN ist 4-stellig und numerisch. Stelle sicher, dass nicht versehentlich die 6-stellige Betreuer-ID oder die 4-stellige Spieler-PIN eingegeben wurde. Die Schiedsrichter-PIN wird im Schiedsrichter-Dashboard unter dem eigenen Profil angezeigt.

Das Aufschlag-Popup erscheint bei jedem Seitenaufruf: → Nur noch bei frischen Matches (Satz 1, kein Punkt gespielt). Nach einem Reload eines laufenden Spiels erscheint das Popup nicht mehr. Bei Doppel-Matches erfolgt die Aufschlagwahl in 3 Schritten: 1. Welches Doppel hat Aufschlag? → 2. Welcher Spieler schlägt auf? → 3. Wer ist Rückschläger? Ab Satz 2 erscheint das Popup erst nach der Satzpause — nur der Aufschläger wird gefragt, der Rückschläger ergibt sich automatisch (DTTB ITR 2.13.7).

Beim Einschreiben eines Spielers erscheint eine TTR- oder Jahrgangs-Warnung: → Das ist kein Fehler — der Spieler erfüllt die Teilnahmebeschränkungen des Turniers nicht vollständig. Als Admin kannst du ihn trotzdem einschreiben, indem du auf „Trotzdem einschreiben" klickst. Die Warnung wird nur protokolliert, verhindert die Anmeldung aber nicht.

Ein Spieler hat keinen TTR-Wert oder keinen Jahrgang eingetragen: → Öffne unter Spieler den Bearbeitungsdialog des Spielers und trage den fehlenden Wert nach. Danach kann die Turnierbeschränkung korrekt geprüft werden.

Wie komme ich zur Login-Seite meiner Rolle? → Öffne die Startseite / im Browser. Im Abschnitt „Direkt einsteigen" findest du Login-Karten für jede Rolle (Admin, Spieler, Betreuer, Schiedsrichter) mit direkten Links.

TTR-Wert wird bei Mouseover auf Spielernamen angezeigt — woher kommt der? → Der TTR-Wert wird vom Admin in der Spielerverwaltung hinterlegt. Im Bracket und in den Gruppentabellen erscheint er als Tooltip (Mouseover auf den Namen).

Wie teile ich den Turnierstand mit Zuschauern? → Öffne die Turnier-Detailseite im Admin-Dashboard und klicke auf „Link kopieren" oder den QR-Code-Button. Die öffentliche Seite unter /tournament/[Turnier-ID] zeigt Gruppen und KO-Bracket live — kein Login nötig. Ideal für TV-Displays mit dem Vollbild-Modus.

Wo sehe ich meinen TTR-Wert? → Im Spieler-Portal unter Profil (/player/settings). Der TTR-Wert wird mit einer farbigen Level-Einordnung angezeigt (Anfänger, Vereinsspieler, Leistungsspieler, Spitzenspieler). Der Wert wird vom Admin gepflegt und ist im Portal nicht editierbar.

Vollbild-Modus am Tablet: → In der Steuerleiste unter dem Spielfeld gibt es einen Vollbild-Button (⛶). Einmal antippen aktiviert den Vollbildmodus, erneutes Antippen oder Escape beendet ihn. Ideal für Tablets und Zuschauer-Displays.

Automatischer Seitenwechsel im Doppel (entscheidender Satz): → Im letzten möglichen Satz (z. B. Satz 3 im BO3) erscheint bei 5 Punkten einer Partei automatisch ein Hinweis zum Seitenwechsel. Die Seiten werden per Klick getauscht. Nach jedem Satzende wird automatisch gewechselt.

Vorgabe-Punkte im Dynamischen Doppel: → Werden in jedem Satz erneut voreingestellt, nicht nur im ersten. Die Vorgabe wird auf dem Tablet angezeigt und in der Aufschlagrotation korrekt berücksichtigt.

Ausgewogene Gruppenspiel-Reihenfolge (Gruppe+KO): → Bei neuen Auslosungen werden Gruppenspiele runden-weise über alle Gruppen verteilt: Runde 1 aller Gruppen, dann Runde 2, usw. So laufen alle Gruppen parallel auf gleichem Fortschritt.

Impressum, Datenschutz & AGB: → Über den Footer der Startseite erreichbar. Bei der Registrierung (Spieler, Betreuer, Schiedsrichter) müssen AGB und Datenschutzerklärung bestätigt werden — der Registrieren-Button ist erst aktiv, wenn beide Checkboxen gesetzt sind.

Tischbelegung im Auslosungs-Tab (alle Formate): → Die Tischzuweisung im Auslosungs-Tab nutzt jetzt überall die gleiche Dropdown-Komponente mit grünen (frei) und roten (belegt) Punkten — auch in der Gruppendetail-Ansicht und bei Jeder-gegen-Jeden. Die Belegung wird pool-weit erkannt: Ein Tisch der in Turnier A belegt ist, erscheint auch in Turnier B als rot markiert.

Karten auf Display + Satzende durch Kartenpunkt: → Gelbe, Gelb-Rote und Rote Karten werden jetzt auf der Tisch-Zuschauer-Anzeige (/display/table/...) als Badge neben dem Spielernamen angezeigt. Wenn eine Gelb-Rote oder Rote Karte zum Satzgewinn führt (11. Punkt mit 2 Vorsprung oder Verlängerung), wird der Satz automatisch abgeschlossen — inkl. Satzpause-Timer und Seitenwechsel.

Reset mit Karten-Option: → Beim Zurücksetzen eines Spiels am Tablet wird in einem zweiten Dialog gefragt, ob die ausgesprochenen Karten ebenfalls gelöscht werden sollen. Diese Option erscheint nur wenn tatsächlich Karten vergeben wurden.

Endergebnis auf Tisch-Display (30 Sekunden): → Nach Spielende zeigt die Tisch-Anzeige den vollständigen Endstand 30 Sekunden lang an — inkl. aller Sätze (auch des letzten entscheidenden Satzes). Danach wechselt die Anzeige zurück auf "Bereit" oder das nächste anstehende Spiel.

Stand: 2026-04-10 — TT-Control Turniersystem MVP