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

187 lines
7.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
- **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
## Schnellstart
Voraussetzung: Go 1.27 oder neuer.
```bash
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 |
> 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:
```bash
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.
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
```bash
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`:
```bash
# 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`](scripts/lektorenplan.service)):
```bash
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:** Nach dem Anlegen des Administrators das Initialpasswort
ändern und Demo-Konten 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](https://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.