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"

Ein 5-sekündiger Countdown gibt die Möglichkeit zum Abbrechen. Nach der Auslosung ist keine Neuauslosung ohne Reset möglich.

Gruppenaufteilung

Das Setup zeigt je nach Teilnehmerzahl alle möglichen Gruppenaufteilungen im Dropdown an — wählbar vor der Auslosung. Die Regeln:

• Gruppengröße: 3–6 Spieler pro Gruppe, mindestens 2 Gruppen
• Vorauswahl: Konfigurationen mit einer 2er-Potenz Finalisten-Anzahl (4, 8, 16, 32) werden bevorzugt
• Ab 24 Spielern: Standard ist 8 Gruppen (→ 16 Finalisten)
• Mehr Gruppen bevorzugt: Bei gleicher Finalisten-Anzahl werden Konfigurationen mit mehr (kleineren) Gruppen zuerst angezeigt

Beispiele für die Vorauswahl:

Auslosungsregeln (Phase 1)

• Gesetzte Spieler (★) werden gleichmäßig auf verschiedene Gruppen verteilt — jeweils einer pro Gruppe
• Nicht gesetzte Spieler werden zufällig ausgelost, wobei Spieler desselben Vereins möglichst auf verschiedene Gruppen verteilt werden
• Vereinsklausel: Das System versucht, Häufungen von Spielern aus dem gleichen Verein zu vermeiden. Bei unvermeidlichen Kollisionen wird die Gruppe mit der geringsten Häufung gewählt

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 (Topf 1) werden getrennt — nicht zwei Gruppensieger in einer Gruppe
• Keine zwei Spieler aus derselben Phase-1-Gruppe in einer Phase-2-Gruppe
• Vereinsklausel: Spieler desselben Vereins werden nach Möglichkeit auf verschiedene Gruppen verteilt (weiche Bevorzugung)

Nach Phase 2 folgt die Finalrunde.

Nach Abschluss aller Gruppenspiele wird die Finalrunde ausgelost. Das System erstellt automatisch einen K.O.-Baum mit der nächsten 2er-Potenz an Plätzen (z.B. 16 oder 32); fehlende Plätze werden als Freilose (Bye) aufgefüllt.

1. AuslosenButton „🎲 Finalrunde auslosen" erscheint wenn alle Gruppenspiele abgeschlossen sind. Gruppensieger werden auf feste Positionen (Seeds) im Bracket gesetzt. Alle übrigen Qualifikanten werden zufällig ausgelost — je zur Hälfte in das obere und das untere Tableau, sodass sich Gruppensieger und Nicht-Gesetzte frühestens im Halbfinale begegnen.
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

Pool-Turniere werden über pool.php aufgerufen. Die Oberfläche ist identisch mit der Snooker-App — der einzige Unterschied liegt im Konfigurationsdialog, der beim Anlegen eines neuen Turniers die Disziplin abfragt.

🎱 Disziplinen

Beim Anlegen eines Turniers öffnet sich ein Auswahl-Dialog mit sechs Disziplinen:

📊 Scoring & Format

Das Format variiert je nach Disziplin. Das System stellt automatisch das passende Standard-Bestof vor:

Dart-Turniere werden über dart.php gestartet. Beim Anlegen eines Turniers öffnet ein Konfigurationsdialog mit Modus- und Formatwahl. Die restliche Turnierverwaltung (Gruppenphase, KO, Ranking) ist identisch zur Snooker-App.

🎯 Spielmodi

Es stehen acht Spielmodi zur Verfügung, aufgeteilt in klassische x01-Formate und Spezialspiele:

x01-Formate (501 · 301 · 701)

Der Spieler startet mit dem jeweiligen Punktestand und muss exakt auf Null reduzieren. Abschluss muss auf einem Doppelfeld oder dem Bullseye erfolgen (Double-Out). Ein Überziehen (Bust) annulliert den Zug.

