1. Einführung¶
Pfarrplaner ist eine Laravel-Anwendung mit Inertia.js und Vue, die als Docker-Stack betrieben wird. Das System verbindet klassische Serverlogik, ein modernes Single-Page-Frontend, dokumentenorientierte Ausgaben und eine API-Landschaft für Kalender-, Liturgie- und Verwaltungsfunktionen.
1.1. Technischer Kern¶
- Backend: Laravel
- Frontend: Inertia.js mit Vue
- Build: Vite
- Authentifizierung: Laravel-Mechanismen und API-Schutz über
auth:apibzw. Sanctum-Bausteine im Projekt - Dokumente und Exporte: PDF-, Office- und HTML-Ausgaben
- Browser-Automatisierung: Puppeteer und Browsershot
1.2. Wichtige Betriebsmodi¶
- Docker-Compose-Entwicklung mit PHP-FPM, Caddy und Vite
- Docker-Compose-Produktion mit Octane/Swoole und Caddy
compose.yamlfür Entwicklung, Tests und den Manual-Buildcompose.production.yamlfür den produktiven Betrieb
Die Installation beginnt mit dem ausführlichen Docker-Ablauf. Alle betrieblichen Aktionen werden über ./planer im Repository-Root geführt; direkte Compose- oder Artisan-Aufrufe sind Sonderfälle für Diagnose und Entwicklung.
1.3. Drei technische Sichtweisen¶
- Domänenlogik: Gottesdienste, Kasualien, Benutzer, Orte, Urlaub, Liturgie.
- Betrieb: Root-
.env, MariaDB, Redis, MinIO, Horizon, Scheduler, Logs, Chromium und optional Postfix. - Schnittstellen: Web-Routen, API-Routen, OpenAPI, Exporte, externe Integrationen.