Files
LektorenPlan/web
..
2026-11-12 20:00:33 +01:00
2026-11-12 20:00:33 +01:00
2026-11-12 20:00:33 +01:00
2026-11-12 20:00:33 +01:00
2026-11-12 20:00:33 +01:00
2026-11-12 20:00:33 +01:00
2026-11-12 20:00:33 +01:00

LektorenPlan Web

Browserbasierte, funktional entsprechende Umsetzung der macOS-App LektorenPlan: Gottesdienstplan, Gottesdienstordnung, Teamverwaltung, Statistik, Austausch, liturgischer Kalender, PDF/ Druck und eine Mehrbenutzerverwaltung mit Mandanten.

Die Webversion läuft als einzelner Go-Prozess mit einer SQLite-Datenbank. Sie ist CGO-frei und lässt sich damit unkompliziert für Linux/arm64 (z. B. Raspberry Pi, ARM-Server, Docker) bauen. Die bestehende macOS-App bleibt unverändert nutzbar.

Funktionsumfang

  • Gottesdienstplan mit Tageszeilen, Lesungen, Kirchenspalten, Feiertagen und farblich markierter Liturgie; Lesungen verlinken direkt auf die Tagesliturgie bei Schott
  • Zeitstrahl mit Marken des Kalender- und Kirchenjahres sowie erkennbaren Monaten mit vorhandenen Planungsdaten
  • Zeitraum-Presets für Quartale, Weihnachts- und Osterzeit sowie 3, 6 oder 12 Monate im Anschluss an die letzten Planungsdaten
  • Personenfilter im Plan: Leser filtern nach ihrer verknüpften Person, Redakteure nach beliebigen Personen
  • Automatische Planung mit Ausschlüssen, Präferenzen, Fairness und Doppelrollen-Regeln; manuelle Nachsteuerung inklusive Sperren
  • Gottesdienstordnung mit wiederkehrenden Vorlagen, Ausnahmen und Sondergottesdiensten (auch außerhalb der Kirche)
  • Team & Abwesenheiten mit Rollen, Präferenzen, Monatslimits und Einsatzhistorie
  • Statistik über Besetzung, Fairness, Monatsverlauf und Kirchenverteilung
  • Austausch per JSON-Export und zweistufigem Import mit Vorschau
  • Liturgischer Kalender für das Erzbistum Köln mit Online-Aktualisierung, Offline-Snapshot und lokaler Berechnung als Rückfallebene
  • PDF/Druck in zwei Varianten: A4 quer als vollständiger Plan und A4 hoch als kompakte Gottesdienstliste
  • Mandanten, Konten und Kirchen zentral über die Administration verwalten
  • Sichere Anmeldung mit initialem Passwort und erzwungener eigener Passwortvergabe beim ersten Login; Administratoren können Passwörter zurücksetzen
  • Administrator-konfigurierbarer Anmeldespruch unter dem Logo; globale Website-Einstellungen sind ausschließlich für Administratoren sichtbar

Schnellstart

Voraussetzung: Go 1.27 oder neuer.

cd web
go run . -seed-demo -demo

Anschließend http://localhost:8080 öffnen.

Die Demo-Datenbank wird beim ersten Start angelegt. Mit den dokumentierten Demo-Zugängen erhält man sofort einen vollständigen Plan:

Konto Passwort Rolle
admin admin123 Administrator
editor editor123 Redakteur
reader reader123 Leser

Beim ersten Anmelden muss für jedes Konto ein eigenes Passwort vergeben werden. Die Demo-Zugänge sind ausschließlich für lokale Tests gedacht. In einer produktiven Installation -seed-demo weglassen und ein eigenes Administratorkonto anlegen.

Ohne -seed-demo und ohne vorhandene Konten erzeugt der Server automatisch einen Administrator. Wird kein Passwort übergeben, wird ein einmaliges Zufallspasswort im Log ausgegeben:

go run . -db /var/lib/lektorenplan/lektorenplan.db \
  -admin-user admin -admin-password 'ein-sicheres-passwort'

Konfiguration

Alle Flags lassen sich auch über Umgebungsvariablen setzen:

Flag Umgebungsvariable Standard Bedeutung
-addr LP_ADDR :8080 HTTP-Listenadresse
-db LP_DB lektorenplan.db Pfad zur SQLite-Datei
-seed-demo LP_SEED_DEMO false Demo-Mandanten und Demo-Konten anlegen
-admin-user LP_ADMIN_USER admin Benutzername des ersten Administrators
-admin-password LP_ADMIN_PASSWORD – Passwort des ersten Administrators
-secure-cookies LP_SECURE_COOKIES false Cookies nur über HTTPS senden
-demo LP_DEMO_MODE false Demo-Hinweis in der Oberfläche anzeigen
-sync-liturgy LP_SYNC_LITURGY true Liturgischen Kalender täglich im Hintergrund aktualisieren

Rollen und Mandanten

