# 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`.