Admin-Kontext: Grundeinrichtung

Ziel

Das System wird so vorbereitet, dass Verband, zentrale Zugänge und erste Stammdaten für die Demo-Liga vorhanden sind. Dieses Kapitel bündelt alles, was im Systemadmin- oder Admin-Kontext angelegt wird.

Rolle und Berechtigung

• Systembetreiber für Server- und Konfigurationsschritte.
• Systemadmin für die Pflege im Admin-Bereich.

Voraussetzungen

• Anwendung ist erreichbar.
• Du hast Serverzugang zur laufenden Anwendung.
• Du kennst das intern dokumentierte Anwendungsverzeichnis auf dem Zielhost.
• Echte Konfigurationswerte liegen in Deployment-Secrets oder interner Betriebsdokumentation, nicht in diesem öffentlichen Handbuch.
• Der Mailversand oder die Entwicklungs-Mailumleitung ist für Login-Links vorbereitet.
• Demo-Szenario ist fachlich festgelegt.

2.1Anwendung konfigurieren

Ziel

Die Anwendung ist mit bewusst gewähltem Betriebsmodus, Datenbank und Mailversand startfähig konfiguriert.

Rolle und Zugriff

• Systembetreiber oder technischer Administrator mit Zugriff auf Deployment-Secrets und Zielhost.
• Echte Secrets, Zugangsdaten und Host-Pfade werden nur intern dokumentiert.

Pflichtkonfiguration

Betriebsmodus und Mailverhalten

• In APP_ENV=prod werden Mails an die fachlichen Empfänger gesendet.
• In allen anderen Umgebungen werden ausgehende Mails an MAILER_DEV_RECIPIENT umgeleitet, falls der Wert gesetzt ist.
• Wenn MAILER_DEV_RECIPIENT leer ist, dient MAILER_FROM als Fallback für die Entwicklungs-Mailumleitung.
• APP_DEBUG=1 darf nicht auf einem öffentlich erreichbaren Host aktiv sein.

Konfiguration prüfen

Melde dich per SSH auf dem Zielhost an und wechsle in das intern dokumentierte Anwendungsverzeichnis. Prüfe danach die Laufzeitumgebung, Datenbankverbindung und Migrationen:

php bin/console about
php bin/console doctrine:query:sql "SELECT 1"
php bin/console doctrine:migrations:migrate --no-interaction

Typische Fehler

• Falscher APP_ENV führt dazu, dass Mails unerwartet umgeleitet oder produktiv versendet werden.
• APP_DEBUG=1 kann auf einem öffentlichen Host technische Details sichtbar machen.
• Falscher DEPLOY_DOMAIN oder falsches DEPLOY_SCHEME erzeugt unbrauchbare Login-Links.
• Falscher DATABASE_URL zeigt auf die falsche oder nicht migrierte Datenbank.

Verifizierung

2.2Systemzugang per Console anlegen

Ziel

Ein erster Systemadministrator wird direkt auf dem Server angelegt, damit der manuelle Aufbau im Admin-Bereich beginnen kann.

Rolle und Zugriff

• Systembetreiber oder technischer Administrator mit SSH-/Console-Zugang zum Host.
• Der spätere Admin braucht eine empfangbare E-Mail-Adresse für den Magic-Link-Login.

Befehl auf dem Server

Melde dich per SSH auf dem Zielhost an und wechsle in das intern dokumentierte Anwendungsverzeichnis. Lege danach den Systemadministrator an. Ersetze die E-Mail und den Namen durch die echte Admin-Person:

php bin/console app:person:ensure-admin "admin@example.org" "Admin" "LigaWerk"

Für die Demo kann die fachliche Testadresse demo-admin@ligawerk.de verwendet werden, wenn der Login-Link über die Entwicklungs-Mailumleitung beim Projektteam ankommt:

php bin/console app:person:ensure-admin "demo-admin@ligawerk.de" "Demo" "Admin"

Erwartete Console-Ausgabe

Admin person is ready: admin@example.org

Login prüfen

1. Rufe die Login-Seite der Anwendung auf (Pfad: /login).
2. Gib die Admin-E-Mail-Adresse ein.
3. Klicke Login-Link senden.
4. Öffne den Login-Link aus der E-Mail.
5. Prüfe, dass /profile erreichbar ist.
6. Wechsle in den Admin-Bereich (Pfad: /admin).
7. Prüfe, dass ein Arbeitsbereich mit Administratorrechten vorhanden ist.
8. Prüfe, dass die Navigation Verbandsdaten sichtbar ist.

