Changelog

Alle wichtigen Änderungen am CharGraph Projekt.

[0.2.0] - 2026-01-02

Großes Update: Regelbasierte Architektur

Neue Features

Regelbasierte Minutenlogik

60 deklarative Regel-Objekte statt 285 Zeilen if-else
Handler-Funktionen für jede Minute
Kontext-Objekt für alle Parameter
Bessere Wartbarkeit und Erweiterbarkeit

Positionsbasierte Validierung

Prüft, ob Modifikatoren (FAST, BALD, KURZ) an richtiger Stelle stehen
FAST muss VOR HALB stehen
Stundenwörter müssen NACH HALB stehen
Intelligente Fallback-Strategie bei ungültigen Positionen

Korrekte LED-Logik

LEDs von LINKS bei NACH-Zeiten (addieren)
LEDs von RECHTS bei VOR/FAST/BALD-Zeiten (subtrahieren)
Zwei verschiedene Remainder-Berechnungen:
- FAST/BALD/KURZ VOR: Fehlende Minuten (5 - mm%5)
- VOR/NACH: Vergangene Minuten (mm%5)

URL-Parameter Support

?pattern=... - Lädt Pattern direkt
?time=HH:MM - Setzt Simulation auf Zeit
Unterstützt beide Formate: 6:28 und 06:28

Verbesserungen

Intelligente Modifikator-Auswahl

Vorher: Modifikator vorhanden → wird verwendet
Nachher: Modifikator vorhanden + Position korrekt → wird verwendet
Progressive Fallback-Kette: FAST (validiert) → BALD → Basis

Menschlich-logische Zeitangaben

Vorher: 01:04 → "ES IST NACH EINS (+4)"
Nachher: 01:04 → "ES IST BALD FÜNF NACH EINS (+1)"

10 Handler mit Position-Validierung

:04, :09, :14, :19 (NACH-Zeiten)
:29 (HALB)
:34, :39 (NACH HALB-Zeiten)
:49, :54, :59 (VOR-Zeiten)

Dokumentation

Umfassende charMatrixV02.md (800+ Zeilen)
Detaillierte LED-Logik-Erklärung
Modifikator-System dokumentiert
Praxisbeispiele für alle Szenarien
Migration-Guide von V0.1

Bugfixes

LED-Richtung bei VOR-Zeiten korrigiert
KURZ VOR HALB verwendet jetzt korrekte Remainder-Berechnung
Fallback-Logik bei fehlgeschlagener Validierung

Technische Änderungen

Neue Funktion: selectModifier()
Erweiterte validateWordSequence() Funktion
Kontext-Objekt für Handler-Funktionen
MINUTE_RULES Array-Struktur

[0.1.0] - 2025-12-XX

Initial Release

Features

CharGraph Editor V0.1

Interaktives Grid-System (10×11)
Drag & Drop für Wörter
Echtzeit-Simulation
STL-Export für 3D-Druck
Undo/Redo Funktionalität
Duplikat-Erkennung
Verwendete Wörter Highlighting

Minutenlogik

285 Zeilen if-else für alle 60 Minuten
Unterstützung für FAST, BALD, KURZ
Unterstützung für ZWANZIG, DREIVIERTEL
LED-Anzeige für Minuten zwischen 5-Min-Marken

Vorlagen

16 vordefinierte Pattern-Vorlagen
"Vorschlag"-Button für schnellen Wechsel

Validierung

Automatische Duplikat-Prüfung
Pattern-String Generierung
Wort-Sequenz Validierung

Export

STL-Generierung via API
Fortschritts-Animation
Download-Handling

[Geplant]

Version 0.3.0

Features in Planung:

Benutzerdefinierte Vorlagen speichern
Mehr Sprachen (Englisch, Französisch)
Dark Mode Toggle
Pattern-Import/Export (JSON)
Kollaborative Bearbeitung
Versionshistorie

Performance-Optimierungen:

Lazy Loading für große Vorlagen
Service Worker für Offline-Nutzung
WebAssembly für schnellere Validierung

UI/UX Verbesserungen:

Responsive Design Optimierungen
Tastatur-Shortcuts Übersicht
Tutorial-Modus für neue Nutzer

Versionsschema

Wir verwenden Semantic Versioning:

MAJOR.MINOR.PATCH

MAJOR: Breaking Changes
MINOR: Neue Features (rückwärtskompatibel)
PATCH: Bugfixes

Upgrade-Guide

Von 0.1 zu 0.2

Keine Breaking Changes! V0.2 ist vollständig rückwärtskompatibel.

Empfohlene Schritte:

Pattern testen: Öffne dein Pattern in V0.2
Kritische Zeiten prüfen: Teste :04, :09, :14, :19, :29, :34, :39, :49, :54, :59
LED-Richtung beachten: Bei VOR-Zeiten sollten LEDs von rechts sein

Falls FAST an falscher Position:

Vorher: ES_IST_...HALB_FAST...
Nachher: ES_IST_...FAST...HALB...

Oder: Entferne FAST → V0.2 nutzt BALD als Fallback

Danksagungen

Rainer Wieland - Entwicklung V0.2
Wieland.org - Hosting & Infrastruktur
Mitglieder des FACW e.V. - Beta Testing und Feedback
Community - Feedback und Testing