Files
LektorenPlan/README.md
T
2026-11-07 13:31:30 +01:00

4.0 KiB
Raw Blame History

LektorenPlan

macOS-SwiftUI-Prototyp für die Planung von Lektorinnen, Lektoren und Kommunionhelferinnen/-helfern in der Pfarreiengemeinschaft Bad Godesberg (St. Andreas, St. Evergislus, Herz Jesu, St. Hildegard).

Das ausführliche Grobkonzept liegt in CONCEPT.md.

Voraussetzungen

  • macOS 14 oder neuer
  • Xcode 15 oder neuer bzw. Swift 5.9+
  • Keine externen Abhängigkeiten

Bauen und starten

# Debug-Build und Tests
swift build
swift test

# App-Bundle erzeugen und öffnen
./Scripts/build-app.sh debug
open build/LektorenPlan.app

Alternativ Package.swift in Xcode öffnen und das Schema LektorenPlan starten.

Die App legt ihre Datenbank unter ~/Library/Application Support/LektorenPlan/lektorenplan.sqlite an und befüllt sie beim ersten Start mit Demo-Daten. Über Einstellungen → Demo-Daten zurücksetzen lässt sich der Ausgangszustand wiederherstellen.

Funktionsüberblick

  • Kalender & Planung: Tageszeilen mit Liturgie, Lesungen und Gottesdiensten der vier Kirchen; Sonntage, Hochfeste und gebotene Feiertage hervorgehoben.
  • Zeitstrahl: frei wählbarer Zeitraum mit Griffen und Marken für Quartale, Osterzeit, Weihnachtszeit und Kirchenjahr.
  • Automatische Planung: harte Ausschlüsse (Rolle, Abwesenheit, Monatslimit, Doppelbelegung, Einsatztag) und weiche Präferenzen (Kirche, Gottesdienst, Wochentag, Fairness).
  • Manuelle Nachsteuerung: Kandidatenvorschläge mit Warnhinweisen, Einsätze sperren oder entfernen.
  • Gottesdienstordnung: wiederkehrende Vorlagen, Ausnahmen und Sondergottesdienste.
  • Team: Personen, Rollen, Präferenzen, Abwesenheiten, Monatslimits.
  • Statistik: Besetzungsquote, Fairness, Monatsverlauf, Kirchenverteilung, Präferenztreffer, Einsatzübersicht (Swift Charts).
  • Austausch: JSON-Export und -Import für Planungsabschnitte oder Ressourcen mit Vorschau vor dem Zusammenführen.
  • PDF & Druck: A4 quer mit automatischer Pagination, PDFKit-Vorschau, Sichern und direkter Druck.

Liturgische Daten

Die App nutzt den liturgischen Kalender für das Erzbistum Köln über www.eucharistiefeier.de. Für 2025–2028 ist ein Offline-Snapshot enthalten; der aktuelle Jahrgang kann in den Einstellungen oder über die Kalender-Schaltfläche online aktualisiert werden.

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

Projektstruktur

Sources/
├── LektorenPlanCore/      Modelle, SQLite, Liturgie, Planer, Statistik
├── LektorenPlan/          SwiftUI-App, Views, Sheets, PDF-Renderer
Tests/LektorenPlanCoreTests/
Resources/AppIcon.icns     App-Icon
Scripts/build-app.sh       erzeugt build/LektorenPlan.app
Scripts/make-icon.swift    erzeugt Resources/AppIcon.icns
CONCEPT.md                 Grobkonzept

App-Icon

Das Icon zeigt eine Kirche als Linienzeichnung im Hintergrund und eine stilisierte Kalenderkarte im Vordergrund. Es wird per Skript als ICNS-Datei erzeugt und beim Bauen ins App-Bundle kopiert:

swift Scripts/make-icon.swift
./Scripts/build-app.sh debug

Die Vorschau in voller Auflösung landet unter build/AppIcon-1024.png.

Entwicklungshelfer

Für visuelle Prüfungen ohne Bildschirmaufnahme-Berechtigung kann die App eine Ansicht als PNG rendern und/oder den Plan als PDF schreiben:

BIN=$(swift build --show-bin-path)
LP_SNAPSHOT=/tmp/plan.png "$BIN/LektorenPlan"
LP_SNAPSHOT=/tmp/statistik.png LP_SNAPSHOT_VIEW=statistics \
  LP_SNAPSHOT_HEIGHT=2000 "$BIN/LektorenPlan"
LP_PDF=/tmp/plan.pdf "$BIN/LektorenPlan"

LP_SNAPSHOT_VIEW akzeptiert planning, root, team, order, statistics, exchange und settings. Der Auto-Sync ist bei Snapshot-Läufen deaktiviert.

Status

Prototyp 0.1. Die Demo-Personen und Kontaktdaten sind fiktiv. Produktive Aspekte wie Benutzerkonten, Benachrichtigungen, Signierung und ein Mehrbenutzerbetrieb sind noch nicht umgesetzt; siehe Abschnitt „Grenzen“ in CONCEPT.md.