App Icon jetzt mit dabei

This commit is contained in:
concierge committed 2026-11-07 13:31:30 +01:00
1 parent c24bc91768
commit 87ec0ab97c
6 files changed
+619 -1

No files matched your search

+112
View File
@@ -1,2 +1,114 @@
# 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](CONCEPT.md).
## Voraussetzungen
- macOS 14 oder neuer
- Xcode 15 oder neuer bzw. Swift 5.9+
- Keine externen Abhängigkeiten
## Bauen und starten
```bash
# 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](https://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:
```bash
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:
```bash
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](CONCEPT.md).