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.4.1 Anwendung 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.4.2 Systemzugang 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.4.3 Verband 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 Erstellen.
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 Abschnitt 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.4.4 Ligaverwaltung einrichten

Abschnittsübersicht

• 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.1 Ziel und Zugriff

Ziel

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

Rolle und Zugriff

• Einrichtung durch Systemadmin.
• Zielrolle: 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.2 Beispieldaten

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 Block ein referenziertes Beispiel-Asset. Es wird hier noch nicht in der Personenmaske hochgeladen.

2.4.3 Person 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 Erstellen.

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 Ligaleitung ein.
5. Wähle als Funktionstyp Ligaleitung.
6. Speichere mit Erstellen.

2.4.4 Login 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 der Ligaverwaltung für ZauberForest Spielrunde.

Erwartetes Ergebnis

• Die Person Luminara Funkelblatt ist aktiv und loginfähig.
• Die Person hat beim Verband ZauberForest Spielrunde die Verbandsfunktion Ligaleitung.
• Der Login mit der Ligaverwaltungs-E-Mail funktioniert.
• Im Admin-Bereich ist ein Arbeitsbereich für ZauberForest Spielrunde verfügbar.
• Im Arbeitsbereich ist Saison & Ligastruktur sichtbar.

Checkliste

Prüfe nach der Einrichtung:

2.4.5 Bedienung 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 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 die Person nur als Plattformadministrator angelegt ist, fehlt weiterhin die fachliche Verbandsrolle.

2.4.5 Verein anlegen

Abschnittsübersicht

• 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.1 Ziel 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 Block erwartet: Vereine werden als Stammdaten durch den Systemadmin vorbereitet.

Voraussetzungen

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

2.5.2 Beispieldaten

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 Block wird nur ein Verein manuell angelegt und geprüft. Weitere Demo-Vereine können später nach demselben Muster oder per gezieltem Seed ergänzt werden.

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

2.5.3 Verein 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 Erstellen.
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 Abschnitt 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, dass beim Verein noch keine öffentlich sichtbaren Teams angezeigt werden.

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 Abschnitt Vereine.
• E-Mail und Website werden öffentlich angezeigt.
• Solange noch keine Teams angelegt sind, zeigt der Verein noch keine öffentlichen Teams.

Checkliste

Prüfe nach dem Speichern:

2.5.5 Bedienung 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 Block 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 Block korrekt. Teams folgen erst im Verein-Kontext.

2.4.6 Vereinszugang einrichten

Abschnittsübersicht

• 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.1 Ziel 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 Block 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.2 Beispieldaten

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.3 Person 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 Erstellen.
6. Prüfe in der Personenliste, dass Felia Fuchspfad mit der E-Mail verein.fbf@ligawerk.de vorhanden ist.

2.6.4 Vereinsmitgliedschaft anlegen

Mitgliedschaften öffnen

1. Bleibe als Systemadmin im Admin-Bereich.
2. Öffne in der Navigation Vereinsdaten den Bereich Mitgliedschaften.
3. Klicke Mitglied hinzufügen.

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 Mitglied speichern.
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.5 Vereinsfunktion anlegen

Kontakte und Rollen öffnen

1. Bleibe als Systemadmin im Admin-Bereich.
2. Öffne in der Navigation Vereinsdaten den Bereich Kontakte & Rollen.
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 Erstellen.
7. Prüfe in der Liste, dass Feldberg Füchse mit Felia Fuchspfad und Funktion Vereinsverwalter angezeigt wird.

2.6.6 Zugang 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 Vereinsdaten > Mitgliedschaften und prüfe, dass die aktive Mitgliedschaft vorhanden ist.
5. Öffne Vereinsdaten > Kontakte & Rollen 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.

Nach dem manuellen Test für Felia Fuchspfad können die übrigen Demo-Vereinszugänge gezielt per Seed ergänzt werden. Der Zugangs-Seed setzt nur Personen, aktive Vereinsmitgliedschaften und Vereinsverwalter-Funktionen für bereits vorhandene Demo-Vereine. Der Foto-Seed 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.7 Bedienung und Fehlerbilder

Bedienelemente

Typische Fehler

• Wenn die Person in Kontakte & Rollen nicht auswählbar ist, prüfe, ob die Person angelegt ist.
• Wenn der Verein in Kontakte & Rollen 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.

Ausblick

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