3. Architektur und Domänen¶
3.1. Stack-Struktur¶
Der technische Rahmen besteht aus zwei Compose-Varianten:
compose.yamlbindet den Laravel-Quellbaum für Entwicklung, Vite, Tests und den Manual-Container ein.compose.production.yamlverwendet ein versioniertes Anwendungsimage, Octane/Swoole, einen Asset-Snapshot und getrennte interne Netzwerke.
In beiden Varianten sind MariaDB, Redis, MinIO, Horizon und der Scheduler zentrale Abhängigkeiten. Caddy nimmt HTTP entgegen; Soketi ergänzt die WebSocket-Kommunikation. Serviceänderungen werden als schlanke Invalidierungen auf privaten Gemeinde-Kanälen übertragen. Der Browser lädt die betroffene Service-Repräsentation anschließend einzeln über die autorisierte API; nicht registrierte Ansichten verwenden einen Inertia-Fallback. Liturgische Jahreskalender werden bei fehlendem liturgy/<yyyy>.json beim ersten Zugriff automatisch von der Kirchenjahr-API geladen und im konfigurierten Storage abgelegt. Das Installationskapitel beschreibt den vollständigen Startablauf.
3.2. Backend-Struktur¶
Das Projekt folgt im Kern einer Laravel-Struktur, nutzt aber mehrere projektweite Konventionen:
- Modelle liegen domänenorientiert unter
app/Models/ - Web- und API-Controller sind getrennt
- Geschäftslogik wandert häufig in
app/Actions/ - Modelle registrieren ihre Routen selbst über
registerRoutes()undregisterApiRoutes()
3.3. Zentrale Domänen¶
- Gottesdienste und Veranstaltungen:
Service, Kalender, Mitwirkende, Werbung, Berichte - Kasualien: Taufen, Trauungen, Beerdigungen
- Benutzer und Rechte: Personen, versionierte Rollen-/Berechtigungskonfiguration und Gemeindezuordnungen
Die fachliche Rollenstruktur liegt in config/roles.php. Der Befehl
roles:sync gleicht die konfigurierten Rollen und Berechtigungen idempotent mit
der Datenbank ab. Der Standard ist nicht destruktiv: unbekannte bestehende
Einträge werden nicht automatisch gelöscht. Die Rolle
Super-Administrator:in bleibt als Gate-Ausnahme erhalten.
- Orte und Gemeinden: Kirchengemeinden, Pfarrämter, Veranstaltungsorte, Sitzpläne
- Urlaub und Vertretung: Abwesenheiten, Pools, Poolmaster
- Liturgie: Bausteine, Lieder, Psalmen, liturgische Texte
3.4. Soft-Delete-Domäne¶
Für Service, Absence, Baptism, Funeral, Wedding sowie fachlich abhängige Replacement- und AdConfig-Datensätze nutzt Pfarrplaner Soft Deletes.
Die fachliche Wirkung ist:
- normales Löschen verschiebt den Datensatz in den administrativen Papierkorb
- Standardabfragen zeigen diese Datensätze nicht mehr an
- bei angemeldeten Löschvorgängen wird das ausführende Benutzerkonto in
deleted_byprotokolliert - Einträge bleiben 30 Tage im Papierkorb und werden danach täglich automatisch per
trash:pruneendgültig gelöscht - Wiederherstellung und endgültiges Löschen laufen über eigene Admin-Flows
Bei Service werden die abhängigen Kasualien und AdConfig-Einträge mit soft-deleted; Occurence bleibt dagegen eine technische Projektion und wird beim Löschen entfernt und beim Restore neu aufgebaut.
Bei Absence werden die abhängigen Replacement-Datensätze mit soft-deleted und beim Restore wiederhergestellt.
Anhänge (Attachment) werden selbst nicht soft-deleted. Beim normalen Soft Delete des Elternobjekts bleiben ihre Datenbankeinträge und Dateien unverändert bestehen, damit sie beim Restore sofort wieder verfügbar sind. Beim forceDelete() des Elternobjekts werden die zugehörigen Attachment-Datensätze und ihre Dateien entfernt. Für Einträge im Papierkorb bleibt der normale Zugriff auf Anhänge gesperrt.
3.5. Routing-Modell¶
- Web-Routen werden zentral geladen und um zusätzliche Teilrouten ergänzt.
- API-Routen liegen unter
routes/api/*.php. - Modelle können eigene Web- und API-Routen registrieren.
3.6. Frontend-Modell¶
Das Frontend nutzt Inertia. Viele Seiten werden also serverseitig als Inertia-Responses erzeugt, während Vue die eigentliche Interaktion im Browser übernimmt.
Der Help-Button in der Topbar wird serverseitig mit einer Manual-Zuordnung versorgt und kann dadurch jetzt zwischen Benutzer- und Administratorhandbuch unterscheiden.
3.7. Dokumentenerzeugung¶
Pfarrplaner erzeugt nicht nur HTML, sondern viele Ausgabeformate:
- Word
- Excel
- HTML-Snippets
- Browser-basierte Renderings
Darum gehören Office-Bibliotheken, PDF-Rendering und Chromium-Laufzeit fest zur technischen Gesamtarchitektur.