HydrationFreeze2.0

Changelog

Alle nennenswerten Änderungen an diesem Projekt werden in dieser Datei dokumentiert.

Das Format basiert auf Keep a Changelog, und dieses Projekt folgt der Semantic Versioning.

Präzisions-Monitoring (TC-14): Validierung der Volumenanzeige für krumme Werte. Die App unterstützt nun eine exakte Darstellung von zwei Nachkommastellen, was besonders bei 250ml-Intervallen (0.25L, 0.50L, 0.75L) für mathematische Korrektheit sorgt.
V-Modell Integration: Aufnahme des grafischen V-Modells in die Testdokumentation zur Visualisierung der Qualitätssicherungsschritte.
ISTQB-Konforme Testdokumentation: Komplette Überarbeitung des Testprotokolls und Fehlerberichts nach Industriestandard (IEEE 829).

Robuste Reset-Logik: Erweiterung des AppDelegate um den .NSCalendarDayChanged Observer. Die App erkennt den Tageswechsel nun auch dann sofort, wenn sie über Mitternacht aktiv durchläuft, ohne dass ein System-Sleep erforderlich ist.
Memory-Management: Optimierung der Timer-Closures durch [weak self] Referenzen zur Vermeidung potenzieller Memory Leaks bei Langzeitbetrieb.

Interaktions-Bug (DEF-06): Fix eines Fehlers, bei dem das Overlay nach dem Loggen eines Glases im Vordergrund verblieb. Die OverlayView sendet nun ein korrektes onFinished() Signal an den Manager.
Rundungsfehler (DEF-08): Korrektur der String-Formatierung von %.1f auf %.2f, um falsche Anzeigen (wie 0.2L statt 0.25L) bei spezifischen Glasgrößen zu verhindern.
Automatischer Reset (DEF-07): Behebung einer Instabilität, bei der der Zähler nach dem Aufwachen des Macs gelegentlich nicht auf 0 zurücksprang.

Adaptive UI-Skalierung: Einführung einer dynamischen Icon-Berechnung (dynamicIconSize). Die Wassertropfen im Overlay passen ihre Größe nun automatisch an das Verhältnis von Tagesziel und Glasgröße an, um eine perfekte Darstellung ohne Scrollen zu gewährleisten.
Intelligentes Grid-Layout: Das Overlay-System berechnet nun die exakte Anzahl der benötigten Symbole basierend auf dem Quotienten aus Zielvolumen und Glasvolumen.
Dynamisches Live-Rendering für UML-Diagramme in der Online-Dokumentation (Mermaid.js Integration).
Neues Sequenzdiagramm für den Overlay-Manager (/PF10/).
Zustandsdiagramm für die App-Logik (/PF20/).

macOS Design-Refinement: Komplette Überarbeitung der SettingsView unter Verwendung von LabeledContent. Dies sorgt für ein exaktes Alignment der Labels und Steuerelemente gemäß den Apple Human Interface Guidelines.
Erweiterte Symbolik: Dynamischer Wechsel des Header-Icons auf einen Erfolgs-Status (checkmark.circle.fill), sobald das Tagesziel erreicht wurde.
Optimierte Button-Interaktion: Buttons in den Einstellungen nutzen nun .buttonStyle(.borderless) für ein dezenteres, systemkonformes Erscheinungsbild.

Layout-Clutter: Fix eines Fehlers, bei dem die UI-Elemente im Overlay bei hohen Tageszielen oder sehr kleinen Glasgrößen über den Bildschirmrand hinausragten.
Fehlerhafte Darstellung der Architektur-Grafiken auf GitHub Pages.
Reduzierung von Repository-Müll durch optimierte .gitignore.

Individuelle Glasgrößen: Einstellbare Glasgröße (100ml - 1000ml).
Dynamische Zielsetzung: Individuelles Tagesziel-Limit (dynamische RuleMark im Chart).
Intelligente Berechnung: Automatische Berechnung der benötigten Glasanzahl in den Einstellungen.

Overlay-Logik von statischen 200ml auf dynamische @AppStorage-Werte umgestellt.
CSV-Export nutzt nun die konfigurierten Volumen-Werte.
Refactoring der SettingsView für bessere Übersicht.

Unbegrenztes Tracking (Bonus-Gläser): Einführung eines permanent sichtbaren, grünen Plus-Buttons (plus.circle.fill), um Wasser über das ursprüngliche Tagesziel hinaus zu loggen.
Echtzeit-Statistiken: Die Chart-Ansicht und der CSV-Export berechnen nun zur Laufzeit den heutigen Live-Wert in Kombination mit der Historie.
Statischer QR-Code: Die rechenintensive, dynamische QR-Code-Generierung wurde durch ein performantes, statisches Bild-Asset ersetzt.
Wake-from-Sleep Erkennung: Der AppDelegate nutzt nun NSWorkspace.didWakeNotification für einen zuverlässigen Tages-Reset nach dem Ruhezustand.

Kritischer Datums-Bug (Reset-Logik): Der Tagesvergleich nutzt nun ein festes ISO-8601 Format, was Fehler bei unterschiedlichen Systemsprachen behebt.
CSV-Formatierung: Liter-Werte im CSV-Export verwenden jetzt das Komma , für bessere Kompatibilität mit Excel/Numbers im europäischen Raum.

Vollständiger Dokumentations-Abgleich: Pflichtenheft exakt an Lastenheft angepasst.
Traceability Matrix: Test-Szenarien und Abnahmekriterien im Pflichtenheft integriert.
Erweiterter CSV-Export: Integration des NSSavePanel für einen nutzerfreundlichen Speicher-Dialog.

Datenhygiene: Automatische Löschung von Historien-Einträgen, die älter als 14 Tage sind.

Zentralisierung der Logik: Auslagerung der Fenster-Steuerung in den OverlayManager.
Multi-Monitor-Support: Optimierung der Bildschirmschleife für lückenlose Abdeckung aller aktiven Displays.
Haptisches Feedback: Integration des NSHapticFeedbackManager bei Interaktion mit Wassertropfen.

Wartungskonzept: Dokumentation zur Fehlerprotokollierung und zum Monitor-Management.
Projekt-Roadmap: Planung für Apple Watch Integration und iCloud Sync.

Basis-Funktionalität: Menüleisten-App zur Erinnerung an die Wasseraufnahme.
Overlay-Sperre: Zeitgesteuerte Vollbild-Verdunkelung (5-120 Min. Intervall).
Interaktiver Tracker: Visuelle Erfassung via Wassertropfen-Icons.
Basis-Statistik: Balkendiagramm via Swift Charts.