Typische Fehler

• Wenn kein Login-Link ankommt, prüfe Mailer-Konfiguration und Entwicklungs-Mailumleitung.
• Wenn der Login klappt, aber kein Admin-Bereich erreichbar ist, prüfe, ob der Command auf der richtigen Host-Installation ausgeführt wurde.
• Wenn Verbandsdaten fehlt, prüfe, ob die Person als aktiver Systemadmin angelegt wurde.

Verifizierung

2.3Verband anlegen

Ziel

Der organisatorische Rahmen der Liga wird als aktiver Verband angelegt und öffentlich auf der Stammdatenseite sichtbar.

Beispieldaten

Die Werte in der Tabelle sind Beispieldaten für den Testdurchlauf. In einer echten Einrichtung werden hier die Daten des realen Verbandes eingetragen.

Schritte

1. Rufe die Login-Seite der Anwendung auf (Pfad: /login) und melde dich mit dem Adminzugang an.
2. Wechsle in den Admin-Bereich (Pfad: /admin).
3. Wähle den Arbeitsbereich mit Administratorrechten.
4. Wähle in der Navigation Verbandsdaten und öffne dort Verbandsdaten (Pfad: /admin/association).
5. Klicke Neu anlegen.
6. Trage die Daten ein. Nutze die Werte aus der Tabelle als Beispieldaten für den Testdurchlauf.
7. Speichere mit Anlegen.
8. Prüfe in der Liste, dass genau ein aktiver Verband mit dem Namen ZauberForest Spielrunde vorhanden ist.
9. Prüfe die öffentliche Seite Verbandsdaten (Pfad: /master-data).
10. Prüfe im Unterpunkt Verband, dass Name, Kürzel, E-Mail und Website sichtbar sind.

Das Feld Website enthält in den Beispieldaten bewusst die öffentliche LigaWerk-URL. In einer echten Einrichtung wird hier die passende Website des Verbandes eingetragen.

Bedienelemente

Erwartetes Ergebnis

• Im Admin-Bereich existiert genau ein Verband.
• Nach dem Speichern ist Neu anlegen für weitere Verbände nicht mehr verfügbar.
• Auf der öffentlichen Seite Verbandsdaten erscheint ZauberForest Spielrunde.
• Der vorherige Leerzustand Noch keine aktiven Verbandsdaten gepflegt. ist nicht mehr sichtbar.

Typische Fehler

• Wenn Neu anlegen nicht sichtbar ist, existiert bereits ein Verband. Dann den bestehenden Verband bearbeiten statt einen zweiten anzulegen.
• Wenn der Verband öffentlich nicht sichtbar ist, prüfe den Status. Nur Aktiv wird auf der öffentlichen Seite Verbandsdaten angezeigt.
• Wenn Code fehlt, lässt sich der Verband nicht vollständig speichern.

Checkliste

Prüfe nach dem Speichern:

2.4Ligaverwaltung einrichten

Unterpunkte

• 2.4.1 Ziel und Zugriff: Rolle, Berechtigung und Voraussetzungen klären.
• 2.4.2 Beispieldaten: Werte für die Testperson bereithalten.
• 2.4.3 Person und Funktion anlegen: Person und Verbandsfunktion pflegen.
• 2.4.4 Login und Arbeitsbereich prüfen: Zugang aus Sicht der Ligaverwaltung testen.
• 2.4.5 Bedienung und Fehlerbilder: Bedienelemente und typische Stolperstellen nachschlagen.

2.4.1Ziel und Zugriff

Ziel

Eine Person wird als Verbandsverwalterin und Ligaverwaltung eingerichtet, damit der folgende Verband-Kontext nicht dauerhaft mit dem Systemadmin gepflegt wird.

Rolle und Zugriff

• Einrichtung durch Systemadmin.
• Zielrollen: Verbandsverwalter mit Funktionstyp Verbandsverwalter und Ligaverwaltung mit Funktionstyp Ligaleitung.

Voraussetzungen

• Der Verband ist angelegt und aktiv.
• Der einrichtende Benutzer ist im Admin-Bereich angemeldet.
• Der Login-Link-Versand oder die Entwicklungs-Mailumleitung ist vorbereitet.

