Changelog

Versionshistorie und Änderungsprotokoll von CharGraph - alle Verbesserungen und Neue Features.

Versionshistorie

Alle wichtigen Änderungen am CharGraph Projekt.

[0.4.0] - Aktuell (Januar 2026)

API-Basierte Architektur & Backend-Migration

Neue Features

REST-API Endpoints für Zeit-Logik (NEW)

  • POST /api/time-words - Konvertiert Zeit zu deutschen Wörtern
  • POST /api/validate - Validiert 110-Zeichen-Muster
  • Backend-Implementierung in C++ (WordMatcher, MinuteRules, LEDCalculator)
  • Zentrale Geschäftslogik auf Server, nicht im Browser

Frontend V0.4 (API-basiert)

  • Async/Await Pattern für alle API-Calls
  • Automatisches Fallback bei API-Ausfällen
  • Kleinere HTML-Datei (312 Zeilen weniger)
  • Entfernte lokale MINUTE_RULES (jetzt im Backend)

Synchronisierte Implementierungen

  • Python API (main.py) mit korrektem Hour-Indexing
  • C++ Bibliothek (CharGraphTimeLogic) mit gleicher Logik
  • JavaScript Frontend nutzt API statt lokaler Berechnung

Blacklist & Sicherheit

  • Content-Moderation mit Blacklist-Wörtern
  • HTTP 422 bei blockierten Inhalten
  • Schutz vor unanständigen/rassistischen Inhalten

Dokumentation

  • Aktualisierte CLAUDE.md mit V0.4 Architektur
  • API-Dokumentation mit time-words und validate Endpoints
  • Lernkonzept-Dateien dokumentieren Backend-Logik
  • Beispiel-Code für JavaScript, Python, cURL

Bugfixes (von V0.3)

  • Hour-Indexing korrigiert: HOURS[h12 - 1] statt HOURS[h12]
  • Missing has_nacht Variable in LED-Berechnung
  • Traefik Routing für /api vs /api-playground behoben
  • FastAPI Swagger UI konfiguriert auf /api/docs

Performance

  • 24-Stunden-Validierung: 1 API-Call statt 1440 lokale Berechnungen
  • Verkleinerte Frontend-Datei durch Entfernen lokaler Logik
  • Zentralisierte Geschäftslogik im Backend

[0.3.0] - Januar 2026

Regelbasierte Architektur & Next.js Migration

Neue Features

Regelbasierte Minutenlogik (V0.3 - Lokal)

  • 60 deklarative Regel-Objekte statt imperativ
  • 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)
  • Kontextabhängige Remainder-Berechnungen

Next.js Web-Framework

  • Modern React-basierte UI
  • Responsive Design
  • Dark Mode Support
  • API Integration

Dokumentation

  • Umfassende charMatrixV03.md Dokumentation
  • Detaillierte LED-Logik-Erklärung
  • Modifikator-System dokumentiert
  • Pädagogische Lernmodule (18 Kapitel)

[0.2.0]

Regelbasierte Architektur & Next.js Migration

Neue Features

Regelbasierte Minutenlogik

  • 60 deklarative Regel-Objekte statt imperativ
  • 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)
  • Kontextabhängige Remainder-Berechnungen

Next.js Web-Framework

  • Modern React-basierte UI
  • Responsive Design
  • Dark Mode Support
  • API Integration

URL-Parameter Support

  • ?pattern=... - Lädt Pattern direkt
  • ?time=HH:MM - Setzt Simulation auf Zeit
  • ?theme=light/dark - Theme-Steuerung
  • ?rotY=180 - 3D-Modell-Rotation

Neue Seiten & Features

  • Editor-Integration: Vollständig in die Webseite integriert
  • 3D-Viewer: Interaktiver STL-Viewer mit Rotation
  • Download-Hub: Kategorisierte Hardware & Software-Downloads
  • Pädagogische Module: 18 umfassende Lernkapitel
  • Montage & Inbetriebnahme: Schritt-für-Schritt Anleitung

Dokumentation

  • Umfassende charMatrixV02.md Dokumentation
  • Detaillierte LED-Logik-Erklärung
  • Modifikator-System dokumentiert
  • Pädagogische Lernmodule (18 Kapitel)
  • Montage und Inbetriebnahme Guide

Bugfixes

  • LED-Richtung bei VOR-Zeiten korrigiert
  • KURZ VOR HALB verwendet korrekte Remainder-Berechnung
  • Fallback-Logik bei fehlgeschlagener Validierung
  • Dark Mode Text-Farben optimiert
  • Theme-Umschaltung live im Editor

UI/UX Verbesserungen

  • Dark Mode Integration
  • Live Theme-Umschaltung
  • STL-Viewer Modal im Editor
  • 3D-Modell Rotationsparameter
  • Responsive Download-Seite

Geplante Features (Version 0.3)

Editor Erweit:

  • Benutzerdefinierte Vorlagen speichern
  • Pattern-Import/Export (JSON)
  • Kollaborative Bearbeitung

Sprachen & Lokalisierung:

  • Englische Zeitangaben
  • Französische Varianten
  • Weitere Sprachen

Hardware-Integration:

  • WebSocket Live-Verbindung zum Gerät
  • OTA-Updates über Web-Interface
  • MQTT Integration für Smart Home

Performance:

  • WebAssembly für Validierung
  • Service Worker für Offline-Nutzung
  • Progressive Web App (PWA)

Versionsschema

Wir verwenden Semantic Versioning:

MAJOR.MINOR.PATCH

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

Danksagungen

  • Rainer Wieland - Entwicklung & Konzept
  • Wieland.org - Hosting & Infrastruktur
  • FACW e.V. - Beta Testing & Feedback
  • Community - Feedback & Testing

Links

Letzte Aktualisierung: Januar 2026