Saison-Modell: Global vs. Bearbeitungsmodus

Ziel

Trainer und Admin können die nächste Saison vollständig vorbereiten, ohne die laufende Saison für Spieler sofort umzuschalten.

Begriffe

• Global aktiv: Saison, die ohne persönliche Auswahl für alle Rollen als aktuell gilt.
• Bearbeitungsmodus: Persönliche Saison-Auswahl für Trainer/Admin. Alle Eingaben laufen nur in dieser ausgewählten Saison.

Standardablauf: Neue Saison vorbereiten

1. Saison-Assistent öffnen.
2. Neuen Saisonnamen vergeben.
3. Datenquelle für Import wählen.
4. In Schritt 2 die gewünschten Übernahmen aktivieren.
5. Saison anlegen.
6. Fachlich prüfen, ob Daten in der neuen Saison korrekt sind.
7. Erst danach die neue Saison global als aktuell setzen.

Übernahmeoptionen im Saison-Assistenten

Spieler übernehmen

• Erstellt die Spielerliste in der neuen Saison.
• Ist Voraussetzung für Profile, offene Strafen/Beiträge und Abmeldeserien.

Spielerprofile übernehmen

• Übernimmt Profildaten (z. B. Positionen, Ziele, Stärken/Schwächen).

Termine übernehmen

• Kopiert Trainings-, Spiel- und Eventtermine in die neue Saison.

Offene Strafen und Beiträge übernehmen

• Überträgt offene Strafen und offene Teambeiträge.
• Überträgt den Kassenstand: Die neue Saison startet mit dem Kontostand der Quellsaison.

Strafenkatalog übernehmen

• Kopiert Katalogeinträge mit Beträgen in die neue Saison.

Individuelle Einstellungen übernehmen

• Übernimmt saisonbezogene Einstellungen ohne Kassenstand-Basis.

Aktive Abmeldeserien übernehmen

• Übernimmt nur zukünftige Terminanteile laufender Serien.
• Hat eine Serie bereits in der Vergangenheit begonnen, startet die übernommene Serie in der neuen Saison ab heute.

Personen- und Tenant-Verhalten

• Übernahmen sind tenant-bezogen.
• Beim Saisonkopieren werden auch verknüpfte Personenkonten berücksichtigt.
• Elternzuordnungen zu Kindern werden in der Ziel-Saison wieder verknüpft.
• Trainerkonten werden für die neue Saison sichergestellt.

Globalen Saisonwechsel sicher durchführen

1. Ziel-Saison im Bearbeitungsmodus öffnen.
2. Schnellcheck durchführen: Spieler, Termine, offene Finanzposten, Abmeldeserien.
3. Vorschau für globalen Wechsel aufrufen.
4. Vergleich Quelle/Ziel prüfen.
5. Global auf neue Saison umstellen.

Checkliste vor globalem Wechsel

1. Spieleranzahl plausibel.
2. Terminanzahl plausibel.
3. Offene Strafen vorhanden/korrekt.
4. Kassenstand-Basis korrekt.
5. Offene Teambeiträge korrekt.
6. Aktive Abmeldeserien nur mit zukünftigen Zeiträumen vorhanden.
7. Trainerfreigabe eingeholt.

API-Endpunkte

• GET /api/seasons
• POST /api/seasons
• POST /api/seasons/current/preview
• PUT /api/seasons/current

Wichtige Fehlercodes

• SEASON_NAME_REQUIRED
• SEASON_NAME_INVALID
• SEASON_ALREADY_EXISTS
• SEASON_NOT_FOUND
• SEASON_ID_REQUIRED
• SEASON_SWITCH_PREVIEW_FORBIDDEN
• SEASON_SWITCH_FORBIDDEN
• SEASON_ALREADY_CURRENT
• SEASON_SWITCHED

Typische Fehlerbilder und Lösung

Neue Hintergrund-/Branding-Einstellung scheint nicht aktiv

1. Nach Speichern einmal hart neu laden (Ctrl+F5).
2. Prüfen, ob die richtige Saison/Tenant aktiv ist.
3. Branding erneut speichern und Rückmeldung prüfen.

Übernahme wirkt unvollständig

1. Sicherstellen, dass die Option Spieler übernehmen aktiv war.
2. Bei Strafen/Beiträgen prüfen, ob Offene Strafen aktiviert war.
3. Bei Abmeldeserien prüfen, ob nur zukünftige Terminanteile erwartet werden.