Wettkämpfe erstellen und verwalten¶

Zielgruppe: Turnverein-Mitarbeiter, Event-Manager, Wettkampfleiter
Schwierigkeit: ⭐⭐ Mittel
Zeitaufwand: 10-15 Minuten pro Wettkampf

📋 Übersicht¶

Dieser Guide zeigt Ihnen Schritt für Schritt, wie Sie: - Veranstaltungen (Events) erstellen und konfigurieren - Wettkämpfe innerhalb einer Veranstaltung anlegen - Disziplinen zuweisen und Höchstwertungen festlegen - Wettkampfeinstellungen wie Durchgänge, Startzeiten und Bahnen konfigurieren - Teilnehmer einem Wettkampf zuordnen

🎯 Was ist der Unterschied zwischen Event und Wettkampf?¶

Ein Event kann mehrere Wettkämpfe enthalten.

✅ Voraussetzungen¶

Bevor Sie einen Wettkampf erstellen, stellen Sie sicher, dass:

• ✅ Stammdaten angelegt sind:
• Regionen (Verbände, Gaue)
• Vereine

• Wettkampforte

• ✅ Disziplinen konfiguriert sind:

• Siehe Disziplinen verwalten

• ✅ Teilnehmer/Athleten erfasst sind:

• Siehe Teilnehmer-Verwaltung

🚀 Schritt 1: Event (Veranstaltung) erstellen¶

1.1 Event-Übersicht öffnen¶

1. Navigieren Sie im Hauptmenü zu "Veranstaltungen"
2. Sie sehen die Liste aller Events mit:
3. Name der Veranstaltung
4. Start- und Enddatum
5. Wettkampfort
6. Status (Upcoming/Active/Completed)
7. Teilnehmerzahl

1.2 Neues Event anlegen¶

Klicken Sie oben rechts auf "+ Neue Veranstaltung"

Pflichtfelder: - Eventname: z.B. "Bezirksmeisterschaften 2025" - Startdatum: Erster Tag der Veranstaltung - Enddatum: Letzter Tag der Veranstaltung - Wettkampfort: Wählen Sie aus der Dropdown-Liste (vorher in Stammdaten angelegt)

Optionale Felder: - Beschreibung: Zusätzliche Informationen - Meldeschluss: Deadline für Anmeldungen - Veranstalter: Name des organisierenden Vereins - Ansprechpartner: Kontaktperson für Fragen - Hinweise: Wichtige Informationen für Teilnehmer

1.3 Event speichern¶

Klicken Sie auf "Speichern" - das Event erscheint nun in der Übersicht.

🏆 Schritt 2: Wettkampf erstellen¶

2.1 Event auswählen¶

1. Klicken Sie in der Event-Liste auf das gewünschte Event
2. Sie gelangen zur Event-Management-Ansicht

2.2 Neuer Wettkampf¶

Klicken Sie auf "+ Neuer Wettkampf"

2.3 Wettkampf-Grunddaten¶

Tab 1: Grunddaten

💡 Tipp: Die Altersgruppen werden automatisch aus dem Geburtsdatum der Teilnehmer berechnet.

2.4 Disziplinen zuweisen¶

Tab 2: Disziplinen

1. Wählen Sie die Disziplinen für diesen Wettkampf:
2. Für Männer: Boden, Pferd, Ringe, Sprung, Barren, Reck
3. Für Frauen: Sprung, Stufenbarren, Schwebebalken, Boden

4. Sonderwettbewerbe: Minitrampolin, Gerätebahnen

5. Legen Sie für jede Disziplin die Höchstwertung fest:

6. Standard: 10.0 oder 20.0 Punkte
7. Massenänderung: Alle Disziplinen gleichzeitig ändern mit dem Feld "Maximalpunktzahl für alle"

Code-Hintergrund (für Interessierte):

// Die Disziplin-Zuordnung wird im Backend gespeichert in:
// tfx_wettkampfdisziplinen
interface CompetitionDiscipline {
  disciplineId: number;     // Verknüpfung zur Disziplin
  maxScore: number;         // Höchstwertung (z.B. 10.0)
}

2.5 Wettkampfeinstellungen (Erweitert)¶

Tab 3: Einstellungen