2.4.2Beispieldaten

Die Werte in der Tabelle sind Beispieldaten für den Testdurchlauf. In einer echten Einrichtung werden hier die Daten der realen Ligaverwaltungsperson eingetragen.

Das Demobild ist in diesem Unterpunkt ein referenziertes Beispiel-Asset. Es wird hier noch nicht in der Personenmaske hochgeladen.

2.4.3Person und Funktion anlegen

Person anlegen

1. Rufe die Login-Seite der Anwendung auf (Pfad: /login) und melde dich mit dem Adminzugang an.
2. Wechsle in den Admin-Bereich (Pfad: /admin).
3. Öffne in der Navigation Zugang den Bereich Personen.
4. Klicke Neu anlegen.
5. Trage die Personendaten ein. Nutze die Werte aus der Tabelle als Beispieldaten für den Testdurchlauf.
6. Setze den Status auf Aktiv und aktiviere Login aktiv.
7. Speichere mit Anlegen.

Verbandsfunktion zuordnen

1. Öffne in der Navigation Verbandsdaten den Bereich Verbandsfunktionen.
2. Klicke Neu anlegen.
3. Wähle den Verband ZauberForest Spielrunde und die angelegte Person.
4. Trage als freien Funktionstext Verbandsverwalter ein.
5. Wähle als Funktionstyp Verbandsverwalter.
6. Speichere mit Anlegen.
7. Klicke erneut Neu anlegen.
8. Wähle wieder den Verband ZauberForest Spielrunde und dieselbe Person.
9. Trage als freien Funktionstext Ligaleitung ein.
10. Wähle als Funktionstyp Ligaleitung.
11. Speichere mit Anlegen.

2.4.4Login und Arbeitsbereich prüfen

Login prüfen

1. Melde dich ab oder öffne die Anwendung in einem getrennten Browserprofil.
2. Rufe die Login-Seite auf (Pfad: /login).
3. Fordere für die Ligaverwaltungs-E-Mail einen Login-Link an.
4. Öffne den Login-Link und wechsle in den Admin-Bereich (Pfad: /admin).
5. Wähle den Arbeitsbereich Verband: ZauberForest Spielrunde - Verbandsverwalter.
6. Prüfe danach bei Bedarf zusätzlich den Arbeitsbereich Verband: ZauberForest Spielrunde - Ligaleitung.

Erwartetes Ergebnis

• Die Person Luminara Funkelblatt ist aktiv und loginfähig.
• Die Person hat beim Verband ZauberForest Spielrunde je eine Verbandsfunktion Verbandsverwalter und Ligaleitung.
• Der Login mit der Ligaverwaltungs-E-Mail funktioniert.
• Im Admin-Bereich ist ein Arbeitsbereich für ZauberForest Spielrunde verfügbar.
• Im Verbandsverwalter-Arbeitsbereich sind Verbandsdaten und Saison & Ligastruktur sichtbar.
• Im reinen Ligaleitung-Arbeitsbereich ist Saison & Ligastruktur sichtbar; Verbandsdaten bleibt dort ausgeblendet.

Checkliste

Prüfe nach der Einrichtung:

2.4.5Bedienung und Fehlerbilder

Bedienelemente

Typische Fehler

• Wenn kein Login-Link ankommt, prüfe Mailer-Konfiguration und Entwicklungs-Mailumleitung.
• Wenn der Login nicht funktioniert, prüfe E-Mail, Personenstatus und Login aktiv.
• Wenn eine Person in der Funktionsauswahl ausgegraut ist, fehlen aktive Person, E-Mail oder Login aktiv.
• Wenn kein Arbeitsbereich sichtbar ist, fehlt die Verbandsfunktion oder sie ist dem falschen Verband zugeordnet.
• Wenn Saison & Ligastruktur fehlt, prüfe den Funktionstyp. Öffentlicher Ansprechpartner reicht nicht für die Ligaverwaltung.
• Wenn Verbandsdaten im reinen Ligaleitung-Arbeitsbereich fehlt, ist das korrekt. Für Verbandsstammdaten braucht die Person zusätzlich Verbandsverwalter.
• Wenn die Person nur als Plattformadministrator angelegt ist, fehlt weiterhin die fachliche Verbandsrolle.

2.5Verein anlegen

