RankFair – Ligasystem & Ligaverwaltung für Darts, Kegeln, Poker & Turniere

RankFair ist ein Elo‑Ranking‑System für Freizeit‑Ligen (Darts, Kegeln, Turniere, Poker). Alles läuft in einer einfachen Web‑Oberfläche.

Dashboard & Ligen

• Neue Liga anlegen unter „Create League“. Owner wird automatisch League‑Admin.
• Spieler hinzufügen (optional mit Start‑Elo), später weitere Nutzer in die Liga einladen (pro Liga eigene Rollen).
• Ligeneinstellungen: Umbenennen, Privatsphäre, Premium, Spieltyp (Standard/Darts/Bowling/Poker) je nach Berechtigung.
• „Letzte Spiele“ und Rangliste werden live aktualisiert.

Rollen & Einladungen

• Rollen: Owner, League‑Admin, User (pro Liga), plus globale Admins.
• Einladungen per E‑Mail; Rechte gelten immer nur innerhalb der gewählten Liga.

Ranking‑System (Elo)

• Einzel: klassischer Elo‑Abgleich mit K=32 (Erwartungswert basierend auf Rating‑Differenz).
• Doppel: pro Spieler wird die Änderung aus zwei hypothetischen Singles gegen beide Gegner gemittelt.
• Verwaltungseinträge (z. B. Kegeln‑Extras) können 0‑Elo‑Spiele erzeugen.

Premium & Administration

• Premium hebt Limits (z. B. Spieleranzahl) an und schaltet Komfortfunktionen frei.
• Admins verwalten Nutzer, Ligen und Premium‑Status.

Spiele eintragen (Elo)

1. Auf der Liga‑Übersicht „Record Game“ öffnen.
2. „Single“ oder „Doubles“ wählen.
3. Spieler zuordnen, Sieger/Verlierer festlegen, optional Notiz.
4. Absenden → Elo wird angepasst; Δ ist in „Letzte Spiele“ sichtbar.

Turniere

• Formate: KO, Elimination, Round‑Robin/League, Platzierung.
• Seeding: gesetzt, zufällig oder manuell; Bracket‑Größen & Runden begrenzen.
• Matches spielen (z. B. mit Darts‑Integration) oder Ergebnisse manuell eintragen.

Zufälliger Spieltag

• Anwesenheit markieren, automatische Paarungsvorschläge (Queue), Matches starten.
• Alle neu Anwesenden werden mindestens einmal eingeplant; Queue passt sich dynamisch an.

• Modi 301/501, Einzel/Doppel, Best‑of, Starterwahl.
• Eingabe als Score oder Rest, Bust/No‑Score, automatischer Zugwechsel.
• Double‑Out‑Prüfung, 3‑Dart‑Average, Darts Used.

Bedienung

• Keypad, „Rest“-Umschalter, Undo mit Bestätigung, Ende‑Dialog.
• Gültigkeit: Score ≤ Rest, Rest≠1, Max‑Score 180, Double‑Out nötig.

Turniere mit Darts

• Turnier‑Match „Spielen“ öffnet das Darts‑Setup mit vorbefüllten Spielern.
• „Fortsetzen“ setzt laufende Partien fort; Ergebnisse fließen ins Bracket.

Spieler & Einstellungen

• Spieler in der Liga pflegen, dann Kegel‑Einstellungen konfigurieren.
• Kategorien (Elo±, €), Reihenfolge, Regeln „auf andere anwenden“, Extras & Notizen.
• „Zahlungsphase“: bezahlt markieren, Undo für Admins, Abschluss bei allen bezahlt.

• Nachdem die Spieler angelegt wurde, kann man das Kegel‑Setup starten und die Einstellungen öffnen.
• Diese müssen vor dem ersten Kegeln einmalig eingetragen werden, können später aber beliebig angepasst werden.

• Hier kann man die Strafen Kategorien beliebig festlegen und eine Strafe hinterlegen, die später beim Kegeln dazugerechnet wird. Negative Strafen wären auch möglich.
• Die Elo Punkte, wleche abgezogen oder dazugerechnet werden können ebenfalls hinterlegt werden. Dies ist nur wichtig für das Liga Ranking.

• Es können auch Kategorien für alle Spieler angelegt werden. Diese werden dann bei den anderen Spielern hinzugefügt oder abgerechnet

• Es können auch Kategorien für alle Spieler angelegt werden. Diese werden dann bei den anderen Spielern hinzugefügt oder abgerechnet

• Nun kann das Kegel Spiel gestartet und die anwesenden Spieler ausgewählt werden.

• Eine Übersicht der Spieler erscheint und deren Strafe wird angezeigt.
• Klickt man auf die Spielerzeile öffnen sich die Strafen und die Anzahl kann mit einem klick auf + erhöht werden. Bei den Liga Administratoren erscheint auch ein - um die Strafe wieder zückgängig zu machen.

• Sonstige Strafen können manuell bei den Spielern hinzugefügt werden.

• Ist ein Kegel Spieltag abgeschlossen, kann ein Liga Admin die Zahlungsphase starten und die Spieler abhaken, welche bezahlt haben.
• Sobald alle Spieler bezahlt haben, kann der Kegel Spieltag abgeschlossen werden und taucht in der Liste als abgeschlossen auf

Lobby & Sitze

• Admins fügen Spieler als Sitze hinzu; Spieler können Seats claimen/leave (außer während einer aktiven Runde).
• Reihenfolge der Sitze bestimmt Dealer/SB/BB‑Rotation; Änderungen nur zwischen Runden.

Dealer & Rundenablauf

• Dealer‑Steuerung: Start (Austeilen), Flop, Turn, River, Nächste Runde.
• Zwischen Runden kann der Dealer gesetzt werden; während Runden ist die Lobby schreibgeschützt.

Live‑Updates

• Echtzeit via SSE; UI synchronisiert sich auf allen Clients.
• Auto‑Reload hält Fokus/Ansicht (Dealer‑Panel, Kartenanzeige) konsistent.