💡 Wichtig: - Durchgang: Wenn mehrere Wettkämpfe parallel laufen, nummerieren Sie die Durchgänge (1, 2, 3...) - Bahn: Wichtig für die Zeitplanung und Rotationsplan

Code-Referenz:

// Diese Felder werden gespeichert in: tfx_wettkampf
const competitionSettings = {
  int_durchgang: 1,        // Durchgang/Runde
  int_bahn: 1,             // Bahn-Nummer
  tim_startzeit: '08:30',  // Startzeit (HH:MM)
  tim_einturnen: '08:00',  // Aufwärmzeit (HH:MM)
  int_wertungen: 3,        // Anzahl Wertungen
  bol_streichwertung: false // Streichwertung ja/nein
}

2.6 Wettkampf speichern¶

1. Klicken Sie auf "Speichern"
2. Der Wettkampf erscheint in der Wettkampfliste des Events

👥 Schritt 3: Teilnehmer zuweisen¶

3.1 Teilnehmer-Ansicht öffnen¶

1. Wählen Sie den Wettkampf in der Liste
2. Klicken Sie auf "Teilnehmer verwalten"

3.2 Teilnehmer hinzufügen¶

Option A: Einzeln hinzufügen 1. Klicken Sie auf "+ Teilnehmer hinzufügen" 2. Wählen Sie Athlet aus der Liste 3. Vergeben Sie eine Startnummer (optional, kann auch automatisch generiert werden) 4. Speichern

Option B: Automatische Startnummern generieren 1. Gehen Sie zur Event-Management-Ansicht 2. Klicken Sie auf "Startnummern generieren" 3. Das System vergibt automatisch aufsteigende Nummern für alle Teilnehmer

Code-Hintergrund:

// API-Endpunkt für automatische Startnummern-Generierung
PUT /api/events/{eventId}/generate-start-numbers

// Logik im Backend:
// 1. Alle Teilnehmer des Events laden
// 2. Nach Wettkampf und Name sortieren
// 3. Fortlaufende Startnummern vergeben (1, 2, 3, ...)

3.3 Teilnehmer-Details prüfen¶

Für jeden Teilnehmer sehen Sie: - Name und Vorname - Verein (mit Badge) - Geschlecht - Alter (automatisch berechnet) - Startnummer - Status (aktiv/inaktiv)

📊 Schritt 4: Wettkampf-Übersicht¶

4.1 Wettkampf-Status¶

In der Wettkampfliste sehen Sie:

4.2 Filter und Suche¶

Suchfeld: Name oder Wettkampf-Nummer eingeben

Filter: - Geschlecht: Männlich, Weiblich, Gemischt - Status: Upcoming, Active, Completed - Altersgruppe: Nach AK filtern

Ansichten: - 📋 Tabelle (Standard): Übersichtliche Liste - 📱 Karten: Kachel-Ansicht mit mehr Details - 🔲 Grid: Kompakte Raster-Ansicht

4.3 Aktionen¶

Für jeden Wettkampf verfügbar:

⏰ Schritt 5: Zeitplanung (Optional)¶

Nach dem Anlegen des Wettkampfs können Sie die Zeitplanung verfeinern:

1. Navigieren Sie zu "Zeitplanung" im Hauptmenü
2. Wählen Sie das Event
3. Siehe detaillierten Guide: Zeitplanung für Wettkämpfe

Wichtige Konzepte: - Durchgang: Zeitblock für einen oder mehrere Wettkämpfe - Startgerät: Das Gerät, an dem ein Wettkampf beginnt (z.B. "Boden") - Rotation: Automatischer Wechsel zwischen Disziplinen

🎯 Tipps & Best Practices¶

✅ Do's¶

1. Eindeutige Namen: Verwenden Sie klare Wettkampf-Bezeichnungen
2. ✅ "Männlich AK 12-13 P-Stufe 5"

3. ❌ "Wettkampf 1"

4. Durchgänge planen: Wenn mehrere Wettkämpfe parallel laufen, vergeben Sie unterschiedliche Durchgangs-Nummern

5. Startnummern prüfen: Nach automatischer Generierung einmal kontrollieren

6. Höchstwertungen: Für alle Disziplinen gleich setzen (z.B. alle 10.0 oder alle 20.0)

7. Altersgruppen: Orientieren Sie sich an den offiziellen Wettkampfausschreibungen Ihres Verbandes

❌ Don'ts¶

