Benutzerhandbuch

SnookerPro kennt drei Rollen mit unterschiedlichen Rechten:

🔐 Anmelden

Klicke oben rechts auf Login oder den Anmelden-Button in der Übersicht. Die Anmeldung erfolgt je nach Rolle:

• Admin: Benutzername (oder Admin-E-Mail) + Passwort
• Nutzer: E-Mail-Adresse + selbst gesetztes Passwort (nach Einladung)
• Betrachter: Kein Login nötig — einfach „Als Betrachter fortfahren"

👥 Nutzerverwaltung

Unter System → Nutzer-Verwaltung können Nutzer eingeladen werden:

1. Nutzer anlegenName und E-Mail eingeben → „📧 Einladung senden". Der Nutzer erhält einen Link per E-Mail (48h gültig).
2. AktivierungDer Nutzer klickt den Link, setzt sein Passwort und ist sofort aktiv.
3. ZugriffsanfragenBetrachter können über die Übersichtsseite Zugang anfragen. Die Anfrage erscheint als orangefarbenes Badge im Topbar und in der Nutzerverwaltung.

⚙️ Systemeinstellungen

Die zentrale Spielerdatenbank verwaltet alle Spieler des Vereins. Neue Turnierteilnehmer werden von hier ausgewählt.

➕ Spieler hinzufügen

1. Name eingebenDuplikat-Warnung erscheint automatisch bei ähnlichen Namen.
2. Verein & PunkteOptional: Vereinszugehörigkeit und bestehende Ranking-Punkte eintragen.
3. Foto hochladenPNG/JPG/GIF/WebP, max. 5 MB. Erscheint in Spielerkarten und Live-Ansicht.
4. Setzung★-Symbol markiert gesetzte Spieler, die bevorzugt auf Gruppen verteilt werden.

⚙️ Konfiguration

Beim Anlegen eines neuen Turniers wird zuerst der Typ gewählt:

👥 Teilnehmer

1. Spieler suchenLinke Spalte: Alphabetische Liste der gesamten Spielerdatenbank. Suchfeld oder Alphabet-Leiste nutzen.
2. HinzufügenEinfacher Klick auf einen Spieler fügt ihn hinzu (✓-Haken). Nochmaliger Klick entfernt ihn wieder.
3. Startgeld & GSTRechts in der Teilnehmertabelle: individuelle Beträge und Bezahlt-Checkboxen anpassen.
4. Setzung★-Button für gesetzte Spieler — werden bei der Auslosung auf verschiedene Gruppen verteilt.

🎲 Auslosung

Voraussetzungen für die Auslosung:

• Turniername eingetragen
• Reset-PIN gesetzt (4 Ziffern)
• Mindestens 8 Teilnehmer
• Status: „Vorbereitung"

Bei abweichender Teilnehmerzahl passt das System die Gruppenaufteilung automatisch an. Ein 5-sekündiger Countdown gibt die Möglichkeit zum Abbrechen. Nach der Auslosung ist keine Neuauslosung ohne Reset möglich.

Die Gruppenansicht zeigt alle Gruppen mit Tabellen und darunter alle Partien sortiert nach Status (Live → Ausstehend → Abgeschlossen).

📝 Ergebnisse eintragen

1. Score eingebenIn die Frames-Felder der Partie-Karte klicken und Zahl eingeben. Tab-Taste springt zum nächsten Feld.
2. Partie bestätigenBei eindeutigem Ergebnis öffnet sich automatisch ein Bestätigungs-Modal. Dort können optional Breaks eingetragen werden.
3. Ergebnis korrigieren✎-Button an abgeschlossenen Partien öffnet den Edit-Dialog (Score + alle Breaks neu eingeben).

🎯 Breaks eintragen

1. Wert eingebenBreak-Eingabefeld (min. 30, max. 147) in der Mitte der Partie-Karte.
2. Zuordnen← Pfeil = Spieler links, → Pfeil = Spieler rechts.
3. EntfernenKlick auf ✕ am Break-Badge löscht den Eintrag.

⏱ Timer & Tische

Laufende Partien erscheinen in einem Live-Banner am oberen Rand aller Ansichten (auch für Betrachter sichtbar).

🏆 Gruppenranking

Reihenfolge bei Punktgleichstand:

1. Gesamtpunkte (Sieg = 2, Niederlage = 0)
2. Direktvergleich (Head-to-Head)
3. Framedifferenz gesamt
4. Gewonnene Frames gesamt
5. Breaks 30+
6. Höchster Break
7. Shootout-Ergebnis (manuell eintragbar)