Jedes Konto hat genau eine globale Rolle:

  • Administrator verwaltet alle Mandanten, Konten und Kirchen und darf überall planen.
  • Redakteur bearbeitet die ihm freigegebenen Mandanten.
  • Leser sieht die ihm freigegebenen Mandanten ausschließlich lesend. Wird ein Leser-Konto mit einer Person verknüpft, darf es deren Stammdaten, Präferenzen und Abwesenheiten selbst bearbeiten und den Plan nach dieser Person filtern; ohne Verknüpfung bleiben Teamdaten für Leser unsichtbar.

Planungsdaten (Kirchen, Personen, Vorlagen, Gottesdienste, Einteilungen, Abwesenheiten und Einstellungen) sind immer einem Mandanten zugeordnet. Administratoren sehen alle Mandanten; Redakteure und Leser nur die in memberships eingetragenen. Der aktive Mandant wird über die Seitenleiste gewechselt.

Bauen und testen

cd web

gofmt -l .
go vet ./...
go test ./...
go build ./...

# statisches Linux/arm64-Binary
./scripts/build-linux-arm64.sh
# → dist/lektorenplan-linux-arm64

Das Binary ist statisch gelinkt und benötigt auf dem Zielsystem weder libc noch eine SQLite-Installation.

Deployment (Linux/arm64)

Beispiel für eine Installation unter /opt/lektorenplan:

# Binary auf den Server kopieren
scp dist/lektorenplan-linux-arm64 server:/tmp/lektorenplan

ssh server
sudo useradd --system --home /opt/lektorenplan --shell /usr/sbin/nologin lektorenplan
sudo install -d -o lektorenplan -g lektorenplan /opt/lektorenplan /var/lib/lektorenplan
sudo install -m 0755 -o lektorenplan -g lektorenplan \
  /tmp/lektorenplan /opt/lektorenplan/lektorenplan

Dienst einrichten (Vorlage: scripts/lektorenplan.service):

sudo cp scripts/lektorenplan.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now lektorenplan

Empfohlen ist ein Reverse Proxy mit TLS (Caddy, nginx oder Traefik), der auf 127.0.0.1:8080 weiterleitet. Dabei LP_SECURE_COOKIES=true setzen. Der Server sollte nicht direkt öffentlich erreichbar sein.

Betrieb und Sicherheit

  • Backups: SQLite-Datei regelmäßig sichern, idealerweise mit sqlite3 /var/lib/lektorenplan/lektorenplan.db ".backup ..." oder im laufenden Betrieb über einen Dateisystem-Snapshot. WAL-Dateien (-wal, -shm) gehören zum konsistenten Stand.
  • Passwörter: bcrypt-Hashes, serverseitige Sitzungen, HttpOnly-Cookies, CSRF-Schutz auf allen schreibenden Formularen.
  • Erster Login: Jedes neu angelegte Konto muss beim ersten Anmelden ein eigenes Passwort setzen. Demo-Konten nach dem Test entfernen bzw. deaktivieren.
  • Updates: Neue Binärdatei austauschen und Dienst neu starten. Das Datenbankschema wird beim Start automatisch migriert.
  • Netzwerk: Der Prozess lauscht standardmäßig auf allen Interfaces. Für einen Proxy-Betrieb -addr 127.0.0.1:8080 verwenden.

Projektstruktur

web/
├── main.go                 Start, Flags, Bootstrap, täglicher Liturgie-Sync
├── domain/                 Modelle, Datumslogik, Planer, Statistik, Liturgie
├── liturgy/                Online-API, Offline-Snapshot, lokale Berechnung
├── store/                  SQLite-Schema, Mandanten, Konten, Planungsdaten
├── pdf/                    PDF-Renderer (A4 quer und A4 hoch)
├── web/                    HTTP-Server, Handler, Templates, CSS/JS
│   ├── templates/          serverseitige html/template-Seiten
│   └── static/             Stylesheet und progressive JavaScript-Helfer
└── scripts/                Build- und Deployment-Vorlagen

Liturgische Daten

Der liturgische Kalender stammt von www.eucharistiefeier.de. Für die Jahre 2025–2028 ist ein Offline-Snapshot eingebettet. Die Anwendung aktualisiert den aktuellen und den Folgejahrgang täglich im Hintergrund, sofern LP_SYNC_LITURGY nicht deaktiviert ist. Schlägt der Online-Abruf fehl, werden fehlende Tage lokal berechnet, damit Planung und PDF-Export weiterhin funktionieren.

Daten von www.eucharistiefeier.de – fair use, ausschließlich zur Anzeige. Die Daten bleiben Eigentum der Quelle.

Hinweis zur macOS-App

Die Webversion liegt vollständig unter web/ und verwendet ein eigenes Go-Modul. Die SwiftUI-App unter Sources/ wird dadurch nicht verändert. Beide Varianten können parallel gebaut und betrieben werden.