Unterpunkte

• 2.5.1 Ziel und Zugriff: Rolle, Berechtigung und Voraussetzungen klären.
• 2.5.2 Beispieldaten: Werte für den ersten Verein bereithalten.
• 2.5.3 Verein erfassen: Vereinsdatensatz im Admin-Bereich anlegen.
• 2.5.4 Öffentliche Anzeige prüfen: Sichtbarkeit im Frontend kontrollieren.
• 2.5.5 Bedienung und Fehlerbilder: Bedienelemente und typische Stolperstellen nachschlagen.

2.5.1Ziel und Zugriff

Ziel

Der erste aktive Verein wird als Stammdatensatz angelegt. Dieser Verein bildet später die Grundlage für Vereinsverantwortliche, Teams, Spielstätten, Trainingszeiten und Mannschaftsmeldungen.

Rolle und Zugriff

• Systemadmin.
• Reine Ligaleitung sieht Vereinsdaten nicht. Das ist in diesem Unterpunkt erwartet: Vereine werden als Stammdaten durch den Systemadmin vorbereitet.

Voraussetzungen

• Der Verband ZauberForest Spielrunde ist aktiv.
• Du hast einen Systemadmin-Zugang.

2.5.2Beispieldaten

Die Werte in der Tabelle sind Beispieldaten für den Testdurchlauf. In einer echten Einrichtung werden hier die Daten des realen Vereins eingetragen.

In diesem Unterpunkt wird nur ein Verein manuell angelegt und geprüft. Weitere Demo-Vereine können später nach demselben Muster oder über den internen Demo-Aufbau ergänzt werden.

Das Feld Telefon bleibt in diesem Testdurchlauf leer. Ein Vereinslogo wird erst in einem späteren Bild-/Asset-Unterpunkt geprüft.

2.5.3Verein erfassen

Einloggen und Bereich öffnen

1. Rufe die Login-Seite der Anwendung auf (Pfad: /login) und melde dich als Systemadmin an.
2. Wechsle in den Admin-Bereich (Pfad: /admin).
3. Öffne in der Navigation Vereinsdaten den Bereich Vereinsdaten.
4. Wenn du noch als Ligaleitung angemeldet bist, melde dich ab und wieder mit dem Systemadmin-Zugang an.

Verein anlegen

1. Klicke Neu anlegen.
2. Trage die Daten ein. Nutze die Werte aus der Tabelle als Beispieldaten für den Testdurchlauf.
3. Prüfe, dass das Feld Verband ZauberForest Spielrunde zeigt.
4. Setze den Status auf Aktiv.
5. Lasse Telefon leer.
6. Speichere mit Anlegen.
7. Prüfe in der Liste, dass Feldberg Füchse mit Kurzname FBF vorhanden ist.

2.5.4Öffentliche Anzeige prüfen

Frontend prüfen

1. Prüfe die öffentliche Seite Verbandsdaten (Pfad: /master-data).
2. Prüfe im Unterpunkt Vereine, dass Feldberg Füchse sichtbar ist.
3. Prüfe, dass E-Mail und Website beim Verein angezeigt werden.
4. Prüfe, dass der Hinweis zu fehlenden aktiven Vereinen nicht mehr sichtbar ist.
5. Prüfe die Teamanzeige beim Verein: In einem frischen Aufbau werden noch keine öffentlichen Teams angezeigt; in einem bereits vollständig eingerichteten Demo-Zustand dürfen dort passende Teams des Vereins erscheinen.

Erwartetes Ergebnis

• Im Admin-Bereich existiert der aktive Verein Feldberg Füchse.
• Der Verein ist dem Verband ZauberForest Spielrunde zugeordnet.
• Auf der öffentlichen Seite Verbandsdaten erscheint Feldberg Füchse im Unterpunkt Vereine.
• E-Mail und Website werden öffentlich angezeigt.
• In einem frischen Aufbau zeigt der Verein noch keine öffentlichen Teams. In einem weiter aufgebauten Demo-Zustand sind angezeigte Teams korrekt, wenn sie zum Verein gehören.

Checkliste

Prüfe nach dem Speichern:

2.5.5Bedienung und Fehlerbilder

Bedienelemente

Typische Fehler