🔄 Zweite Gruppenphase

Bei Turnieren mit 2 Phasen qualifizieren sich die besten Spieler aller Gruppen für Phase 2. Das System verteilt sie automatisch auf neue Gruppen nach dem Topf-System (Gruppensieger werden getrennt, keine zwei Spieler aus derselben Phase-1-Gruppe). Nach Phase 2 folgt die Finalrunde.

Nach Abschluss aller Gruppenspiele wird die Finalrunde ausgelost. Das System erstellt automatisch einen K.O.-Baum (Viertelfinale, Halbfinale, Finale).

1. AuslosenButton „🎲 Finalrunde auslosen" erscheint wenn alle Gruppenspiele abgeschlossen sind. Gesetzte Spieler werden nach Snake-System verteilt, Spieler aus gleichen Gruppen werden getrennt.
2. Partien spielenErgebnisse und Breaks wie in der Gruppenphase eintragen. Sieger werden automatisch in die nächste Runde eingetragen.
3. TurnierbaumVisueller Bracket oben in der Ansicht, klappbar pro Runde.
4. FinaleNach dem Finale wird der Champion angezeigt. Turnier kann nun abgeschlossen werden.

1. „🏁 Turnier abschließen" klickenNur möglich wenn alle Finalrunden-Partien abgeschlossen sind.
2. Jackpots werden gutgeschriebenCentury-, Charity-, Jahres- und GST-Jackpots werden automatisch dem Saison-Konto addiert.
3. Ranking-PunktePunkte nach Platzierung + Frame-Bonus + Break-Bonus werden ins Saison-Ranking übernommen.
4. AbschlussberichtUnter dem Tab „Abschluss" gibt es eine vollständige Übersicht mit Ranking, Ergebnissen, Breaks und Finanzen — als HTML downloadbar.

Der Tab „Saison" zeigt das kumulierte Gesamtranking aller Turniere der aktuellen Saison.

📅 Saison-Verwaltung

• Mehrere Saisons möglich (Format: YYYY-YY, z.B. 2024-25)
• Admin kann in der Seitenleiste zwischen Saisons wechseln oder neue anlegen
• Aktive Saison wird in der Config gespeichert und gilt für alle Nutzer

💰 Jackpots

Der Simplon GP ist das Saisonfinale für die Top 8 der Jahresrangliste. Er wird als eigenständiger Turnier-Typ angelegt.

