So rufst du Befehle auf
Alle Befehle beginnen mitphp bin/console. Wo du sie eingibst, hängt von der Installationsart ab:
In den Beispielen unten steht nur der Teil ab
php bin/console. php bin/console list app zeigt alle Befehle von QuickTribe, php bin/console <befehl> --help die Optionen eines Befehls.
Erststart und Systemprüfung
app:install meldet je nach Lage „Plattform-Admin … angelegt“, „Es existieren bereits Konten – ADMIN_EMAIL wird ignoriert.“ oder „ADMIN_EMAIL/ADMIN_PASSWORD nicht gesetzt – kein Konto angelegt.“ Nach dem ersten Konto kannst du beide Variablen aus der Konfiguration entfernen.
Konten verwalten
Wartungsmodus
MAINTENANCE_MODE bzw. MAINTENANCE_PASSWORD den Wert fest, ändert der Befehl ihn nicht. Mehr unter Wartung.
E-Mail prüfen
app:mail:test <email> verschickt sofort – ohne den Hintergrunddienst – eine Testmail über den gerade gültigen Zugang (MAILER_DSN oder Plattform-Admin → E-Mail-Versand) und nennt bei Fehlern die Ursache: Anmeldung abgelehnt, Server nicht erreichbar, Verschlüsselung, Zeitüberschreitung, Absender abgelehnt.
php bin/console messenger:failed:show; nach dem Beheben verschickt php bin/console messenger:failed:retry sie erneut. Nach sieben Tagen werden sie gelöscht. Siehe E-Mail-Versand.
Templates
docker compose cp mein-theme.zip app:/tmp/. Details unter Theme installieren.
Zahlungen nachholen
app:billing:sync <slug> [--limit=50] holt verpasste Stripe-Ereignisse einer Community nach – etwa wenn die Ereignisse von Stripe (Event Destination bzw. Webhook) oder der Hintergrunddienst nicht ankamen: archiviert die jüngsten Rechnungen (Standard 50, höchstens 100) und ordnet sie Plänen und Kursen zu, gleicht Abos samt Zahlungsstatus ab und aktualisiert den Rechnungsfuß bei allen Stripe-Kunden. Gutschriften holt er nicht nach.
<slug> ist die Adresse der Community, also demo für /c/demo.
Push-Benachrichtigungen
app:push:keys gibt PUSH_VAPID_PUBLIC_KEY und PUSH_VAPID_PRIVATE_KEY aus; trage sie mit PUSH_VAPID_SUBJECT in die Konfiguration ein (siehe Konfiguration). app:push:test stellt die Nachricht in die Warteschlange, der Hintergrunddienst verschickt sie an alle Geräte, die das Konto unter Profil → Push-Benachrichtigungen angemeldet hat. Ob es geklappt hat, zeigen das Log des Workers und „zuletzt zugestellt“ beim Gerät. Mit --direct sendet der Befehl ohne Worker und zeigt je Gerät, ob der Push-Dienst die Mitteilung angenommen hat, ob das Abo abgelaufen war (es wird entfernt) oder warum er abgelehnt hat – dasselbe Ergebnis wie Test-Benachrichtigung senden in den Kontoeinstellungen des Nutzers (siehe Push testen und Probleme lösen). Meldet er „Der Server erreicht den Push-Dienst nicht“, darf der Server keine ausgehenden HTTPS-Verbindungen zu den Push-Diensten aufbauen (Firewall, Proxy). Weitere Fehlerbilder: Betrieb → Push-Benachrichtigungen prüfen.
Punkte korrigieren
app:points:adjust <slug> <email> <delta> [--note=…] schreibt eine manuelle Buchung ins Punktekonto eines Mitglieds und berechnet Punkte und Level neu. Negative Werte brauchen -- davor, damit sie nicht als Option gelten:
Externe Feeds prüfen
app:feed:fetch <url> [--user=…] [--link-host=…] [--limit=10] ruft einen Atom- oder RSS-Feed probeweise ab – mit denselben Regeln wie im Betrieb, einschließlich APP_FEED_ALLOWED_HOSTS – und zeigt die übernommenen Einträge mit Textlänge und die erkannten Threads. Gespeichert wird nichts. Das Passwort für eine HTTP-Anmeldung kommt aus der Umgebungsvariable FEED_PASSWORD oder wird verdeckt abgefragt.
docker compose exec -e FEED_PASSWORD='geheim' app php bin/console app:feed:fetch … mit. Wie Owner Feeds einrichten, steht unter Feeds.
Plugins
Plugins legt der Betreiber als Dateien auf den Server (siehe Plugins installieren); aktivieren kannst du sie unter Plattform-Admin → Plugins oder hier. Auf der Konsole ist keine erneute Anmeldung nötig; das Protokoll vermerkt die Konsole als Herkunft.app:plugin:list zeigt je Plugin ID, Name, Version, Status, die Zahl der Communities, in denen es eingeschaltet ist, und den ersten Hinweis – etwa den Grund für „unsicher“ oder die Meldung einer gescheiterten Migration. Was die Zustände bedeuten und was bei Fehlern hilft, steht unter Plugins betreiben.
Beispiel-Community anlegen
app:demo:seed --owner=<email> legt eine eigene, öffentliche Beispiel-Community mit erfundenen Inhalten an – zum Ausprobieren, für Schulungen oder ein Testsystem. Sie enthält rund 40 Mitglieder, Beiträge mit Kommentaren und Reaktionen, eine Umfrage, wiederkehrende Termine ohne Ende (wöchentlich, jeden 1. Sonntag, jeden 3. Montag, jeden letzten Montag), je einen Einzeltermin in jedem der nächsten sechs Monate (darunter ein Fest mit Warteliste), zwei Kurse mit einem laufenden Durchgang, ein Wiki, Nachrichten, Level und eine monatliche Challenge.
Profil Schützenverein und Demo-Logins
Das Profilschuetzenverein legt einen erfundenen Schützenverein an: rund 70 Mitglieder (darunter Jugendliche ab 12),
eigene Rollen „Vorstand“, „Schießleiter“, „Standaufsicht“, „Jugendleiter“, „Kasse“, „Theke“ und „Waffenwart“,
Beitragsklassen als vergebene kostenlose Pläne (Erwachsene, Jugend, Familie, Passiv – ohne Zahlungsabwicklung), Trainings
für Luftdruck, Kleinkaliber/Großkaliber, Jugend (nur unter 18) und Bogen, Rundenwettkämpfe auswärts, Jahrestermine wie
Königsschießen und Schützenfest, passende Beiträge, Kurse und ein Wiki mit Standordnung.
Dazu kommen acht Demo-Logins, mit denen du die Community aus Sicht jeder Rolle zeigen kannst:
vorstand@ (Owner), schiessleiter@ (Admin), aufsicht@, jugendleiter@ (Moderator), kasse@, theke@,
mitglied@ und jugend@ (15 Jahre), jeweils @musterhausen.demo.invalid. Alle nutzen ein gemeinsames Zufallspasswort,
das der Befehl nur bei der Anlage einmal anzeigt – notiere es dir. --refresh ändert es nicht; zurücksetzen kannst du
es je Konto mit app:user:password <email>. An diese Adressen geht nie eine E-Mail. Gibt es die Konten schon (etwa von
einer früheren, gelöschten Beispiel-Community), bricht der Befehl ab; entferne sie dann mit app:user:delete oder lege die
Community mit --no-logins --owner=… an.
Profil Reitverein
Das Profilreitverein legt den erfundenen „Reit- und Fahrverein Mustertal e.V.“ an und zeigt, wie ein Reitverein die
Plattform nutzt:
- Reitstunden mit begrenzten Plätzen: Abteilungsreiten auf acht Schulpferden und die Dressurstunde haben feste Plätze mit Warteliste – wer zusagt, hat sein Pferd, alle anderen rücken nach. Zusagen des Teams belegen keinen Platz (die Reitlehrerin sagt zu ihrer Stunde zu, ohne ein Schulpferd zu blockieren).
- Dienste: „Arbeitseinsatz“ (4 im Jahr), „Stalldienst“ (3) und „Turnierhelfer“ (2). Der Stalldienst am Sonntag ist ein Dienst-Termin, die Springstunde hat die Aufgabe „Parcoursaufbau“, die Reitertage haben „Meldestelle“, „Parcoursdienst“ und „Kuchentheke“ zum Eintragen.
- Termine rund ums Pferd: Voltigieren (nur unter 18), Ausritt am ersten Sonntag, Turniere auswärts, Sammeltermin Impfung, Hufschmied mit acht Plätzen, Lehrgang Reitabzeichen, Ferienreittag, Reiterball mit Tickets und Warteliste.
- Rollen und Mitgliedsarten: „Vorstand“, „Reitlehrer“, „Jugendwart“, „Sportwart“, „Kasse“, „Stallmeister“ und „Einsteller“; Mitglieder sehen „Mitgliedsart“ statt „Plan“ (Erwachsene, Jugend, Familie, Fördermitglied – vergeben, ohne Zahlungsabwicklung). Die Startseite zeigt keinen Preis, der Kalender steht im Menü weit vorn, und die Community trägt das mitgelieferte Template „Reiterhof“.
- Kurse und Wiki: „Theorie fürs Reitabzeichen“ (mit Durchgang), „Erste Hilfe am Pferd“ (ab 18, mit Bescheinigung), „Stallführerschein“ (unter 18, mit Urkunde); im Wiki das Stallhandbuch mit Reit- und Hallenordnung, Stallordnung, Arbeitsstunden, Notfall und Impfungen.
vorstand@ (Owner), reitlehrer@ (Admin), jugendwart@ (Moderator), sportwart@,
kasse@, stall@, einsteller@, jugend@ (14 Jahre) und mitglied@, jeweils @mustertal.demo.invalid. Für Passwort
und vorhandene Konten gilt dasselbe wie beim Schützenverein.
Gibt es die Adresse schon, bricht der Befehl ab – bestehende Communities verändert er nie, auch nicht mit --refresh. Aktive Plugins, die je Community gelten, schaltet der Befehl in seiner Beispiel-Community ein und lässt sie eigene Beispieldaten anlegen; die Ausgabe nennt je Plugin das Ergebnis (ok, skipped, failed). Bei --refresh kommen nur neu hinzugekommene Plugins dazu – eines, das du dort ausgeschaltet hast, bleibt aus. Ein Profil kann Plugins auslassen, die nicht zum Verein passen; die Ausgabe nennt sie, und du kannst sie in der Community von Hand einschalten. Die Beispiel-Mitglieder haben Adressen der Form [email protected] (Demo-Logins …@musterhausen.demo.invalid bzw. …@mustertal.demo.invalid), an die nie etwas verschickt wird. Der Befehl selbst löst keine E-Mails, Benachrichtigungen oder Push-Mitteilungen aus. Am Ende zeigt er je Bereich, wie viel angelegt wurde, und das Protokoll unter Plattform-Admin → Protokoll erhält einen Eintrag community.demo_seeded.
Danach läuft die Beispiel-Community wie jede andere: Der geplante Beitrag erscheint nach drei Tagen, Geburtstage tauchen im Feed auf, Teilnahme-Punkte und der Monatsabschluss der Challenge kommen automatisch. Wer neue Beiträge der Community abonniert hat – etwa du als Owner –, bekommt dabei die üblichen Benachrichtigungen.
Die Beispiel-Community ist öffentlich und erscheint im Community-Verzeichnis; ausblenden kannst du sie unter Plattform-Admin → Communities. Gab es bisher nur eine Community, leitet die Startseite
/ nicht mehr direkt dorthin weiter, sondern zeigt die Übersicht der Communities – bis die Beispiel-Community wieder gelöscht ist.Löschen kann sie nur ihr Owner unter Einstellungen → Übergabe und Löschen (siehe Übergabe und Löschen). Ihre Adresse bleibt danach belegt – eine neue Beispiel-Community braucht dann ein anderes --slug. Die Beispiel-Konten (…@demo.invalid, auch die Demo-Logins) bleiben ebenfalls bestehen und erscheinen in der Nutzerliste; du entfernst sie mit app:user:delete:Bankleitzahlen aktualisieren
Bankname und BIC deutscher Konten für die Lastschrift kommen aus der Bankleitzahlendatei der Bundesbank, die jedem Release beiliegt. Meldetapp:doctor sie als abgelaufen und steht kein Update an, spielst du die aktuelle Datei selbst ein – heruntergeladen im TXT-Format von der Bundesbank, die Gültigkeit steht auf der Download-Seite:
--dry-run prüft der Befehl nur. Eine falsche oder abgelaufene Datei lehnt er ab, ohne etwas zu ändern.