• Wenn Vereinsdaten nicht sichtbar ist, fehlt im aktuellen Arbeitsbereich das passende Recht.
• Wenn du als Ligaleitung angemeldet bist, ist das erwartbar. Melde dich für diesen Unterpunkt als Systemadmin an.
• Wenn der Verein öffentlich nicht erscheint, prüfe Verband, Status und ob die öffentliche Seite neu geladen wurde.
• Wenn ein Verein bereits existiert, öffne den vorhandenen Datensatz zum Bearbeiten statt einen zweiten anzulegen.
• Wenn die Website nicht gespeichert wird, prüfe, ob die Adresse vollständig mit https:// beginnt.
• Wenn noch keine Teams beim Verein sichtbar sind, ist das nach diesem Unterpunkt korrekt. Teams folgen erst im Verein-Kontext.

2.6Vereinszugang einrichten

Unterpunkte

• 2.6.1 Ziel und Zugriff: Rolle, Berechtigung und Voraussetzungen klären.
• 2.6.2 Beispieldaten: Werte für die erste Vereinsverantwortliche bereithalten.
• 2.6.3 Person anlegen: Loginfähige Person im Admin-Bereich erfassen.
• 2.6.4 Vereinsmitgliedschaft anlegen: Person als Mitglied im Verein führen und Foto pflegen.
• 2.6.5 Vereinsfunktion anlegen: Person dem Verein als Vereinsverwalter zuordnen.
• 2.6.6 Zugang vorbereitend prüfen: Arbeitsbereich und Zuordnung kontrollieren.
• 2.6.7 Bedienung und Fehlerbilder: Bedienelemente und typische Stolperstellen nachschlagen.

2.6.1Ziel und Zugriff

Ziel

Der erste Vereinszugang wird eingerichtet, damit der nächste Durchlauf im Verein-Kontext nicht mit dem Systemadmin erfolgt.

Rolle und Zugriff

• Einrichtung durch Systemadmin.
• Zielrolle: Vereinsverwalter für genau einen Verein.
• Die Person wird zusätzlich als aktives Vereinsmitglied geführt.
• In diesem Unterpunkt wird noch kein Team zugeordnet. Ein Vereinsverwalter arbeitet auf Vereinsebene.

Voraussetzungen

• Der Verein Feldberg Füchse ist angelegt und aktiv.
• Die Person ist noch nicht als Vereinsverwalter für diesen Verein zugewiesen.
• Der Login-Link-Versand oder die Entwicklungs-Mailumleitung ist vorbereitet.

2.6.2Beispieldaten

Die Werte in der Tabelle sind Beispieldaten für den Testdurchlauf. In einer echten Einrichtung werden hier die Daten der realen Vereinsverantwortlichen eingetragen.

Die Vereinsfunktion wird wie die Verbandsfunktion im EasyAdmin-Kontext gepflegt. Trage Funktionstext und Funktionstyp manuell ein. Ein Team wird dabei bewusst nicht ausgewählt.

2.6.3Person anlegen

Einloggen und Bereich öffnen

1. Rufe die Login-Seite der Anwendung auf (Pfad: /login) und melde dich als Systemadmin an.
2. Wechsle in den Admin-Bereich (Pfad: /admin).
3. Öffne in der Navigation Zugang den Bereich Personen.

Person erfassen

1. Klicke Neu anlegen.
2. Trage Vorname, Name, E-Mail und Geburtsdatum ein. Nutze die Werte aus der Tabelle als Beispieldaten für den Testdurchlauf.
3. Setze den Status auf Aktiv.
4. Aktiviere Login aktiv.
5. Speichere mit Anlegen.
6. Prüfe in der Personenliste, dass Felia Fuchspfad mit der E-Mail verein.fbf@ligawerk.de vorhanden ist.

2.6.4Vereinsmitgliedschaft anlegen

Mitgliedschaften öffnen

1. Bleibe als Systemadmin im Admin-Bereich.
2. Öffne in der Navigation Personen & Offizielle den Bereich Mitgliedschaften.
3. Klicke Mitgliedschaft anlegen.

Mitgliedschaft speichern

1. Wähle als Person Felia Fuchspfad.
2. Wähle als Verein Feldberg Füchse.
3. Setze den Mitgliedschaftsstatus auf Aktiv.
4. Trage als Mitgliedsnummer FBF-ADMIN ein.
5. Trage als Eintritt 2025-09-01 ein.
6. Speichere mit Anlegen.
7. Prüfe in der Liste, dass Felia Fuchspfad als Mitglied von Feldberg Füchse sichtbar ist.

