v1.0.0

fpp-web-control — Major Release v2.0.0

Datum: 2025-12-08

Dieses Major-Release bringt mehrere neue Kernfunktionen, größere UI-Verbesserungen, zuverlässigere Benachrichtigungen und native Docker-Unterstützung. Es handelt sich um ein bedeutendes Update, das bestehende Deployments betrifft — bitte die Upgrade-Hinweise beachten.

Highlights

• Neue Statistik-Seite

  • Vollständige Erfassung von Nutzerinteraktionen (Wünsche, Button-Aktionen).
  • Interaktive Charts und Exportoptionen über statistics.html.
  • Sicherere, atomare Schreibvorgänge für Statistikdaten (vermeidet Dateikorruption).

• Benachrichtigungssystem (Notifications)

  • Integrierte Notification-Engine für Nutzeraktionen (z. B. Show-Start, neue Wunsch-Einreichungen).
  • Unterstützung für ntfy.sh mit angepasster / robusteren Implementierung (Headers, Encoding-Fixes, Preview-Modus-Skip).
  • Detaillierte Dokumentation zu Notification-Konfigurationen in NOTIFICATIONS.md.

• Geplante-Show-Banner

  • Prominente Anzeige „Geplante Show gestartet – Wünsche pausiert.“ oberhalb der Buttons, wenn ein geplanter Show-Zeitraum aktiv ist.
  • Verbesserte Banner/Hint-Logik (Hinweise wurden in Banner verlagert für bessere Sichtbarkeit).

• Docker & Deployment

  • Docker-Image und docker-compose Unterstützung verbessert.
  • Docker Volume-Unterstützung für persistente Statistikdaten.
  • docker-entrypoint.sh und Dockerfile wurden angepasst, statistics.html ist im Image enthalten.
  • .env.example und config.template.js aktualisiert — bitte eigene Konfiguration prüfen.

Weitere Verbesserungen und Fixes

• Diverse ntfy.sh-Fixes: UTF-8 Encoding, Endpoint/URL-Korrekturen, korrekte Header-Nutzung und stabilere POST-Aufrufe.
• Hinweise und diagnostische Texte überarbeitet bzw. aufgeräumt (redundante Warnungen entfernt).
• Footer-Link zur Statistikseite hinzugefügt.
• statistics.json wird nun in .gitignore gehalten (lokale Daten nicht tracken).

Breaking changes / Wichtige Upgrade-Schritte

• Statistik-Persistenz:

  • Falls du das Projekt per Docker betreibst: lege ein Volume für die Statistikdatei an, damit Daten nach Updates erhalten bleiben.
  • Prüfe, ob vorhandene statistics.json-Dateien migriert/backupped sind, bevor du das neue System in Produktion nimmst.

• Notifications (ntfy.sh):

  • Konfiguration prüfen: Änderungen an der ntfy-API-Verwendung (Headers vs. JSON) können bestehende Setups beeinflussen. Siehe NOTIFICATIONS.md für Beispiele und neue empfohlenen Einstellungen.
  • Preview-Modus überspringt jetzt Benachrichtigungen — bei Tests ggf. Preview deaktivieren.

• Konfigurationsdateien:

  • Übernehme Anpassungen aus config.template.js und .env.example. Namen/Keys von Notification-Parametern oder Pfaden können sich geändert haben.

Empfohlene Tests vor Produktion

• Lokale Docker-Instanz starten und prüfen:
  • UI: Index-, Requests- und Statistics-Seite laden.
  • Benachrichtigungen: Show-Start und Wunsch-Senden testen (ntfy-Konfig aktiv/inaktiv).
  • Show-Plan (scheduled show) simulieren: Banner erscheint, Wünsche sind pausiert.
  • Statistik: Aktionen ausführen und prüfen, ob die Statistikdatei korrekt und atomar geschrieben wird.

Sicherheit & Stabilität

• Atomic writes verhindern Korruption bei gleichzeitigen Schreibzugriffen.
• Debug/Hinweistexte reduziert, damit UI klarer bleibt.
• Tests und Korrekturen am Benachrichtigungscode verbessern Zuverlässigkeit und Encoding-Handling.

Migrations- / Rollback-Tipp

• Vor dem Upgrade Backup folgender Dateien:
  • statistics.json (falls vorhanden)
  • deine config.js / .env Konfigurationen
• Rollback: alte Version wiederherstellen und ggf. das Backup der Statistikdaten zurückkopieren.