1. Top 8 aus RanglisteDas System lädt automatisch die acht bestplatzierten Spieler der Saison. Ausgefallene Spieler können durch Nachrücker ersetzt werden.
2. AuslosungAutomatisch (Glücksrad-Animation) oder manuell. Gruppenköpfe (#1 und #2 der Rangliste) sind gesetzt.
3. GruppenphaseWie normale Gruppenphase — Ergebnisse, Breaks, Timer, Tische.
4. KO-Phase startenNach allen Gruppenpartien → „⚔️ KO-Phase starten" (mit PIN). Halbfinalpaarungen werden automatisch gesetzt.
5. Halbfinale → FinaleErgebnisse eintragen, Sieger zieht automatisch weiter. Champion wird prominent angezeigt.

Der Team Cup ist ein eigenständiger Turnier-Typ für Mannschafts-Snooker. Zwei Spieler bilden ein Team; die Partien werden nach dem Round-Robin-Prinzip (Berger-System) ausgetragen, gefolgt von einer KO-Finalrunde mit Halbfinale, optionalem Platz-3-Spiel und Finale.

⚙️ Turnier anlegen & Setup

Ein neuer Team Cup wird über den Button „🤝 Team Cup" in der Turnierübersicht erstellt. Im Setup-Dialog werden alle grundlegenden Parameter festgelegt:

👥 Teams verwalten

Nach dem Anlegen des Turniers befindet es sich in der Setup-Phase. Hier werden die teilnehmenden Teams eingetragen.

1. Team hinzufügen Über „+ Team" öffnet sich ein Dialog. Teamname eingeben, dann Spieler 1 und Spieler 2 aus der Spieler-Datenbank wählen. Bis zu 10 Teams möglich.
2. Team bearbeiten Über das Stift-Symbol neben einem Team. Nur in der Setup-Phase möglich — sobald die Auslosung gestartet ist, können Teams nicht mehr geändert werden.
3. Team entfernen Über das Papierkorb-Symbol. Ebenfalls nur in der Setup-Phase möglich.

📊 Gruppenphase

Die Gruppenphase startet mit der Auslosung (Reset-PIN erforderlich). Die Teams werden zufällig auf die Gruppen verteilt; alle Begegnungen werden automatisch per Berger-Algorithmus in optimierten Runden angeordnet.

Tabellenwertung

🎱 Partien & Frames

Jede Partie besteht aus mehreren Frames, die abwechselnd als T (Einzel) und E (Doppel) gespielt werden. Das genaue Muster hängt vom gewählten Spielmodus ab:

In der KO-Phase wird immer Best of 5 gespielt — unabhängig vom Gruppenphase-Modus.

Partie starten & Ergebnisse eintragen

1. Partie starten Den grünen „▶ Start"-Badge unterhalb des Scores antippen. Der Timer startet und zeigt Uhrzeit + Laufzeit an (z.B. ▶ 14:30 (12:15)). Der Badge wird rot und zeigt ■ zum Stoppen.
2. Frame-Ergebnisse eintragen In jeder Frame-Zeile die Scores für links und rechts eingeben. Mit der Tab-Taste gelangt man direkt zum nächsten Eingabefeld. Der Gesamt-Score (oben in der Karte) aktualisiert sich automatisch.
3. Breaks erfassen Unter jedem Frame befindet sich eine HB-Eingabe (Höchster Break). Wert (30–147) eingeben und auf „+" drücken. Breaks können mit dem × wieder gelöscht werden.
4. Partie abschließen Wenn alle Frames eingetragen sind, auf „✓ Abschließen" drücken. Das System prüft ob alle Frames vollständig ausgefüllt sind und ob das Ergebnis gültig ist. Der Sieger wird automatisch ermittelt und die Tabelle aktualisiert.

⚔️ KO-Phase & Finale

Sobald alle Gruppenpartien abgeschlossen sind, erscheint automatisch ein Popup mit der Qualifikanten-Übersicht und dem Button zum Starten der KO-Phase.

1. KO-Phase starten Im Popup „⚔️ Finalrunde starten" klicken. Die Qualifikanten werden automatisch nach der Tabellenwertung ermittelt und die Halbfinalpaarungen gesetzt. Reset-PIN ist erforderlich.
2. Halbfinale Beide Halbfinale werden gleichzeitig angezeigt. Ergebnisse werden genauso eingetragen wie in der Gruppenphase — alle 5 Frames, dann abschließen. Der Sieger zieht automatisch ins Finale, der Verlierer ins Platz-3-Spiel.
3. Spiel um Platz 3 Wenn beim Setup aktiviert: Die beiden HF-Verlierer spielen um den dritten Platz. Läuft parallel zum Finale.
4. Finale Nach Abschluss des Finales wird der Team-Cup-Sieger prominent angezeigt. Das Turnier wechselt in den Status „Abgeschlossen".

🔄 Reset & Verwaltung

1. Backup erstellenSystem → Datensicherung → „💾 Backup jetzt erstellen". Eine JSON-Datei mit allen Daten wird automatisch heruntergeladen und im Ordner data/backup/ gespeichert.
2. Inhalt des BackupsSpielerdaten, alle Turniere aller Saisons, Konfiguration (ohne Passwörter und Pins), Saison-Daten.
3. WiederherstellenJSON-Backup-Datei hochladen → „↻ Wiederherstellen". Die aktuellen Daten werden vollständig überschrieben.

💡 Nützliche Tipps

• QR-Code: Die Seitenleiste zeigt einen QR-Code der direkt auf das aktive Turnier verlinkt — ideal zum Ausdrucken oder Teilen.
• Live-Ansicht: Betrachter sehen laufende Partien im Live-Banner oben ohne sich anzumelden.
• Tab-Navigation: In den Ergebnisfeldern mit Tab-Taste zwischen Frame 1 → Frame 2 → Break-Eingabe navigieren.
• Offline-Betrieb: SnookerPro läuft lokal — kein Internet nötig während des Turniers.
• Drucken: Abschlussberichte können direkt gedruckt oder als HTML-Datei gespeichert werden (Menü „Abschluss").
• Autosave: Änderungen werden automatisch alle 30 Sekunden gespeichert. Der goldene Punkt signalisiert ungespeicherte Änderungen.

🔧 Häufige Probleme