Personenfoto pflegen

1. Öffne die Mitgliedschaft Felia Fuchspfad.
2. Klicke die Aktion Foto.
3. Wähle die Bilddatei aus den Beispieldaten.
4. Aktiviere Personenfoto öffentlich anzeigen.
5. Speichere mit Bild speichern.
6. Prüfe in der Mitgliedschaft, dass das Foto hinterlegt ist.

2.6.5Vereinsfunktion anlegen

Kontakte und Rollen öffnen

1. Bleibe als Systemadmin im Admin-Bereich.
2. Öffne in der Navigation Zugang den Bereich Vereinsverwalter.
3. Klicke Neu anlegen.

Zuordnung speichern

1. Wähle als Person Felia Fuchspfad.
2. Wähle als Verein Feldberg Füchse.
3. Lasse Team leer.
4. Trage als freien Funktionstext Vereinsverwalter ein.
5. Wähle als Funktionstyp Vereinsverwalter.
6. Speichere mit Anlegen.
7. Prüfe in der Liste, dass Feldberg Füchse mit Felia Fuchspfad und Funktion Vereinsverwalter angezeigt wird.

2.6.6Zugang vorbereitend prüfen

Admin-Prüfung

1. Öffne die Person Felia Fuchspfad in Zugang > Personen.
2. Prüfe, dass Login aktiv gesetzt ist.
3. Prüfe in der Personenübersicht, dass die Vereinsfunktion sichtbar ist.
4. Öffne Personen & Offizielle > Mitgliedschaften und prüfe, dass die aktive Mitgliedschaft vorhanden ist.
5. Öffne Zugang > Vereinsverwalter und prüfe, dass die Funktion Vereinsverwalter keinen Teambezug hat.

Login-Prüfung

1. Melde dich ab oder öffne die Anwendung in einem getrennten Browserprofil.
2. Rufe die Login-Seite auf (Pfad: /login).
3. Fordere für verein.fbf@ligawerk.de einen Login-Link an.
4. Öffne den Login-Link und wechsle in den Admin-Bereich (Pfad: /admin).
5. Prüfe, dass der Arbeitsbereich Verein: Feldberg Füchse - Vereinsverwalter sichtbar oder direkt aktiv ist.

Die fachliche Prüfung der Vereinsdaten folgt im nächsten Kapitel im Verein-Kontext. Hier wird nur geprüft, dass der Zugang und der Arbeitsbereich entstehen.

Projektteam-Hinweis: Nach dem manuellen Test für Felia Fuchspfad können die übrigen Demo-Vereinszugänge intern ergänzt werden. Die Ergänzung setzt nur Personen, aktive Vereinsmitgliedschaften und Vereinsverwalter-Funktionen für bereits vorhandene Demo-Vereine. Die Foto-Ergänzung setzt nur Vereinsverwalterfotos für bereits vorhandene Demo-Vereinsmitgliedschaften.

php bin/console app:demo:seed-zauberforest-club-admins
php bin/console app:demo:seed-zauberforest-club-admins --force
php bin/console app:demo:seed-zauberforest-club-admin-photos
php bin/console app:demo:seed-zauberforest-club-admin-photos --force

Checkliste

2.6.7Bedienung und Fehlerbilder

Bedienelemente

Typische Fehler

• Wenn die Person im Bereich Vereinsverwalter nicht auswählbar ist, prüfe, ob die Person angelegt ist.
• Wenn der Verein im Bereich Vereinsverwalter nicht auswählbar ist, prüfe, ob der Verein angelegt ist.
• Wenn die Person in späteren Vereins-Workflows fehlt, prüfe zusätzlich die aktive Vereinsmitgliedschaft.
• Wenn kein Login-Link ankommt, prüfe Mailer-Konfiguration und Entwicklungs-Mailumleitung.
• Wenn der Login nicht funktioniert, prüfe E-Mail, Personenstatus und Login aktiv.
• Wenn kein Vereins-Arbeitsbereich sichtbar ist, fehlt die Vereinsfunktion, der Funktionstyp ist falsch oder sie wurde für den falschen Verein gespeichert.
• Wenn eine Teamzuordnung an der Vereinsverwalter-Funktion hängt, ist die Rolle falsch geschnitten. Vereinsverwalter müssen ohne Teambezug angelegt sein.

