T.O.M. Benutzerhandbuch

"Der T.O.M. Turniermanager ist eine offline-fähige, FIDE-konforme Schach-Software für den Browser, die Turniere lokal verwaltet und Ergebnisse auf Knopfdruck live mit der Vereinshomepage synchronisiert."

Kapitel 1: Die Grundphilosophie & Architektur

1.1 Offline-First: Warum T.O.M. kein Internet braucht

Viele moderne Programme liegen in der Cloud. Fällt das WLAN im Spiellokal aus, steht das Turnier still. T.O.M. geht ganz bewusst einen anderen Weg: Die gesamte Applikation – samt der hochkomplexen FIDE-Auslosungs-Engine – wird beim Öffnen einmalig in deinen Browser (Chrome, Firefox, Edge, Safari) geladen und läuft von da an komplett lokal auf deinem Rechner.

Du könntest das Netzwerkkabel ziehen oder den Laptop in den Flugmodus versetzen und dein Turnier trotzdem bis zur letzten Runde fehlerfrei paaren und beenden.

1.2 Der Browser-Speicher (localStorage)

Wenn T.O.M. offline läuft und keine externe Datenbank nutzt, wo liegen dann die laufenden Turnierdaten? Die Antwort lautet: Im sogenannten Local Storage deines Browsers. Das ist ein winziger, geschützter Speicherbereich direkt auf deiner eigenen Festplatte.

💡 Der "Aus-Versehen-Geschlossen"-Schutz: Weil T.O.M. bei jedem Klick automatisch im Hintergrund speichert, ist ein geschlossenes Fenster kein Weltuntergang. Wenn du aus Versehen den Browser schließt, öffne die Seite einfach wieder. Das Turnier ist exakt da, wo du aufgehört hast.

⚠️ Der PC-Wechsel (Wichtig!): Da die Daten physisch auf deinem Laptop liegen, sind sie nicht automatisch auf dem Vereins-PC verfügbar. Wenn du das Gerät wechseln musst, nutze unten rechts den Button "Export (JSON)". Damit lädst du das komplette Turnier als kleine Datei herunter. Schicke sie dir per E-Mail oder ziehe sie auf einen USB-Stick, öffne T.O.M. am neuen PC und klicke auf "Turnier-Backup laden (JSON)".

1.3 Voller Datenschutz

Ein riesiger Vorteil dieser lokalen Architektur ist der Datenschutz. Da alle Berechnungen (Auslosungen, DWZ-Prognosen, Feinwertungen) lokal auf deinem Prozessor stattfinden, werden niemals heimlich Spielerdaten, Vereinsnamen oder Ergebnisse an fremde Server gesendet. Die Daten gehören zu 100 % dem Verein.

Daten verlassen deinen Laptop nur in genau einem einzigen Fall: Wenn du als Turnierleiter ganz bewusst auf den Button "🌐 Tabelle online stellen" klickst und das Vereins-Passwort eingibst, um die aktuellen Ergebnisse im Internet zu veröffentlichen.

Kapitel 2: Vorbereitung & Meldung

2.1 Einzelne Spieler anlegen & korrigieren

Für kleine Turniere, wie z.B. einen spontanen Blitz-Schach-Abend, reicht es völlig aus, die Spieler händisch über das Formular im oberen Bildschirmbereich einzutragen. Du benötigst mindestens einen Namen; DWZ, ELO und Altersklasse sind optional.

💡 Live-Editierung im laufenden Turnier: Stell dir vor, du hast das Turnier bereits gestartet und in der 2. Runde beschwert sich ein Spieler: "Du hast meinen Namen falsch geschrieben und meine DWZ ist eigentlich 1650!"
Das ist kein Problem. Klicke in der Spielerliste einfach auf den grauen Stift-Button (✏️) neben seinem Namen. Du kannst Name, Verein, AK und DWZ korrigieren. Die Tabelle und alle laufenden Berechnungen aktualisieren sich sofort im Hintergrund.

2.2 Massen-Meldung: Der CSV-Import

Wenn du ein großes Turnier mit vielen Teilnehmern leitest, ist händisches Eintippen fehleranfällig und zeitraubend. Hierfür gibt es den CSV-Import.

Die Vorlage: Klicke zunächst auf "📝 CSV-Vorlage herunterladen". Du erhältst eine Excel-freundliche Datei.
Befüllen: Kopiere eure Vereinsliste in diese Vorlage. Achte darauf, dass die Spalten exakt so heißen wie in der Vorlage (Name, Verein, Altersklasse, DWZ, ELO).
Importieren: Speicher die Datei als `.csv` und lade sie in T.O.M. hoch. Das System importiert alle Spieler in einem Bruchteil einer Sekunde fehlerfrei in die Liste.

