🎯 Turnier.Golf – Benutzerhandbuch

Club: Der Ort/die Organisation (z.B. "Golfclub Bergheim") – du kannst einen oder mehrere Clubs anlegen.

Platz: Ein einzelner Golfplatz (z.B. „Championship Course") – gehört zu einem Club und hat mehrere Abschläge (Rot, Weiß, Blau, Gelb).

Jeder Platz hat mehrere Abschläge mit verschiedenen Schwierigkeitsgraden. Ein Abschlag speichert:

• Par-Score (z.B. 72)
• Handicap-Index (Schwierigkeit relativ zu Par)
• Course Rating (Schwierigkeit aus Golfer-Perspektive)
• Slope Rating (Variabilität, wie schwierig es für unterschiedliche Spieler ist)

Jeder Platz mit jedem Abschlag hat 18 Löcher (oder 9 bei 9-Loch-Plätzen). Ein Loch speichert:

• Par (z.B. 4)
• Handicap (Schwierigkeit relativ zu anderen Löchern)
• Länge (Meter vom Abschlag bis zum Grün)

Deine Kontaktliste bei Turnier.Golf. Jeder Spieler hat:

• Name, Geschlecht, Handicap (Pflicht)
• E-Mail (optional)
• Heimat-Golfclub (optional)

💡 CSV- oder YAML-Import/Export: Du kannst deine Spielerliste aus Excel oder YAML importieren und exportieren.

Ein Turnier ist eine Veranstaltung mit:

• Name & Beschreibung
• Datum & Platz
• Turnier-Format (Zählspiel oder Stableford)
• Teilnehmer (ausgewählt aus den Spielern)
• Status: Planung → Durchführung → Abgeschlossen

✅ Keine Limits: Erstelle so viele Turniere wie du möchtest – unbegrenzt und kostenlos!

Nach Start des Turniers:

• Jeder Teilnehmer erhält eine individuelle Scorecard
• Schnelle Erfassung der gespielten Scores
• Alternativen: „Keine Scorecard" (nicht teilgenommen) oder „X" in Stableford

Automatische Auswertung:

• Brutto-Ergebnis: Summe aller Schläge
• Netto-Ergebnis: Brutto minus Spielvorgabe
• Stableford-Punkte (wenn gewählt)

Platz anlegen

1. Navigiere zu "Plätze" → Klick auf "Neuen Platz anlegen"
2. Platz-Wizard nutzen:
   • Wähle vorhandenen Club oder erstelle neuen
   • Gib Platz-Name ein (z.B. "Championship Course")
   • Wähle 9 oder 18 Löcher
   • Optional: Beschreibung hinzufügen
3. Abschläge definieren: Gib im Formular bis zu 5 Abschläge ein (z.B. Gelb, Weiß, Blau)
   • Für jeden Abschlag: Farbe, Geschlecht, Par, Course Rating, Slope Rating, Länge
   • "🏌️ Abschlag hinzufügen" Button zeigt schrittweise neue Formulare
4. Speichern: Klick "💾 Speichern & fortfahren"
5. Löcher editieren: Nach dem Speichern: Klick auf "✏️ Löcher bearbeiten" bei jedem Abschlag um Par, Handicap, Länge pro Loch einzutragen

Öffentliche Plätze nutzen vs. Meine Kopie erstellen

Quick-Browse im Turnier nutzen

Wenn du ein Turnier erstellst und noch keinen Platz hast:

1. Klicke im Turnier-Formular auf "🔍 Browse" neben dem Platz-Dropdown
2. Auswahlfenster öffnet sich mit allen öffentlichen Plätzen
3. Nutze das Suchfeld um Plätze zu filtern
4. Klicke "✅ Auswählen" → Platz wird im Formular gesetzt
5. Fahre mit der Turniererstellung fort - kein Seitenwechsel nötig!

YAML Import/Export

• Import: → Zur Import-Seite → YAML-Datei hochladen
• Export: Platz-Detailseite → "Export" Button
• Format-Beispiele:
  • 18-Loch Beispiel herunterladen
  • 9-Loch Beispiel herunterladen

Spieler manuell anlegen

1. Navigiere zu "Spieler" → "Neuen Spieler anlegen"
2. Pflichtfelder ausfüllen:
   • Vorname, Nachname
   • Geschlecht (wichtig für Abschlag-Zuordnung)
   • Aktuelles Handicap (z.B. 18.5)
3. Optional: Email, Telefon, Geburtsdatum
4. Speichern → Spieler ist sofort verfügbar

Spielerliste: Sortierung & Seitengröße

• Die Spielerliste kann über die Tabellenköpfe sortiert werden (z.B. Name, Handicap, Heimatclub, DGV-Nummer).
• Über "Pro Seite" kannst du zwischen 20 / 50 / 100 / Alle Einträgen wählen.
• Die gewählte Seitengröße bleibt beim Blättern und Sortieren erhalten.

CSV Import

1. Navigiere zu: "Spieler" → "Import"
2. CSV-Datei hochladen (oder YAML)

CSV Format

Pflichtfelder: Vorname, Nachname, Geschlecht, Handicap

Optionale Spalten: Email, Heimatclub, DGV-Nummer, Club-Mitgliedsnummer, Zusatz

Geschlechts-Formate

Duplikat-Handling (Intelligentes Merge)

Falls ein Spieler mit gleichem Vorname+Nachname+Zusatz bereits existiert:

• ✅ Handicap: Wird automatisch aktualisiert, ohne Rückfrage
  • Änderung wird in der Handicap-Historie erfasst
  • Du siehst keine Konflikte dafür
• ⚠️ Andere Felder: Bei unterschiedlichen Daten bekommst du Konflikte angezeigt
  • Überschreiben: Importdaten ersetzen die bestehenden Daten
  • Überspringen: Behalte bestehende Daten, ignoriere Import-Daten
• 📊 Zusammenfassung nach Import:
  • Neue Spieler: Wurde mit allen Import-Daten erstellt
  • Handicap aktualisiert: Handicap automatisch angepasst
  • Unverändert: Keine Unterschiede gefunden, kein Update nötig
  • Weitere Unterschiede: Conflicts, die du manuell auflösen musst

Auto-Matching bei DGV/E-Mail (harte Priorität)

• Wenn bei gleichem Namen eine exakte DGV-Nummer oder exakte E-Mail gefunden wird, ordnet das System den Spieler automatisch zu.
• Diese Fälle erscheinen nicht als manueller Konflikt und werden in der Import-Zusammenfassung als auto-zugeordnet gezählt.

Strikte DGV-Mismatch-Regel

• In diesem Fall kannst du den Import-Datensatz nur überspringen oder als neuen Spieler mit Zusatz anlegen.
• Andere Spieler im selben Import werden weiterhin normal verarbeitet.
• So wird verhindert, dass Daten versehentlich dem falschen Spieler zugeordnet werden.

Erweiterte Konfliktlösung

• Überspringen: Bestehender Datensatz bleibt unverändert.
• Aktualisieren: Importdaten überschreiben bestehende Daten (nur wenn kein DGV-Mismatch vorliegt).
• Neuanlage mit Zusatz: Es wird ein separater Spieler angelegt (z.B. "Senior", "II", "Junior").
• Bestehenden Spieler auswählen: Bei mehreren gleichnamigen Einträgen kann gezielt ein Kandidat aus der Liste gewählt werden.

Spalten-Header (flexibel)

Die Spalten können auf Deutsch oder Englisch benannt sein:

• Vorname / First_Name / firstname
• Nachname / Last_Name / lastname
• Geschlecht / Gender
• Handicap / HCP / Handicap_Index
• Email / E-Mail
• Heimatclub / Home_Club
• DGV-Nummer / DGV_Number

Handicap aktualisieren

1. Spieler-Detailseite aufrufen
2. Klick "Bearbeiten" Button oben rechts
3. Ändere das Handicap-Feld und speichere
4. Handicap-Historie wird automatisch aktualisiert und angezeigt
5. Auf der Spieler-Detailseite siehst du die letzten 10 Handicap-Änderungen

Mehrfach-Löschen von Spielern

1. Öffne Spieler in der Navigation
2. Markiere die gewünschten Einträge über die Checkboxen in der ersten Spalte
3. Optional: Nutze "Alle auswählen" im Tabellenkopf
4. Klicke "Ausgewählte löschen" und bestätige die Sicherheitsabfrage

Der Live-Zähler neben dem Button zeigt dir jederzeit, wie viele Spieler aktuell ausgewählt sind.

Handicap-Historie & Rückgängig-Funktion

Die Handicap-Historie zeigt alle Änderungen mit Datum und Uhrzeit:

• ✅ Zeitstempel (auto): Jede Änderung wird mit dem exakten Zeitpunkt erfasst
• ✅ Mehrfach-Änderungen am gleichen Tag: Unterschiedliche Zeiten machen jede Änderung eindeutig
• ✅ Rückgängig-Button: Der Button zeigt die neueste Änderung und kann diese sicher löschen
• ✅ Automatische Zurückgsetzung: Nach dem Löschen wird das Handicap auf den vorherigen Wert zurückgesetzt

Turnier anlegen

1. Grunddaten:
   • Name (z.B. "Sommerturnier 2026")
   • Datum
   • Platz auswählen (oder Quick-Browse nutzen)
   • Spielformat: Stableford oder Zählspiel
   • Anzahl Löcher: 9 oder 18
2. Teilnehmer hinzufügen:
   • Mehrfachauswahl möglich (Ctrl+Klick oder Shift+Klick)
   • Jedem Teilnehmer einen Abschlag zuordnen
   • Max. Teilnehmer optional begrenzen
3. Durchführung planen:
   • Startart: Kanonenstart oder Tee Time (zeitversetzter Start)
   • Flights generieren: Wähle einen Algorithmus, um automatisch Gruppen zu bilden:
     • Nach HCP sortiert (reihum verteilt):
       Beste und schwache Spieler werden gleichmäßig verteilt.
       Z.B. 9 Spieler (HCP: 5, 8, 10, 12, 15, 18, 20, 24, 28) → 3er Flights:
       Flight 1: HCP 5, 12, 20 | Flight 2: HCP 8, 15, 24 | Flight 3: HCP 10, 18, 28
     • Nach Stärke gruppiert:
       Beste Spieler zusammen im ersten Flight, schwache im letzten.
       Z.B. gleiche 9 Spieler → 3er Flights:
       Flight 1: HCP 5, 8, 10 | Flight 2: HCP 12, 15, 18 | Flight 3: HCP 20, 24, 28
     • Zufällig: Reine Zufallsverteilung der Spieler
     • Gemischt (HCP + Zufall): Spieler werden zuerst nach HCP sortiert, dann innerhalb von 8er-Gruppen gemischt (balanciert zwischen Fairness und Zufall)
     • Manuell (ohne Zuordnung): Keine automatische Zuordnung - du ordnest später manuell zu
   • Flightgröße: 3er, 4er Flights oder gemischte 3-4er
   • Startzeiten/Startloch: Pro Flight definieren (automatisch berechnet oder manuell)

Ergebnisse erfassen

1. Turnier-Detailseite → "Ergebnisse erfassen"
2. Wähle Teilnehmer aus Liste
3. Trage Scores pro Loch ein:
   • Stableford: Punkte (0, 1, 2, 3, ...) oder "X" für Strich
   • Zählspiel: Anzahl Schläge pro Loch
4. Speichern → Automatische Auswertung (Brutto/Netto)

Ergebnisse anzeigen & exportieren

• Ergebnisliste: Turnier-Detailseite → Button "Ergebnisse anzeigen"
• PDF Export:
  • Ergebnisliste (komplett)
  • Alle Detail-Ergebnisse (Einzel: eine Seite pro Teilnehmer, Team: eine Seite pro Team)
  • Einzel-Scorekarte (für einen Spieler)
  • Scorekarten-Stapel (leere Vordrucke für alle Teilnehmer)

📊 Turnier-Status erklärt

Der Status zeigt den aktuellen Zustand des Turniers an. Du kannst ihn in den Turnier-Details jederzeit ändern.

Wofür ist das gedacht?

Mit diesen Einstellungen kannst du die Ergebnislisten an typische Club- und Freundschaftsturniere anpassen:

• Handicap-Klassen für getrennte Netto-Wertungen
• getrennte Damen-/Herren-Wertung
• Brutto- und Netto-Preise
• Doppelpreisausschluss zwischen Brutto und Netto
• geschlechter- und klassenbezogene Darstellung in Webseite und PDF

Wo du die Einstellungen findest

Handicap-Klassen einrichten

1. Öffne das gewünschte Turnier.
2. Gehe auf Handicap-Klassen.
3. Aktiviere Handicap-Klassen verwenden.
4. Lege die Klassen mit Name und maximalem Handicap an.

Typisches Beispiel:

• Klasse A bis 11,4
• Klasse B bis 18,4
• Klasse C bis 26,4
• Klasse D offen

Damen-/Herren-Wertung aktivieren

Die getrennte Damen-/Herren-Wertung wird in der Durchführungsplanung im Bereich Wertungseinstellungen aktiviert.

Wenn diese Option aktiv ist:

• wird die Brutto-Wertung in getrennten Tabellen für Damen und Herren ausgegeben
• wird die Netto-Wertung zusätzlich nach Geschlecht getrennt
• können Preise getrennt nach Damen und Herren markiert werden

Preise konfigurieren

1. Öffne die Seite Preise.
2. Aktiviere Preise verwenden.
3. Lege die Anzahl der Brutto-Preise fest.
4. Lege fest, wie viele Netto-Preise je Wertungsgruppe vorgesehen sind.

Welche Netto-Gruppen es gibt, hängt von der Turnier-Konfiguration ab:

• ohne Handicap-Klassen und ohne Geschlechtertrennung: eine Netto-Gesamtwertung
• mit Handicap-Klassen: eine Netto-Wertung je Klasse
• mit Geschlechtertrennung: getrennte Netto-Wertung Damen/Herren
• mit Handicap-Klassen und Geschlechtertrennung: getrennte Netto-Wertung je Klasse und Geschlecht

Wie die Preisvergabe fachlich abläuft

1. Zuerst wird die Brutto-Wertung ermittelt.
2. Danach werden die Brutto-Preisgewinner markiert.
3. Anschließend entstehen die Netto-Wertungsgruppen je nach aktiver Konfiguration.
4. Dann greift der Doppelpreisausschluss.
5. Zum Schluss werden die Netto-Preise innerhalb jeder Gruppe vergeben.

Doppelpreisausschluss

Ein bereits prämierter Brutto-Gewinner bleibt in der Netto-Liste sichtbar, wird dort aber als nicht preisberechtigt markiert.

• Die Netto-Platzierung bleibt sichtbar.
• Der Spieler wird in der Netto-Liste entsprechend gekennzeichnet.
• Der Netto-Preis geht an den nächsten preisberechtigten Spieler derselben Gruppe.

Gleichstand und Kartenstechen

Kartenstechen wird nur innerhalb derselben Vergleichsgruppe angewendet.

• ohne Klassen und ohne Geschlechtertrennung: innerhalb der Gesamtwertung
• mit Handicap-Klassen: nur innerhalb derselben Handicap-Klasse
• mit getrennter Damen-/Herren-Wertung: nur innerhalb desselben Geschlechts
• mit Klassen und Geschlechtertrennung: nur innerhalb derselben Klasse und desselben Geschlechts

Wenn kein Kartenstechen aktiv ist und auf dem letzten Preisrang Gleichstand besteht, erhalten alle punktgleichen Spieler auf diesem Rang einen Preis. Im PDF und auf der Webseite wird dann für alle Betroffenen derselbe Rang angezeigt, zum Beispiel 1. oder 2..

Darstellung in Webseite und PDF

• Brutto und Netto werden farblich markiert.
• Bei getrennter Damen-/Herren-Wertung gibt es in Brutto zwei eigene Tabellen.
• Netto-Wertungen werden je aktiver Gruppe separat dargestellt.
• Fußnoten zu Kartenstechen stehen direkt unter dem jeweiligen Brutto- oder Netto-Block.
• Im PDF startet der Netto-Bereich nach Möglichkeit auf einer neuen Seite, und Tabellen werden möglichst zusammengehalten.

Praxisbeispiel

Was ist Kartenstechen?

Wenn mehrere Spieler nach 18 (oder 9) Löchern das gleiche Ergebnis haben, entscheidet das Kartenstechen über die Platzierung. Statt ein Stechen auf dem Platz zu spielen, werden bestimmte Löcher der eingereichten Scorecard nach einem festen Schema ausgewertet.

Die drei DGV-Varianten

Turnier.Golf bietet dir drei offizielle DGV-Methoden zur Auswahl:

Besonderheiten bei Netto-Zählspiel

Bei Netto-Wertung wird im Kartenstechen die Spielvorgabe anteilig auf die verglichenen Löcher angewendet. Das System berechnet dies automatisch nach DGV-Vorgaben:

• 18-Loch-Turnier: 9 Löcher = 1/2 Course Handicap, 6 Löcher = 1/3, 3 Löcher = 1/6, 1 Loch = 1/18.
• 9-Loch-Turnier: 6 Löcher = 2/3 des 9-Loch-Course-Handicaps, 3 Löcher = 1/3, 1 Loch = 1/9.
• Die anteiligen Werte werden mathematisch gerundet (HALF_UP).

Wie stelle ich das ein?

1. Beim Turnier erstellen oder bearbeiten
2. Checkbox "Kartenstechen für Rangliste aktivieren" ankreuzen
3. Kartenstechen-Variante aus Dropdown wählen
4. Fertig! Die Rangliste berücksichtigt bei Gleichstand automatisch die gewählte Variante

Persönliche Runde starten

1. Navigiere zu Persönliche Runden in der Hauptnavigation oder direkt zur Übersicht.
2. Klicke auf "Neue Runde".
3. Wähle Platz, Abschlag und Datum.
4. Wähle 18 Löcher (ganze Runde) oder 9 Löcher.
5. Optional: Handicap und Notizen eintragen.
6. Speichern und direkt in die Score-Eingabe wechseln.

9-Loch-Runden: Besonderheiten

• Echte 9-Loch-Plätze: Nur Löcher 1-9 verfügbar (keine Front/Back-Auswahl nötig)
• Verdoppelte Plätze: Wenn ein 9-Loch-Platz auf 18 Löcher erweitert wurde, kannst du wählen:
  • Front Nine (Löcher 1-9)
  • Back Nine (Löcher 10-18)
• Score Differential: Bei 9-Loch-Runden wird automatisch die offizielle DGV/WHS-Formel für 9-Loch-Runden angewendet:
  • SD (9-Loch) = SD (gespielte 9 Löcher) + SD (berechnete 9 Löcher)
  • Die Berechnung erfolgt automatisch

Scores eingeben

• Die Eingabe erfolgt lochweise für Front Nine (1-9) und Back Nine (10-18).
• Bei 9-Loch-Runden werden nur die entsprechenden Löcher angezeigt.
• N.R. (Keine Wertung) kann pro Loch gesetzt werden.
• Nach dem Speichern werden Summen und Auswertung automatisch aktualisiert.

Auswertung und Verwaltung

• Detailseite zeigt Brutto, Netto, Stableford und Score Differential.
• Runden können später bearbeitet oder gelöscht werden.
• Die Übersicht kann nach Platz gefiltert werden.

Schneller arbeiten

• Öffentliche Plätze nutzen: Statt jeden Platz neu anzulegen, nutze öffentliche Plätze oder erstelle eine Kopie
• CSV Import für viele Spieler: Excel → CSV speichern → Importieren statt einzeln anlegen
• YAML-Vorlagen: Einmal einen Platz detailliert erfassen, exportieren, für ähnliche Plätze als Vorlage nutzen

Fehler vermeiden

• Immer Geschlecht angeben: Wichtig für korrekte Abschlag-Zuordnung
• Handicap aktuell halten: Nur mit aktuellem HCP sind Netto-Ergebnisse fair
• Vor Turnier Platz prüfen: Checken ob alle Löcher Par/Handicap eingetragen haben
• Bei 9-Loch-Runden: Die Front/Back Nine-Auswahl erscheint nur bei verdoppelten Plätzen (echte 9-Loch-Plätze haben nur Löcher 1-9)

Privatsphäre

• Alle deine Daten sind für dich privat - andere Nutzer sehen sie nicht
• Öffentliche Plätze zeigen KEINEN Username - nur Platz-Daten
• Du entscheidest, ob ein Platz öffentlich oder privat ist

Ja, absolut! Turnier.Golf ist vollständig kostenlos nutzbar – keine versteckten Kosten, keine Limits. Nach Turnieren kannst du optional einen freiwilligen Beitrag leisten, um die Entwicklung zu unterstützen, aber das ist keine Pflicht.

Unbegrenzt! Es gibt keine Limits – erstelle so viele Turniere wie du möchtest.

Ja! Jeder Nutzer kann mehrere Clubs anlegen, und jeder Club kann mehrere Plätze haben.

Aktiviere beim Erstellen oder Bearbeiten die Option "Platz öffentlich". Dann können andere Nutzer den Platz finden und in Turnieren verwenden. Wenn du ihn privat halten willst, lass die Option deaktiviert.

Du kannst jederzeit die Unterstützungsseite besuchen und einen beliebigen Betrag wählen. Du entscheidest selbst, ob und wie viel du beitragen möchtest. Die Zahlung erfolgt sicher über Stripe. Es ist vollständig optional!

Ja! Du kannst:

• Plätze: als YAML exportieren
• Spieler: als CSV oder YAML exportieren/importieren
• Startlisten: als PDF exportieren
• Scorekarten: als PDF exportieren
• Ergebnisse: als PDF exportieren