Für x01-Modi kann zusätzlich das Spielformat gewählt werden:

• Nur Legs: Best of X Legs direkt — wer zuerst die Mehrheit gewinnt, gewinnt das Match.
• Sets + Legs: Best of X Sets, jeder Set Best of Y Legs — für längere Formate auf Profi-Niveau.

Spezialspiele

⚙️ Format & Jackpots

Alle x01-Modi zeigen beim Ergebniseintrag eine Checkout-Anzeige mit dem besten Weg zum Finish (z.B. „T20 · T20 · Bull" für 170 = Big Fish). Bekannte Checkouts erhalten automatisch ihren Namen.

Dart-Jackpots funktionieren analog zu den Snooker-Jackpots und können frei konfiguriert werden. Standardmäßig sind vier Töpfe vorgesehen:

Das Liga-Modul ist in alle drei Sport-Apps (Snooker, Pool, Dart) integriert und wird über den Tab „🏆 Liga" in der Übersicht aufgerufen (liga.php). Im Gegensatz zum Team Cup ist die Mannschafts-Liga für den laufenden Spielbetrieb über eine ganze Saison ausgelegt — mit festem Spielplan, Spieltagen und Tabelle.

➕ Liga anlegen

1. Liga erstellen Tab „Liga" öffnen → „+ Neue Liga" → Name, Sport (Snooker/Pool/Dart), Spielmodus (A: 3 Spieler · 9 Einzel; B: 4 Spieler · 8 Einzel) eingeben.
2. Mannschaften hinzufügen Pro Mannschaft: Name und Spieler aus der Spielerdatenbank zuweisen. Jede Mannschaft braucht mindestens 3 (Modus A) bzw. 4 (Modus B) Spieler.
3. Spielplan generieren „Spielplan erstellen" → Hin- und Rückrunde wählen → Das System berechnet alle Begegnungen nach dem Berger-System und legt die Spieltage an.
4. Liga aktivieren Status auf „Aktiv" setzen — erst dann sind Ergebnisse einzutragen und die Liga öffentlich sichtbar.

📝 Spieltage & Ergebnisse

Jeder Spieltag enthält eine oder mehrere Begegnungen. Ergebnisse werden auf Einzelspiel-Ebene eingetragen:

Neben dem Ergebnis kann ein freier Spielbericht (Text) pro Begegnung eingetragen werden, der in der Ligaansicht erscheint.

🔧 Vertagung & Editor-Einladung

Vertagung: Ein Spieltag kann mit Begründung auf einen neuen Termin verschoben werden. Kaptiäne können eine Vertagung beantragen; der Liga-Verwalter genehmigt sie. Der alte und neue Termin werden protokolliert.

Editor einladen: Über „Einladungslink generieren" erhält ein Team-Kapitän einen Link, mit dem er sich als Editor der Liga anmelden kann. Er darf dann ausschließlich die Ergebnisse seiner eigenen Begegnungen eintragen und den Spielbericht ergänzen — alle anderen Ligadaten sind schreibgeschützt.

Das Community-Board ist ein internes Feedback- und Ideenforum, erreichbar über den Tab „📝 Community" in der Hauptnavigation. Beiträge sind für alle Betrachter sichtbar; das Schreiben steht allen offen.

✍️ Beitrag schreiben

1. Kategorie wählen Vor dem Schreiben eine Kategorie aus der Leiste auswählen: Verbesserungsvorschlag, Lob, Kritik, Frage oder Sonstiges.
2. Name & Text eingeben Namen eingeben (Pflicht) und Beitrag formulieren (max. 2000 Zeichen). Ein Zeichenzähler zeigt den verbleibenden Platz.
3. Absenden „Absenden" klicken. Der Beitrag wird als ausstehend gespeichert und erscheint zunächst nur für Admins sichtbar.

🔑 Admin-Moderation

Admins sehen neben jedem ausstehenden Beitrag zwei Schaltflächen:

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