2.3 Der Pausen-Modus (Spielfrei ohne Datenverlust)

Im echten Vereinsleben passieren Dinge: Ein Spieler muss in Runde 3 früher nach Hause gehen. Ein anderer hat für den nächsten Spieltag bereits wegen Krankheit abgesagt. Lösche diese Spieler niemals aus dem Turnier! (Das würde die gesamte Buchholz-Wertung ihrer bisherigen Gegner zerstören).

Nutze stattdessen den gelben Button "⏸️ Pausieren" neben dem Spielernamen.

Was passiert dann? Der Spieler wird in der Liste ausgegraut und als [PAUSIERT] markiert. Wenn du die nächste Runde auslost, wird das System diesen Spieler komplett ignorieren. Er erhält keine Partie und kein Freilos.
Was passiert mit seinen Punkten? Er behält alle bisher erspielten Punkte und bleibt in der Gesamttabelle stehen.
Die Rückkehr: Wenn der Spieler in der 5. Runde wieder auftaucht, klickst du einfach auf "▶️ Aktivieren". Er wird sofort wieder ganz normal in die nächste Auslosung mit einbezogen.

Kapitel 3: Turniermodi & Auslosung

3.1 Das Schweizer System (CH)

Das Schweizer System ist der Goldstandard im Schach, wenn du viele Teilnehmer, aber nur begrenzt Zeit (Runden) hast. T.O.M. nutzt eine vollwertige, FIDE-konforme Engine für die Auslosung.

Gegner-Zuweisung: Das System paart immer Spieler mit möglichst gleicher Punktzahl gegeneinander. Niemand spielt zweimal gegen denselben Gegner.
Automatischer Farbausgleich: T.O.M. achtet strikt darauf, dass kein Spieler dreimal hintereinander dieselbe Farbe (Weiß/Schwarz) bekommt und das Gesamtfarbverhältnis im Gleichgewicht bleibt.
Freilose: Bei ungerader Teilnehmerzahl erhält in jeder Runde der punkteschwächste Spieler ein Freilos (1 Punkt). T.O.M. garantiert, dass niemand im gesamten Turnier mehr als ein Freilos bekommt.

3.2 Rundenturnier (Round-Robin)

Der klassische Modus "Jeder gegen Jeden". Ideal für kleine, feste Gruppen (z.B. eine Finalgruppe).

Sobald du das Turnier startest, berechnet T.O.M. sofort im Hintergrund alle Runden bis zum Ende durch und verteilt die Farben mathematisch fair. Du klickst dich danach im laufenden Betrieb einfach nur noch von Runde zu Runde und trägst die Ergebnisse ein.

3.3 Fischer Random (Chess960)

Für Turniere ohne Eröffnungstheorie bietet T.O.M. volle Chess960-Unterstützung. Wenn du beim Start den Haken bei "Chess960" setzt, ändert sich die Turniersteuerung leicht.

🎲 Der Startstellungs-Generator:
Vor jeder neuen Runde erscheint ein Würfel-Button. Ein Klick darauf lost eine der 960 offiziellen Startstellungen (z.B. ID 412) für alle Bretter dieser Runde aus. T.O.M. generiert automatisch den passenden FEN-Code und liefert einen Direktlink zum Lichess-Editor, falls du die Stellung über den Beamer an die Wand werfen oder analysieren möchtest.

3.4 Volle Kontrolle: Der Manuelle Modus

Es gibt Situationen, in denen die Automatik nicht weiterhilft. Vielleicht möchtest du ein historisches Turnier exakt nachbauen, oder zwei Kinder müssen heute gegeneinander spielen, weil sie nächste Woche im Urlaub sind. Dafür gibt es den Manuellen Modus.

Brett für Brett: Du aktivierst beim Start den Schalter "Manuelle Paarung". T.O.M. baut nun keine automatischen Runden, sondern gibt dir für jede Runde leere Auswahlfelder.
Du entscheidest: Du wählst für jedes Brett gezielt aus, wer Weiß und wer Schwarz hat. Du bestimmst auch manuell, wer das Freilos erhält.
Sicherheits-Check: T.O.M. passt trotzdem auf! Das System warnt dich sofort mit einer Fehlermeldung, wenn du einen Spieler versehentlich an zwei Brettern gleichzeitig einteilst oder jemanden gegen sich selbst spielen lässt.

