This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# CLAUDE.md – Mawari
Du arbeitest an **Mawari**, einer kleinen nativen macOS-App von Zielke Studio. Sie zeigt für die Leben-und-Dienst-Zusammenkunft, wer wann zuletzt welche Aufgabe hatte. Die offizielle Einteilung bleibt in NW Scheduler; Mawari ist nur das Nachschlagewerk daneben. Nutzer ist eine einzelne Person ohne Technikinteresse – alles muss ohne Erklärung funktionieren.
## Technische Leitplanken
- **Plattform:** macOS 14+, Universal Build (arm64 + x86_64), Swift 6, SwiftUI (AppKit nur für Panels und Alerts).
- **Projekt:** `Mawari.xcodeproj` wird aus `project.yml` erzeugt (`xcodegen`) und ist nicht im Repo. `App/Info.plist` ebenso.
- **Abhängigkeiten:** nur Sparkle 2.10.0 (gleiche Fassung wie drop.look/drop.two). Keine weiteren Pakete ohne Rückfrage.
- **Datenformat:** muss kompatibel zum früheren HTML-Tool bleiben (`docs/datenformat.md`). Neue Felder nur optional und mit Standardwert dekodieren.
- **Echte Daten nie anfassen:** Zum Testen `MAWARI_DATA_DIR=/tmp/irgendwas` setzen.
- **Bewusst nicht im Umfang:** Vorschläge, wer als Nächstes dran ist; Abwesenheiten; Live-Verknüpfung mit NW Scheduler.
## Design
Farben in `App/Sources/Theme.swift`, Begründung in `design/README.md`. Hell ist Standard, dunkel wird unterstützt. Texte auf Deutsch, kurz, in Du-Form.
## Arbeitsweise
1. Vor Code: kurzer Plan in wenigen Punkten.
2. Nach jedem lauffähigen Stand committen (Conventional Commits auf Englisch).
3. Kommentare im Code auf Deutsch (wie bisher), UI-Texte auf Deutsch.
4. Neue Version: Ablauf in `README.md` → „Neue Version veröffentlichen“, Eintrag in `CHANGELOG.md`.
