Saison-Modell: Global vs. Bearbeitungsmodus
Ziel
Der Admin (Lizenzinhaber) kann 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 des Admins. Alle Eingaben laufen nur in dieser ausgewählten Saison.
- Archiv: frühere Saisons nach einem globalen Wechsel – nur lesen für alle (Änderungen lehnt der Server mit SEASON_ARCHIVED ab), automatische Löschung 2 Jahre nach Anlage. Die aktuelle Saison löscht die Aufbewahrung nie; läuft sie länger, entfernt sie darin nur Daten, die älter als 2 Jahre sind.
- Anlegen, global umstellen, wieder öffnen, Konten zuordnen und löschen darf nur der Admin (Lizenzinhaber). Die Saisonverwaltung (Auswahl, Bearbeitungsmodus, Archiv mit Saisonbericht) zeigt die App nur Admins (die Schnittstellen für Vorschau und Saisonbericht lassen auch Trainer zu). Trainer ohne Adminrolle sehen unter „Saisons“ die Saisonliste nur zum Ansehen: archivierte Saison öffnen (nur lesen), Saisonbericht (PDF), „Zur aktuellen Saison“; sie arbeiten in der aktuellen Saison. Teamrollen haben keine Saisonliste. Der Kassenwart wählt frühere Saisons nur in der Kasse zum Ansehen (Auswahl „Saison“, lesende Anfragen an /api/finance/* mit seasonId); eine vorbereitete Saison antwortet ihm mit 403 SEASON_NOT_CURRENT.
- Schreibschutz außerhalb der aktuellen Saison: Ohne Adminrolle – Trainer, Co-Trainer, Teammanager, Kassenwart, Betreuer, Physiotherapeut, Mannschaftsarzt – ändert ein Konto nur Daten der aktuellen Saison. Ändernde Anfragen für eine andere Saison (?seasonId=, seasonId im Inhalt oder über einen Eintrag dieser Saison) lehnt der Server mit 403 SEASON_NOT_CURRENT ab; archivierte Saisons weiter für alle mit 409 SEASON_ARCHIVED. Lesen bleibt erlaubt. Spieler und Eltern arbeiten in ihrer Spielersaison.
Standardablauf: Neue Saison vorbereiten
- Saison-Assistent öffnen.
- Schritt 1 „Name & Quelle“: neuen Saisonnamen vergeben (Format JJJJ oder JJJJ/JJ, z. B. 2027 oder 2027/28; ein vorhandener Name wird schon hier abgelehnt). Die erste Saison einer Gruppe ist immer global aktiv („Für alle als aktuelle Saison setzen“ fest an); hat eine Gruppe noch keine fest gesetzte aktuelle Saison, setzt der Server vor dem Anlegen die bis dahin wirksame Saison fest.
- Datenquelle für Import wählen (nur Saisons des eigenen Vereins).
- Schritt 2 „Spieler“: übernommene Spieler auswählen (feste Spieler vorausgewählt; Gäste getrennt).
- Schritt 3 „Übernahme“: die gewünschten Übernahmen aktivieren.
- Saison anlegen und den Bericht prüfen.
- Fachlich prüfen, ob Daten in der neuen Saison korrekt sind.
- Erst danach die neue Saison global als aktuell setzen – die bisherige Saison kommt ins Archiv.
Übernahmeoptionen im Saison-Assistenten
Spieler übernehmen
- Erstellt die ausgewählten Spieler in der neuen Saison; nicht ausgewählte bleiben in der alten Saison und lassen sich später mit „+ Aus Vorsaison“ nachholen (siehe unten).
- Feste Spieler der Quellsaison sind vorausgewählt (Alle/Keine). Gäste / Probetraining stehen getrennt, sind nicht ausgewählt und kommen angehakt nur wieder als Gast mit ihrem Enddatum mit – nie als feste Spieler.
- 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 kommende, nicht abgesagte Trainings-, Spiel- und Eventtermine – auch Termine ohne Titel – samt Ort und Belag in die neue Saison, Spiele auch mit Mannschaft, Gegner und Heim- bzw. Auswärtsspiel (vergangene und abgesagte bleiben in der alten).
- Gibt es denselben Termin in der neuen Saison schon (gleiche Art, Titel, Datum und Zeiten sowie Mannschaft, Gegner, Heim/Auswärts und Ort), legt die Übernahme ihn nicht doppelt an.
- Rückmeldungen und Startstatus kommender Termine gehen mit, sobald die Saison aktuell ist: bei „Für alle als aktuelle Saison setzen“ sofort, sonst mit „Als aktuell setzen“ (dann gilt der letzte Stand). Einträge aus Abmeldeserien setzt die kopierte Serie; eine Ausnahme von einer Serie gilt auch gegen sie.
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 (Ausnahme bei „Für alle als aktuelle Saison setzen“ mit anderer Datenquelle: siehe unten). Schaltet der Admin später auf eine frühere Saison zurück, behält diese ihren eigenen Kassenstand.
- Das Guthaben der Spieler wandert unabhängig davon immer mit (es gehört den Spielern) – bei den übernommenen Spielern, sobald die neue Saison aktuell ist; der Bericht nennt es als „Guthaben übertragen“. Wird die neue Saison gleich für alle aktuell und ist die Datenquelle eine andere Saison, wandert auch das Guthaben aus der bisher aktuellen Saison mit. Guthaben nicht übernommener Spieler bleibt in der alten Saison: Die Rückfrage und der Bericht nennen es, ausgezahlt wird es in der Kasse unter „Guthaben ehemaliger Spieler“ (POST /api/finance/credit/payout mit originSeasonId).
- Wird die neue Saison gleich für alle aktuell und ist die Datenquelle eine andere Saison, wandern auch die offenen Strafen und Beiträge der bisher aktuellen Saison mit (verknüpft, dieselbe Schuld nur einmal); die Kassenstand-Basis kommt dann ebenfalls aus der bisher aktuellen Saison.
Strafenkatalog übernehmen
- Kopiert Katalogeinträge mit Beträgen in die neue Saison.
Individuelle Einstellungen übernehmen
- Übernimmt „Funktionen an/aus“ (Schalter gelten je Saison) und die Einverständnisse zur Kontoanlage der übernommenen Spieler – ohne Kassenstand-Basis.
- Ohne diese Option nutzt die neue Saison die bisherigen Vereinswerte der Schalter, bis jemand in ihr eigene speichert.
- Mit dieser Option gelten Schalter, die nach dem Vorbereiten in der laufenden Saison geändert wurden, mit „Als aktuell setzen“ auch in der neuen Saison – außer die Schalter der vorbereiteten Saison wurden selbst geändert.
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.
- Gilt auch für Serien der Betreuer und anderer Teamrollen ohne Spielereintrag (übernommen beim Anlegen der Saison).
Personen- und Tenant-Verhalten
- Übernahmen sind tenant-bezogen; Saisonliste und Datenquelle zeigen nur Saisons des eigenen Vereins.
- Beim Saisonkopieren werden auch verknüpfte Personenkonten berücksichtigt.
- Elternzuordnungen zu Kindern werden in der Ziel-Saison wieder verknüpft.
- Spielereinträge für Trainerkonten legt die App in der neuen Saison selbst an – nur für Konten, die gerade in dieser Gruppe sind, und mit ihrem Namen aus der App. Wurde der Spielereintrag eines Trainers im Schritt „Spieler“ abgewählt, gilt danach wie bei „Spieler“ abwählen der Merker „spielt nicht mit“: kein automatischer Eintrag mehr (weder beim Saisonwechsel noch bei der Anmeldung), bis der Chip „Spieler“ bzw. „Mich wieder als Spieler aufnehmen“ ihn aufhebt.
- Spieler- und Elternkonten werden beim globalen Wechsel auf die Spieler der neuen Saison umgehängt (Zuordnung über den Benutzernamen, sonst über Vor- und Nachname – aber nie an einen Eintrag mit anderem Benutzernamen: Gleichnamige Spieler mit eigenem Zugang bleiben zwei Personen). Ist der passende Spieler schon mit einem anderen Konto verbunden, bleibt das Konto in der alten Saison und erscheint im Bericht und – bis zur Zuordnung – unter „Saisons“ (GET /api/seasons/{id}/relink) unter „Konten nicht umgehängt“; „Zuordnen“ wählt einen Spieler der neuen Saison ohne Konto oder legt ihn neu an (POST /api/seasons/{id}/relink). Wie beim automatischen Umhängen gehen dabei das Mitspielen in weiteren Gruppen und das Einverständnis mit, beim Neuanlegen auch Gaststatus, Profil und aktive Abmeldeserien.
- In der vorbereiteten Saison hängen Zugangskarten, „Passwort zurücksetzen“, die Rollen-Chips und „Mich wieder als Spieler aufnehmen“ kein Konto um: Das Konto bleibt bis „Als aktuell setzen“ am Eintrag der laufenden Saison (Zugangskarten und Zurücksetzen setzen nur sein Passwort).
- Spieler löschen in der laufenden Saison: Der Eintrag derselben Person in einer vorbereiteten Saison entfällt mit, wenn die Rückfrage ihn genannt hat (preparedCopies) und er keine Kassendaten hat. Mit Kassendaten bleibt er, auch bei „Auch im Archiv löschen“. Löschanträge (allSeasons ohne preparedCopies) löschen wie bisher alle Einträge.
- „Als aktuell setzen“ zieht beim Umschalten nach vorn nach, was nach dem Vorbereiten in der laufenden Saison dazukam: Abmeldeserien von Spielern und Betreuern und geänderte Einverständnisse (auch ein Widerruf) – beides nur, wenn es beim Anlegen übernommen wurde – sowie verlängerte oder in feste Spieler übernommene Gastzugänge.
- Umgekehrt gleicht „Als aktuell setzen“ veraltete Kopien ab (Herkunftsmerker season_copy_trace_<Saison>): In der laufenden Saison gelöschte oder inzwischen beendete Abmeldeserien fallen in der neuen weg, geänderte kommen mit dem neuen Zeitraum und Grund (auch die der Betreuer); dort gelöste Elternverknüpfungen sind auch in der neuen gelöst. In der vorbereiteten Saison bewusst geänderte oder gelöschte Kopien bleiben, wie sie sind. Eine in der laufenden Saison geänderte Altersgruppe gilt sofort auch in den vorbereiteten Saisons, ebenso die LK im Tennis.
- Kopierte Termine gleicht „Als aktuell setzen“ ebenso ab, wenn „Termine übernehmen“ aus der bisher aktuellen Saison gewählt war: In der laufenden Saison gelöschte oder inzwischen vergangene fallen weg, geänderte und abgesagte kommen mit dem neuen Stand, neue kommen dazu. In der vorbereiteten Saison geänderte oder gelöschte Kopien bleiben, wie sie sind (Vergleich über einen Prüfwert im Herkunftsmerker); eine dort geänderte bekommt die Rückmeldungen, solange sie am selben Tag liegt wie ihre Herkunft. Keine Nachricht an Spieler und Eltern.
- Konten mit einer Teamrolle (Co-Trainer, Teammanager, Betreuer, Physiotherapeut, Mannschaftsarzt) ohne Eintrag in der neuen Saison machen ohne Spielereintrag weiter wie nach „Spieler“ abwählen; „+ Aus Vorsaison“ hängt sie später wieder an ihren Eintrag. Ebenso ein Kassenwart mit Spielereintrag: Er macht als Kassenwart ohne Spielereintrag weiter.
- Dasselbe Umhängen gilt beim Anlegen mit „Für alle als aktuelle Saison setzen“, auch wenn die Datenquelle nicht die aktuelle Saison ist.
- Mitspielen in weiteren Gruppen des Vereins (club_group_memberships) zieht beim Umhängen, bei „Aus Vorsaison“ und beim Löschen einer Saison mit; ohne passenden Spieler in der verbleibenden Saison endet die Teilnahme. Wird eine Saison gelöscht, kommen Spieler aus anderen Gruppen des Vereins, die gerade in ihren Gast-Eintrag dieser Saison gewechselt sind, samt Eltern zurück in ihre Heimatgruppe.
Spieler später übernehmen („Aus Vorsaison“)
- Bereich Spieler → „+ Aus Vorsaison“ (GET|POST /api/seasons/{id}/player-takeover): Admin bzw. Lizenzinhaber (auch in eine vorbereitete Saison) und Trainer (nur in die aktuelle Saison, sonst 403 SEASON_NOT_CURRENT); nicht Teamrollen, nicht in der Demo und nicht in eine archivierte Saison (SEASON_ARCHIVED).
- Quelle ist eine früher angelegte Saison derselben Gruppe (vorgewählt die neueste); aufgeführt sind nur Spieler, die in der geöffneten Saison fehlen (gleicher Benutzername, sonst gleicher Vor- und Nachname ohne abweichenden Benutzernamen). Gäste stehen getrennt und kommen nur wieder als Gast mit ihrem Enddatum mit.
- Übernommen wird wie im Assistenten: Spielereintrag, Profil, Elternzuordnungen, Einverständnisse zur Kontoanlage, aktive Abmeldeserien und das Mitspielen in weiteren Gruppen des Vereins; offene Strafen und offene Teambeiträge nur, wenn „Offene Strafen und Beiträge übernehmen“ beim Anlegen der Zielsaison nicht abgewählt war. Das Guthaben wandert immer mit – in die aktuelle Saison und aus früheren Saisons sofort, aus der aktuellen in eine vorbereitete Saison erst mit „Als aktuell setzen“. Frühere Termine „Noch nicht im Team“, kommende „dabei“.
- Konten werden sofort umgehängt, wenn die Zielsaison aktuell ist; in einer vorbereiteten Saison vorgemerkt und mit „Als aktuell setzen“ umgehängt.
- Ist ein ausgewählter Spieler schon in der Saison, lehnt der Server die ganze Anfrage ab (409 SEASON_TAKEOVER_EXISTS, nichts geändert). Saisons und Spieler anderer Vereine: 404. Audit season.players.takeover.
Wechsel zwischen Gruppen zur neuen Saison
- Ein Kern mit zwei Eingängen (api/lib/club-transfers.php, Tabelle club_player_transfers, eine Zeile je Spielereintrag): Der Eintrag bleibt im Archiv der alten Gruppe, in der neuen Gruppe entsteht ein neuer Eintrag mit Konto, Eltern und Einwilligungen. Vormerken (POST /api/club/transfers) ist der Eingang vor dem Saisonwechsel, die Liste „Noch ohne Mannschaft“ (POST /api/club/transfers/take-in) der Eingang danach. Rechte wie beim Verschieben: nur der Lizenzinhaber des Vereins.
- Stände: marked (vorgemerkt), waiting (alte Gruppe gewechselt, neue noch nicht), placed (Eintrag in der vorbereiteten Saison der neuen Gruppe, das Konto folgt mit deren „Als aktuell setzen“), done (gewechselt), problem (Hindernis beim Wechsel, steht mit Grund in der Liste), stopped („Hört auf“), deleted (in der laufenden Saison gelöscht, nicht in der Liste).
- „Als aktuell setzen“ und „Für alle als aktuelle Saison setzen“ führen die Vormerkungen der bisher aktuellen Saison in derselben Transaktion aus, vor den Übernahmen. Geht bei einem Spieler etwas schief, nimmt ein Rücksprungpunkt nur seinen Wechsel zurück; er steht dann mit Grund in der Liste.
- Die neue Gruppe ist bereit, wenn ihre laufende Saison nach dem Namen später ist als die alte Saison des Spielers (dann sofort mit Konto) oder wenn sie eine solche Saison vorbereitet hat (dann erst der Eintrag). Sonst wartet der Spieler. Anlegen und „Als aktuell setzen“ der neuen Gruppe holen Wartende nach; der Bericht nennt sie unter „Neu aus anderen Gruppen“.
- Eine Kopie des Spielers in einer vorbereiteten Saison der alten Gruppe geht beim Wechsel; dorthin übernommene Schulden zählen dabei nicht als Kassendaten, sie sind dieselben wie im Archiv. Mit echten Kassendaten bleibt die Kopie, ohne Konto und Eltern, und der Bericht sagt das.
- Assistent und „+ Aus Vorsaison“ der alten Gruppe nehmen vorgemerkte und gewechselte Spieler nicht mit, auch nicht mit einer gefälschten Anfrage (409 SEASON_TAKEOVER_MOVED). GET /api/seasons/{id}/planned-moves liefert dem Trainerteam nur den Hinweis.
- Guthaben und offene Beträge bleiben in der alten Saison und stehen unter „Guthaben ehemaliger Spieler“ und „Offene Forderungen ehemaliger Spieler“.
- Zurückschalten macht einen erledigten Wechsel nicht rückgängig; waiting, placed und problem werden wieder zur Vormerkung (ein Eintrag in der vorbereiteten Saison der neuen Gruppe entfällt dabei).
- Die Zeilen enden mit dem Eintrag, der Saison oder der Gruppe. Wird die vorbereitete Saison der neuen Gruppe gelöscht, wartet der Spieler wieder. Wird die neue Gruppe gelöscht, steht ein Wartender mit Grund in der Liste.
Globalen Saisonwechsel sicher durchführen
- Ziel-Saison im Bearbeitungsmodus öffnen.
- Schnellcheck durchführen: Spieler, Termine, offene Finanzposten, Abmeldeserien.
- Vorschau für globalen Wechsel aufrufen.
- Vergleich Quelle/Ziel prüfen; die Rückfrage nennt auch, was in der alten Saison bleibt (Spieler ohne Eintrag, kommende Termine, laufende Umfragen, Guthaben) und wer in eine andere Gruppe wechselt.
- Global auf neue Saison umstellen.
- Bericht prüfen: umgehängte Konten, Elternzuordnungen, „Konten nicht umgehängt“ mit „Zuordnen“ erledigen. Die bisherige Saison ist jetzt im Archiv.
Archiv
- Beim globalen Wechsel wird die bisher aktuelle Saison archiviert (seasons.archived_at); wird eine archivierte Saison aktuell, ist sie nicht mehr archiviert.
- Saisons → Archiv: „Ansehen“ (Bearbeitungsmodus nur lesen), „Saisonbericht (PDF)“ für Admin und Trainer (Termine nach Art, Anwesenheit je Spieler, Bestenlisten, Spieler des Monats, Kasse nur mit Zugriff auf die Kasse), „Wieder öffnen“ nur Admin.
- Spieler und Eltern ohne Eintrag in der neuen Saison lesen die alte Saison nur noch (Hinweis auf Start, seasonArchived im Dashboard): Schreiben lehnt der Server mit SEASON_ARCHIVED ab, Abstimmen wird nicht angeboten, das Minispiel ist für Spieler aus.
- Export und Löschen gehen auch bei archivierten Saisons; die aktuelle Saison lässt sich nicht löschen.
- Funktionen an/aus einer archivierten Saison lassen sich nur ansehen.
- Offene Apps ohne Adminrolle, die die bisher aktuelle Saison zeigen, folgen beim nächsten Laden der Saisonliste (Abgleich nach Änderungen, spätestens nach 5 Minuten, beim Zurückkehren in die App) der neuen aktuellen Saison mit dem Hinweis „Neue Saison „…“ ist jetzt aktuell.“. Wer bewusst ein älteres Archiv geöffnet hat, bleibt dort; Admins behalten ihre Auswahl.
Checkliste vor globalem Wechsel
- Spieleranzahl plausibel.
- Terminanzahl plausibel.
- Offene Strafen vorhanden/korrekt.
- Kassenstand-Basis korrekt.
- Offene Teambeiträge korrekt.
- Aktive Abmeldeserien nur mit zukünftigen Zeiträumen vorhanden.
- Trainerfreigabe eingeholt.
API-Endpunkte
- GET /api/seasons
- POST /api/seasons
- POST /api/seasons/current/preview
- PUT /api/seasons/current
- DELETE /api/seasons/{id}
- GET /api/seasons/{id}/export
- POST /api/seasons/{id}/reopen
- GET|POST /api/seasons/{id}/relink (offene Zuordnungen „Konten nicht umgehängt“ bzw. „Zuordnen“)
- GET|POST /api/seasons/{id}/player-takeover (Spieler früherer Saisons, die fehlen, bzw. übernehmen)
- GET /api/seasons/{id}/report.pdf
- GET /api/seasons/{id}/planned-moves (Hinweis im Assistenten: wer in eine andere Gruppe wechselt)
- POST /api/club/transfers (vormerken, auch mehrere; ein vorhandener Merker wird ersetzt)
- DELETE /api/club/transfers/{id} (Vormerkung entfernen)
- POST /api/club/transfers/take-in, /stop, /restore (Liste „Noch ohne Mannschaft“)
- GET|PUT /api/tenant-admin/features (Funktionen an/aus der gewählten Saison; speichern nur Admin)
Wichtige Fehlercodes
- SEASON_NAME_REQUIRED
- SEASON_NAME_INVALID
- SEASON_ALREADY_EXISTS
- SEASON_NOT_FOUND
- SEASON_ID_REQUIRED
- SEASON_CREATE_FORBIDDEN
- SEASON_SWITCH_PREVIEW_FORBIDDEN
- SEASON_SWITCH_FORBIDDEN
- SEASON_ALREADY_CURRENT
- SEASON_SWITCHED
- SEASON_ARCHIVED
- SEASON_NOT_CURRENT
- SEASON_REOPEN_FORBIDDEN
- SEASON_REOPENED
- SEASON_RELINK_FORBIDDEN
- SEASON_RELINK_CONFLICT
- SEASON_ACCOUNT_RELINKED
- SEASON_TAKEOVER_MOVED
- CLUB_MARK_TOO_MANY
- CLUB_MARK_DONE
- CLUB_LIST_GONE
- SEASON_REPORT_FORBIDDEN
- SEASON_TAKEOVER_FORBIDDEN
- SEASON_TAKEOVER_SOURCE_REQUIRED
- SEASON_TAKEOVER_SOURCE_INVALID
- SEASON_TAKEOVER_EMPTY
- SEASON_TAKEOVER_TOO_MANY
- SEASON_TAKEOVER_EXISTS
- SEASON_TAKEOVER_FAILED
Typische Fehlerbilder und Lösung
Neue Hintergrund-/Branding-Einstellung scheint nicht aktiv
- Nach Speichern einmal hart neu laden (Ctrl+F5).
- Prüfen, ob die richtige Saison/Tenant aktiv ist.
- Branding erneut speichern und Rückmeldung prüfen.
Übernahme wirkt unvollständig
- Sicherstellen, dass die Option Spieler übernehmen aktiv war und die Spieler in Schritt 2 ausgewählt waren – fehlende Spieler mit „+ Aus Vorsaison“ nachholen.
- Bei Strafen/Beiträgen prüfen, ob Offene Strafen aktiviert war.
- Bei Abmeldeserien prüfen, ob nur zukünftige Terminanteile erwartet werden.
- Gäste kommen nur angehakt und nur als Gast mit.
Spieler sieht nach dem Wechsel noch die alte Saison
- Bericht nach „Als aktuell setzen“ prüfen: steht das Konto unter „Konten nicht umgehängt“, mit „Zuordnen“ erledigen.
- War der Spieler im Assistenten nicht ausgewählt, bleibt er in der alten Saison – mit „+ Aus Vorsaison“ (Bereich Spieler) nachholen.
- War er für eine andere Gruppe vorgemerkt und hat die noch keine neue Saison, wartet er: Unter „Verein → Kader“ steht er bei „Warten auf ihre neue Gruppe“.