Kapitel 4: FIDE-Mathematik & Feinwertungen

Wenn zwei Spieler am Ende eines Turniers punktgleich sind, entscheiden die sogenannten Feinwertungen (Tie-Breaks) über die Platzierung. T.O.M. berechnet diese vollautomatisch nach den offiziellen FIDE-Regeln. Du kannst alle Wertungen über die Checkboxen über der Tabelle live ein- und ausblenden.

4.1 Die klassischen Buchholz-Wertungen (BHZ)

Buchholz (BHZ): Die Summe der Endpunktzahlen aller Gegner, gegen die ein Spieler angetreten ist. Wer gegen stärkere Gegner gespielt hat (die am Ende viele Punkte gesammelt haben), hat eine höhere BHZ und wird besser platziert.
Buchholz Cut-1 (BHZ-1): Wie die normale Buchholz, aber das Ergebnis des schwächsten Gegners wird gestrichen. Das gleicht den Zufall aus, falls man in der 1. Runde gegen einen blutigen Anfänger spielen musste.
Feinbuchholz (FBHZ): Hierbei wird die Summe der Buchholz-Punkte aller Gegner addiert. Das ist die "Tiefe" der Feinwertung.
Sonneborn-Berger (SB): Wird fast ausschließlich bei Rundenturnieren verwendet. Man bekommt die vollen Punkte der Gegner, die man besiegt hat, und die halben Punkte der Gegner, gegen die man Remis gespielt hat.

4.2 Das Problem ungespielter Partien: "Virtuelle Gegner"

Früher gab es im Schweizer System ein großes Problem: Wenn man ein Freilos (1 Punkt) bekam oder ein Gegner kampflos absagte, hatte dieser "Gegner" am Ende des Turniers logischerweise 0 Punkte. Die eigene Buchholz-Wertung wurde dadurch ruiniert, obwohl man selbst nichts dafür konnte.

T.O.M. nutzt zur Lösung die moderne FIDE-Regel C.04.3.2 (Virtuelle Gegner). Ist diese Checkbox aktiviert, wendet das System einen mathematischen Trick an:

🧮 So rechnet der "Virtuelle Gegner":
T.O.M. tut so, als hättest du in dieser Runde gegen einen fiktiven Spieler gespielt, der genau deine Stärke hat. Dieser virtuelle Gegner "startet" mit deiner Punktzahl und spielt in den folgenden Runden theoretisch immer Remis. Am Ende des Turniers steuert dieser virtuelle Gegner eine absolut faire, durchschnittliche Punktzahl zu deiner Buchholz-Wertung bei. Du wirst also nicht mehr für Freilose oder kampflose Siege bestraft!

4.3 Der "Half-Point Bye" (Der halbe Punkt für Pausen)

Wenn ein Spieler (wie in Kapitel 2 beschrieben) pausiert, weil er keine Zeit hat, bekommt er für diese Runde normalerweise 0 Punkte. In vielen internationalen Turnieren (und immer häufiger auch im Verein) möchte man berufstätigen Spielern entgegenkommen.

Setzt du den Haken bei "Half-Point Bye", weist das System allen pausierenden Spielern für ungespielte Runden automatisch 0,5 Punkte zu. Auch hier berechnet die Engine im Hintergrund saubere virtuelle Gegner, damit die Feinwertung nicht verzerrt wird.

4.4 Live-Switches (Feinwertungen im laufenden Betrieb ändern)

Ein großer Vorteil von T.O.M. ist die völlige Flexibilität. Du musst dich nicht starr vor dem Turnier festlegen.

Wenn ihr am letzten Spieltag im Verein diskutiert, ob ihr Buchholz oder Buchholz Cut-1 werten wollt, kannst du die entsprechenden Checkboxen über der Tabelle einfach anklicken. Das System rechnet das gesamte Turnier in einer Millisekunde neu durch und passt die Rangliste live an, ohne dass Daten verloren gehen.

Kapitel 5: Veröffentlichung & Web-Archiv (Web-Sync)

T.O.M. speichert alle Daten primär lokal auf deinem PC. Um die Tabellen jedoch für Vereinsmitglieder, Eltern oder Zuschauer im Internet zugänglich zu machen, verfügt die Anwendung über ein intelligentes, datenbankgestütztes Web-Sync-System.

5.1 Das Prinzip: Lokales Turnier trifft Web-Pool

Das System arbeitet mit einer MySQL-Datenbank auf eurem Webserver. Anstatt starre HTML-Seiten per FTP hochzuladen, werft ihr die Tabellen einfach in einen gemeinsamen "Pool". Jedes im Internet freigegebene Turnier erhält dort eine eindeutige, fortlaufende Nummer – die Web-ID.