2.7Aktionsprotokoll als Systemadmin nutzen

Ziel

Systemadmins können im Aktionsprotokoll nachvollziehen, welche angemeldete Person wann welche gespeicherte Änderung ausgelöst hat. Der Unterpunkt ist ein Support-Werkzeug: Er hilft bei Fragen wie Wer hat diese Lizenz geändert?, Wann wurde der Spielbericht freigegeben? oder Über welchen Bereich wurde der Datensatz gelöscht?.

Rolle und Zugriff

• Nur Systemadmin sieht und nutzt das Aktionsprotokoll.
• Verbands- und Vereinsrollen haben keinen Zugriff auf die Auswertung.
• Das Aktionsprotokoll ist read-only. Es wird nicht manuell bearbeitet.
• Wenn Fachrollen eine Änderung nachvollziehen müssen, wenden sie sich an Support oder Systemadmin.

Voraussetzungen

• Du bist als Systemadmin angemeldet.
• Es gibt mindestens eine gespeicherte Änderung in der Anwendung, zum Beispiel eine neu angelegte Person, eine bearbeitete Lizenz oder eine gespeicherte Schiri-Verfügbarkeit.
• Der betroffene Datensatz oder die betroffene Workflow-Aktion ist fachlich bekannt, damit du nach Person, Datensatz oder Bereich filtern kannst.

Typische Supportfragen

Schritte

1. Rufe die Login-Seite auf (Pfad: /login) und melde dich als Systemadmin an.
2. Wechsle in den Admin-Bereich (Pfad: /admin).
3. Öffne in der Navigation Systemadministration den Bereich Aktionsprotokoll (Pfad: /admin/audit-log).
4. Prüfe die neuesten Einträge. Die Liste ist nach Zeitpunkt und ID absteigend sortiert.
5. Filtere bei Bedarf nach auslösender Person (Actor), Art der Änderung (Operation), Datensatzart (Objekt-Typ), Datensatznummer (Objekt-ID), Bereich (Route/Pfad) oder Arbeitskontext.
6. Öffne einen Eintrag mit Details.
7. Prüfe im Detail, ob Person, Änderung, Datensatz, Bereich und Arbeitskontext zur fachlichen Aktion passen.
8. Nutze die angezeigte Objekt-ID oder eine sichtbare #<id>-Referenz in Listen und Detailseiten, um denselben Datensatz wiederzufinden.
9. Wechsle für fachliche Korrekturen zurück in die passende Verwaltungsseite. Das Aktionsprotokoll selbst wird nicht geändert.

Bedienelemente

Erwartetes Ergebnis

• Jede gespeicherte Änderung eines eingeloggten Nutzers erzeugt eine Zeile im Aktionsprotokoll.
• Die Zeile zeigt mindestens auslösende Person, Art der Änderung, Datensatzart, Datensatznummer, Bereich und Arbeitskontext, soweit fachlich vorhanden.
• Technische IDs sind in Backend-Listen und Detailseiten als #<id> oder ID <nummer> wiedererkennbar.
• Personenbezogene Inhalte in Lösch-Snapshots werden maskiert, wenn sie für Support und Nachvollziehbarkeit nicht im Klartext nötig sind.

Typische Fehler

• Wenn Aktionsprotokoll nicht sichtbar ist, bist du wahrscheinlich nicht im Systemadmin-Kontext angemeldet.
• Wenn eine erwartete Änderung fehlt, prüfe zuerst, ob die Aktion wirklich gespeichert wurde und nicht nur eine Seite geöffnet oder ein Formular angezeigt hat.
• Wenn der Arbeitskontext leer ist, prüfe, ob die Aktion außerhalb eines Vereins- oder Verbandsarbeitsbereichs lief.
• Wenn ein Filter nichts findet, suche zunächst nach Objekt-ID oder Bereich und grenze danach Person und Zeitraum ein.
• Wenn personenbezogene Daten in einem Lösch-Eintrag maskiert sind, ist das erwartetes Datenschutzverhalten. Nutze Datensatznummer, Art der Änderung und Kontext für die fachliche Zuordnung.

Checkliste

Ausblick

Nach der Admin-Grundeinrichtung geht der manuelle Aufbau im passenden Arbeitskontext weiter: