6. Betrieb und Wartung¶

Nach der Installation beginnt die eigentliche Arbeit. Eine stabile Pfarrplaner-Instanz lebt davon, dass wiederkehrende Betriebsaufgaben zuverlässig erledigt werden.

6.1. Regelmäßige Aufgaben¶

Logs prüfen
Backups kontrollieren
freien Speicherplatz überwachen
Queue-Worker und Scheduler prüfen
Mailzustellung beobachten
Sicherheitsupdates des Betriebssystems einspielen

6.2. Wichtige Anwendungsbereiche im Betrieb¶

6.2.1. Konfiguration¶

Die zentrale Laufzeitkonfiguration liegt in der .env. Änderungen dort sollten bewusst dokumentiert werden. Im Docker-Betrieb werden Laravel-Befehle über den Root-Einstieg ausgeführt, zum Beispiel ./planer exec app php artisan optimize.

6.2.2. Caches¶

Laravel und Vite arbeiten mit verschiedenen Caches. Nach Änderungen an Konfiguration, Views oder Assets ist es sinnvoll, den Cachezustand bewusst zu prüfen statt blind viele Befehle nacheinander auszuführen.

6.2.3. Queue¶

Sobald Pfarrplaner Hintergrundaufgaben nutzt, brauchen Sie eine überwachte Worker-Instanz. Ein abgestürzter Queue-Worker fällt im Alltag oft erst spät auf, wenn E-Mails, Exporte oder Folgeaktionen nicht mehr ankommen.

In der Produktionsumgebung ist Horizon der Queue-Worker für ausgehende Mails. Postfix verwaltet zusätzlich seine eigene persistente Zustellwarteschlange. Prüfen Sie beide Ebenen mit ./planer exec app php artisan queue:failed und den Postfix-Logs. Details stehen im Mail-Betriebskapitel.

6.2.4. Scheduler¶

Der Scheduler sollte einmal pro Minute laufen. Fehlt dieser Cronjob oder ist er defekt, bleiben geplante Aufgaben liegen.

6.2.5. Dateispeicher¶

Anhänge, Bilder und andere Dateien liegen im Produktionsbetrieb im MinIO-Bucket. Sie müssen im Backup enthalten sein; lokale Containerdateien oder storage/ allein sind dafür nicht ausreichend. Prüfen Sie außerdem Speicherplatz und Zugriff auf das MinIO-Volume.

6.3. Prüfliste nach Server-Arbeiten¶

Wenn Sie am Server, an PHP oder an Docker-Grundlagen gearbeitet haben, prüfen Sie danach mindestens:

Login
Datei-Uploads
Berichte und PDF-Ausgaben
Mails
Kalender- und Editoransichten

6.4. Rechte und Rollen in der Anwendung¶

Zur technischen Administration gehört auch ein klares Verständnis der administrativen Oberfläche:

Benutzer
Rollen
Gemeinden
Orte
Vertretungs-Pools
Lieder und liturgische Texte

Diese Inhalte werden funktional im Benutzerhandbuch beschrieben. Dieses Administratorhandbuch ergänzt dazu die Betriebs- und Sicherheitsaspekte.

6.5. Gelöschte Fachdaten¶

Für Gottesdienste, Abwesenheiten, Taufen, Bestattungen und Trauungen verwendet Pfarrplaner einen anwendungsinternen Papierkorb. Normales Löschen entfernt diese Datensätze also nicht sofort endgültig aus der Datenbank.

Für den Betrieb bedeutet das:

versehentlich gelöschte Einträge können über Administration → Papierkorb wiederhergestellt werden
der Papierkorb zeigt zusätzlich, welches Benutzerkonto die Löschung ausgelöst hat, solange die Aktion angemeldet erfolgt ist
zugehörige Anhänge bleiben bis zur Wiederherstellung oder endgültigen Löschung mit dem Facheintrag verknüpft
Einträge bleiben 30 Tage im Papierkorb und werden danach durch einen täglichen Bereinigungslauf endgültig gelöscht
endgültiges Löschen geschieht bewusst und getrennt im Papierkorb
Backups bleiben trotzdem notwendig, weil der Papierkorb keine historische Versionierung ersetzt

Wenn Benutzer melden, dass ein Eintrag "verschwunden" sei, prüfen Sie deshalb zuerst den Papierkorb, bevor Sie auf Datenbank- oder Backup-Ebene eingreifen.