Mawari/CLAUDE.md

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.