GymNet XML-Import¶

Übersicht¶

Der GymNet-Import ermöglicht es, Meldedaten aus dem DTB GymNet-System als XML-Datei in TurnFix zu importieren. Dabei werden Veranstaltungen, Wettkämpfe, Teilnehmer, Mannschaften und Disziplin-Zuordnungen automatisch übernommen.

Quelldateien¶

Disziplin-Zuordnung (wedDisNr → TurnFix)¶

Prinzip¶

Jede Disziplin in der GymNet-XML hat ein wedDisNr-Attribut, das Gerät und Leistungsklasse kodiert. TurnFix nutzt feste Disziplin-IDs, die vom DB-Wizard beim Erstellen einer neuen Datenbank vergeben werden.

wedDisNr-Kodierung¶

wedDisNr = [Zehner][Einer]

Zehner (Gerät):
  10 = Boden (m)       16 = Sprung (w)
  11 = Pauschenpferd    17 = Stufenbarren
  12 = Ringe            18 = Schwebebalken
  13 = Sprung (m)       19 = Boden (w)
  14 = Barren
  15 = Reck

Einer (Leistungsklasse):
  0 = Kür
  1 = LK1
  2 = LK2
  3 = LK3

Sondercodes:
  x09 (209-299) = P-Übung (P1-P9)
  630 = Minitrampolin
  915 = Gerätebahn A
  916 = Gerätebahn B

Vollständige Zuordnungstabelle¶

Männlich – Kür (wedDisNr x0)¶

Weiblich – Kür (wedDisNr x0)¶

Männlich – LK1 (wedDisNr x1)¶

Weiblich – LK1 (wedDisNr x1)¶

Männlich – LK2 (wedDisNr x2)¶

Weiblich – LK2 (wedDisNr x2)¶

Männlich – LK3 (wedDisNr x3)¶

Weiblich – LK3 (wedDisNr x3)¶

P-Übung (wedDisNr x09)¶

Basis-DTB-Codes (Rückwärtskompatibilität)¶

Sondergeräte¶

Feste Disziplin-IDs (DB-Wizard)¶

Der DB-Wizard (gymnetPreset.ts) erstellt alle 78 Disziplinen mit festen IDs. Da der Wizard immer in eine leere Datenbank importiert, sind die IDs deterministisch.

ID-Schema¶

Die zentrale Definitionsdatei ist server/src/utils/gymnetDisciplineIds.ts.

Nach dem Einfügen aller Geräte wird die PostgreSQL-Sequence automatisch auf 78 zurückgesetzt, damit weitere manuell erstellte Geräte ab ID 79 beginnen.

Import-Ablauf¶

1. XML einlesen¶

Die GymNet-XML wird geparst. Folgende Knoten werden ausgewertet: - <veranstaltung> → Veranstaltung (Event) - <wettkampf> → Wettkampf (Competition) - <disziplin wedDisNr="..."> → Geräte-Zuordnung - <person> / <mannschaft> → Teilnehmer / Mannschaften

2. Geräte zuordnen¶

Für jede <disziplin> wird wedDisNrToTurnFixId(wedDisNr) aufgerufen:

import { wedDisNrToTurnFixId } from '../utils/gymnetMapping';

const turnfixId = wedDisNrToTurnFixId(161);  // → 37 (Sprung w. LK1)

Die Funktion nutzt eine explizite Lookup-Tabelle – kein Formel-basiertes Mapping.

3. Fallback (kein wedDisNr)¶

Wenn die XML kein wedDisNr enthält (ältere Exporte), greift getDisciplinesForCompetition(), das anhand des Wettkampfnamens passende Geräte aus der DB sucht.

4. Mannschaften¶

Enthält ein <mannschaft>-Knoten mehrere <person>-Einträge, wird eine Mannschaft in tfx_mannschaften angelegt und die Teilnehmer dort zugeordnet.

Altersgruppen-Mapping (Point 38)¶

Problem¶

Altersangaben aus der XML wurden früher nicht korrekt in Geburtsjahre umgerechnet.

Lösung¶

Age → Geburtsjahr: birthYear = eventYear - age
Geburtsjahr → Age: age = eventYear - birthYear

Beispiel (Event 2025, Alter 11-12):
  waAlterMin = 11 → birthYearFrom = 2025 - 11 = 2014
  waAlterMax = 12 → birthYearTo   = 2025 - 12 = 2013

Edge Cases¶

• Keine Age-Info → Default 6–18 Jahre
• Age = 0 → als fehlend behandelt
• Nur Min oder Max → intelligente Defaults
• Kein Event-Datum → aktuelles Jahr

Geschlecht-Mapping¶

<!-- Wettkampf -->
<waGeschlecht>1</waGeschlecht>  →  männlich
<waGeschlecht>2</waGeschlecht>  →  weiblich

<!-- Teilnehmer -->
<perGeschlecht>1</perGeschlecht>  →  männlich
<perGeschlecht>2</perGeschlecht>  →  weiblich

Tests¶

Datei: server/tests/unit/wedDisNrMapping.test.ts (87 Tests)

# Tests ausführen
cd newWebBased/server
npx jest tests/unit/wedDisNrMapping.test.ts

Verbesserungsvorschläge (für später)¶

1. DB Migration: Bestehende Competitions korrigieren
2. Validation: Age Range überprüfen (min < max)
3. UI Warning: Anzeigen wenn Default 6-18 verwendet wurde
4. Import Summary: Zeigen welche Competitions welche Age-Ranges haben
5. Age vs Birth Year Clarity: UI sollte zeigen was gespeichert wird

Zusammenfassung¶

✅ Code implementiert - Vollständige Age-to-Birth-Year Konvertierung ✅ Build erfolgreich - Keine Compile-Fehler ✅ Logging hinzugefügt - Detaillierte Debug-Ausgabe ✅ Test-Dateien erstellt - Test XML + Dokumentation ✅ Edge Cases behandelt - Fehlende Ages, Age=0, nur Min/Max, etc. ⚠️ NICHT GETESTET - User muss Import testen und verifizieren 📝 Dokumentation komplett - Drei MD-Dateien mit allen Details

User Action Required: Import testen und Feedback geben!