5.2 Ein neues Turnier online stellen

Wenn du ein Turnier (z.B. die neue Schnellschachmeisterschaft) zum ersten Mal ins Internet bringen möchtest, gehst du wie folgt vor:

Scrolle unter der Tabelle nach ganz unten. Der Button leuchtet grün und heißt "🌐 Tabelle online stellen".
Klicke darauf. T.O.M. fragt dich einmalig nach dem Upload-Passwort (SKG-Live-2026).
Als Nächstes gibst du den Namen des Turniers ein, so wie es im Internet über der Tabelle stehen soll (z.B. "Schnellschach-Meisterschaft 2026").
Das Ergebnis: Der Server legt das Turnier neu in der Datenbank an und weist ihm z.B. die ID 12 zu. T.O.M. zeigt dir sofort ein Fenster mit einem fertigen HTML-iframe-Code an. Kopiere diesen Code für den Homepage-Betreuer.

5.3 Der automatische Live-Ticker (ID 0)

Was passiert im Hintergrund, wenn du ein Turnier online stellst? T.O.M. erledigt zwei Dinge auf einmal:

Es speichert deine Tabelle unter ihrer eigenen Nummer (z.B. ID 12).
Es überschreibt gleichzeitig eine spezielle, reservierte Tabellenzeile mit der ID 0.

Die ID 0 ist euer universeller Vereins-Live-Ticker. Der Webmaster bindet diesen Ticker einmalig auf der Startseite eurer Homepage ein (.../turnier.php?id=0). Egal, welcher Turnierleiter freitags oder samstags im Verein auf "Online stellen" oder "Aktualisieren" klickt: Der Ticker auf der Startseite schaltet völlig automatisch immer auf das aktuellste Turnier um. Du musst dafür niemals den Homepage-Code anfassen!

5.4 Parallele Turniere aktualisieren

Sobald dein Turnier einmal registriert wurde, speichert T.O.M. die zugewiesene Web-ID tief im Gehirn des Turniers ab. Der Button unten rechts färbt sich blau und heißt ab sofort: "🔄 Live-Tabelle aktualisieren". Daneben steht permanent eure ID (z.B. Web-ID: 12).

Wenn du in der nächsten Woche die nächste Runde spielst und Ergebnisse einträgst, klickst du einfach auf diesen blauen Button. Das System schießt die aktualisierte Tabelle im Hintergrund lautlos auf den Server. Es gibt keine Popups und keine erneuten Passwortabfragen mehr. Die Tabelle im Netz ist sofort aktuell.

👥 Parallele Turniere auf eigenen Unterseiten:
Da jedes Turnier seine eigene ID behält (z.B. die Vereinsmeisterschaft ID 12 und die parallele Jugend-Meisterschaft ID 13), kommen sich die Turniere niemals in die Quere. Der Webmaster kann die Vereinsmeisterschaft fest unter id=12 auf der Hauptseite einbinden, während die Jugend-Tabelle über id=13 sauber auf der Jugendseite dargestellt wird.

5.5 Langfristige Datenpflege: Vom Web-Pool in die Chronik

Der Web-Pool ist für aktuelle und dynamische Tabellen gedacht, die sich während des Turnierverlaufs ständig ändern. Er ist kein unendlicher Müllschlucker. Sobald ein Turnier komplett beendet, der Sieger gekürt und "Gras über die Sache gewachsen" ist, sollte der Pool aufgeräumt werden.

Der saubere Workflow für den Abschluss:

TXT-Export sichern: Der Turnierleiter öffnet das beendete Turnier in T.O.M. und klickt auf "📝 Als TXT exportieren". Er erhält eine sauber formatierte Text-Tabelle.
Statische Chronik füttern: Diese Text-Tabelle wird vom Homepage-Betreuer kopiert und als fester, unveränderlicher Text in euer historisches Vereinsarchiv (eure Chronik für Berichte) eingepflegt. Ab diesem Moment wird kein iframe mehr benötigt.
Pool bereinigen (Admin-Aufgabe): Der Admin loggt sich später im geschützten T.O.M.-Dashboard ein, sieht alle IDs aufgelistet und löscht das alte Turnier mit einem Klick aus der MySQL-Datenbank. Damit ist die ID wieder frei, die Datenbank bleibt blitzschnell und die alten iframes auf der Homepage laufen ins Leere, während das Turnier sicher in eurer Vereinschronik verewigt ist.