1. Wettkampf nicht löschen, wenn bereits Wertungen erfasst wurden
2. System verhindert dies automatisch

3. Alternative: Wettkampf als "completed" markieren

4. Keine unrealistischen Altersgruppen (z.B. "1-99 Jahre")

5. Besser: Mehrere Wettkämpfe für unterschiedliche AKs

6. Durchgänge nicht durcheinander bringen

7. Durchgang 1 sollte vor Durchgang 2 starten

8. Nutzen Sie die Zeitplanung für Übersicht

9. Geschlecht beachten: Männer können nicht zu Frauen-Wettkämpfen angemeldet werden

10. System warnt automatisch bei Fehler

❓ Häufige Probleme & Lösungen¶

Problem 1: "Teilnehmer wird nicht angezeigt"¶

Ursachen: - Geschlecht passt nicht (Mann im Frauen-Wettkampf) - Alter außerhalb der Altersgruppe - Teilnehmer hat keinen aktiven Status

Lösung: 1. Überprüfen Sie Teilnehmer-Daten (Geburtsdatum, Geschlecht) 2. Passen Sie Wettkampf-Altersgruppen an 3. Aktivieren Sie den Teilnehmer in der Teilnehmer-Verwaltung

Problem 2: "Disziplin fehlt in Auswahl"¶

Ursache: Disziplin nicht für Geschlecht freigegeben

Lösung: 1. Gehen Sie zu "Disziplinen" in Stammdaten 2. Bearbeiten Sie die Disziplin 3. Aktivieren Sie "Männlich erlaubt" oder "Weiblich erlaubt"

Problem 3: "Wettkampf kann nicht gelöscht werden"¶

Ursache: Wettkampf hat bereits Wertungen oder Teilnehmer

Lösung: 1. Option A: Löschen Sie zuerst alle Wertungen (Achtung: Datenverlust!) 2. Option B: Markieren Sie Wettkampf als "abgeschlossen" statt zu löschen

Problem 4: "Startnummern durcheinander"¶

Ursache: Manuell vergebene Nummern oder mehrfache Generierung

Lösung: 1. Klicken Sie auf "Startnummern neu generieren" 2. System überschreibt alle Nummern 3. Prüfen Sie die Reihenfolge in der Teilnehmer-Liste

🔄 Daten aus GymNet importieren¶

Wenn Sie bereits Wettkämpfe in GymNet angelegt haben:

1. Exportieren Sie die XML-Datei aus GymNet
2. Gehen Sie zu "Events" → "Importieren"
3. Wählen Sie die XML-Datei
4. System importiert automatisch:
5. Event-Daten
6. Wettkämpfe mit Disziplinen
7. Teilnehmer mit Startnummern
8. Vereine und Regionen

Siehe detaillierter Guide: GymNet Import

Mapping-Tabelle (automatisch):

📈 Nächste Schritte¶

Nach dem Erstellen des Wettkampfs:

1. Zeitplanung konfigurieren
2. Durchgänge anlegen
3. Startgeräte zuweisen

4. Rotation planen

5. Wertungserfassung vorbereiten

6. Kampfrichter-Zugänge erstellen
7. Geräte-Zuordnung prüfen

8. Test-Wertungen durchführen

9. Urkunden vorbereiten

10. Layout auswählen
11. Vorlagen anpassen

12. Test-Druck durchführen

13. Ergebnisse veröffentlichen

14. Live-Ergebnisse aktivieren
15. Export-Formate wählen
16. Medaillenspiegel erstellen

🔗 Verwandte Dokumentation¶

Benutzer-Guides¶

• Teilnehmer verwalten
• Zeitplanung
• Wertungserfassung
• Urkunden erstellen

Developer-Guides¶

• Event Management API
• Competition Data Model
• GymNet Import Implementation

Stammdaten¶

• Disziplinen verwalten
• Vereine anlegen
• Wettkampforte konfigurieren

📞 Support¶

Probleme oder Fragen?

1. Dokumentation durchsuchen: TurnFix Docs
2. GitHub Issues: github.com/Igel18/turnfix/issues
3. Community: TurnFix Discord/Forum (falls vorhanden)

Version: 2.0
Letzte Aktualisierung: 05.11.2025
Autor: TurnFix Team
Feedback: Gerne als GitHub Issue einreichen!