feat: Major update - Battery Optimizer v3.4.0 with comprehensive fixes

## 🎯 Hauptänderungen

### Version 3.4.0 - SOC-Drift & Charging Capacity
- ✨ Sicherheitspuffer (20-50% konfigurierbar) für untertägige SOC-Schwankungen
- ✨ Monatliche automatische Batterie-Kalibrierung
- 🐛 SOC-Plausibilitäts-Check (filtert 65535% Spikes beim Modus-Wechsel)
- 🐛 Zeitabhängige API-Abfrage (vor/nach 14:00 Uhr)

### Neue Features
- 🔋 **Safety Buffer**: Kompensiert SOC-Drift und Eigenverbrauch
- 🔋 **Auto-Calibration**: Monatlicher Vollzyklus für SOC-Genauigkeit
- 🔋 **Spike Protection**: 4-fach Schutz gegen ungültige SOC-Werte
- 🔋 **Smart API**: Verhindert HTTP 500 Errors bei fehlenden Tomorrow-Preisen

### Dokumentation
- 📚 SOC_CALIBRATION_GUIDE.md - Umfassender Kalibrierungs-Guide
- 📚 FIX_CHARGING_CAPACITY.md - Sicherheitspuffer-Dokumentation
- 📚 FIX_SOC_SPIKE_PROBLEM.md - Spike-Protection-Lösung
- 📚 FIX_API_TIMING.md - Zeitabhängige API-Abfrage
- 📚 DIAGNOSE_LADE_PROBLEM.md - Debug-Guide

### Neue Dateien
- battery_calibration_automation.yaml - 4 Automations für Kalibrierung
- battery_calibration_input_helper.yaml - Input Helper Config
- battery_optimizer_input_helper_safety_buffer.yaml - Puffer Config
- debug_schedule.py - Umfassendes Debug-Script

### Scripts
- battery_charging_optimizer.py v3.4.0
- hastrom_flex_extended.py v1.1.0
- debug_schedule.py v1.0.0

### Fixes
- 🐛 SOC springt auf 65535% beim ESS-Modus-Wechsel → Debounce + Plausibilitäts-Check
- 🐛 API-HTTP-500 vor 14:00 → Zeitabhängige Abfrage
- 🐛 Batterie nicht bis 100% geladen → Sicherheitspuffer
- 🐛 SOC driftet ohne Vollzyklen → Automatische Kalibrierung

## 🚀 Installation

1. Input Helper erstellen (siehe battery_optimizer_input_helper_safety_buffer.yaml)
2. Automations installieren (siehe battery_calibration_automation.yaml)
3. Scripts aktualisieren (battery_charging_optimizer.py v3.4.0)
4. PyScript neu laden

## 📊 Verbesserungen

- Präzisere Ladeplanung durch Sicherheitspuffer
- Robustheit gegen SOC-Drift
- Keine API-Fehler mehr vor 14:00
- Hardware-Stopp bei 100% wird respektiert
- Bessere Batterie-Gesundheit durch regelmäßige Kalibrierung

🤖 Generated with Claude Code (claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

openems/legacy/v3/00_START_HIER.md

@@ -0,0 +1,199 @@
+# 🎯 Dashboard-Überarbeitung: Batterie-Optimierung
+
+## 📦 Was ist enthalten?
+
+Ich habe **3 komplett überarbeitete Dashboard-Varianten** für dein Batterie-Optimierungssystem erstellt:
+
+### ✨ Die Dashboards
+
+| Datei | Größe | Beste für | Spalten |
+|-------|-------|-----------|---------|
+| **battery_optimizer_dashboard.yaml** | 11 KB | Desktop, Details | 2-4 |
+| **battery_optimizer_dashboard_compact.yaml** | 8 KB | Tablet, Balance | 2-4 |
+| **battery_optimizer_dashboard_minimal.yaml** | 6 KB | Smartphone, Quick | 2-3 |
+
+### 📖 Die Dokumentation
+
+| Datei | Beschreibung |
+|-------|--------------|
+| **QUICKSTART.md** | ⚡ 3-Minuten Installation |
+| **README_Dashboard.md** | 📚 Vollständige Anleitung |
+| **DASHBOARD_COMPARISON.md** | 📊 Visueller Vergleich |
+
+---
+
+## 🚀 Los geht's!
+
+### Für Eilige (3 Minuten):
+👉 **Lies zuerst: `QUICKSTART.md`**
+
+### Für Detailverliebte (10 Minuten):
+👉 **Lies zuerst: `README_Dashboard.md`**
+
+### Für Unentschlossene (5 Minuten):
+👉 **Lies zuerst: `DASHBOARD_COMPARISON.md`**
+
+---
+
+## 🎨 Hauptunterschiede
+
+### Was ist neu gegenüber dem alten Dashboard?
+
+✅ **Maximal 4 Spalten** - keine unübersichtlichen 6+ Spalten mehr  
+✅ **Moderne Cards** - Bubble Cards & Stack-in-Card statt nur Entities  
+✅ **Power Flow Visualisierung** - Energie-Fluss auf einen Blick  
+✅ **Bessere Graphen** - Plotly statt einfachen History Graphs  
+✅ **Responsive Layout** - Passt sich an Desktop/Tablet/Smartphone an  
+✅ **Klare Struktur** - Logische Gruppierung nach Funktion  
+✅ **Weniger Scroll** - Kompaktere Darstellung wichtiger Infos  
+
+---
+
+## 💡 Meine Empfehlung für dich
+
+Basierend auf deinem Setup würde ich starten mit:
+
+**1. Wahl: KOMPAKT-Version** 
+- Beste Balance zwischen Detail und Übersicht
+- Nutzt deine installierten HACS Cards optimal
+- Funktioniert super auf Tablet UND Desktop
+- Nicht zu überladen, aber alle wichtigen Infos
+
+**Datei:** `battery_optimizer_dashboard_compact.yaml`
+
+---
+
+## 🔧 Verwendete Custom Cards
+
+Alle diese Cards hast du bereits via HACS installiert:
+
+- ✅ **Bubble Card** - Moderne Buttons & Toggles
+- ✅ **Plotly Graph Card** - Interaktive Graphen
+- ✅ **Power Flow Card Plus** - Energie-Visualisierung
+- ✅ **Stack-in-Card** - Kompaktes Layout
+
+➡️ **Keine zusätzlichen Installationen nötig!**
+
+---
+
+## 📱 Geräte-Empfehlungen
+
+| Dein Gerät | Dashboard-Version |
+|------------|-------------------|
+| 💻 Desktop (>1920px) | KOMPAKT oder STANDARD |
+| 💻 Laptop (1366-1920px) | KOMPAKT ⭐ |
+| 📱 Tablet (768-1366px) | KOMPAKT ⭐⭐⭐ |
+| 📱 Smartphone (<768px) | MINIMAL ⭐⭐⭐ |
+| 🖼️ Wall Panel (fest) | KOMPAKT oder MINIMAL |
+
+---
+
+## ⚠️ Wichtig vor der Installation
+
+### Entity-IDs prüfen!
+
+Die Dashboards verwenden diese Entities - **prüfe ob sie bei dir existieren:**
+
+```yaml
+# Hauptentities:
+sensor.openems_ess0_activepower          # Batterie-Leistung
+sensor.esssoc                            # Batterie SOC
+sensor.openems_grid_activepower          # Netz
+sensor.openems_production_activepower    # PV
+sensor.hastrom_flex_extended_current_price # Preis
+
+# Plan-Entities:
+pyscript.battery_charging_plan           # Ladeplan
+sensor.battery_charging_plan_status      # Status
+sensor.battery_next_charge_time          # Nächste Ladung
+
+# Steuerung:
+input_boolean.battery_optimizer_enabled
+input_boolean.goodwe_manual_control
+```
+
+**So prüfst du:**
+1. Home Assistant → **Entwicklerwerkzeuge** → **Zustände**
+2. Suche nach den Entity-IDs
+3. Falls anders: Im Dashboard anpassen (Suchen & Ersetzen)
+
+---
+
+## 🎯 Nächste Schritte
+
+Nach erfolgreicher Dashboard-Installation:
+
+1. ✅ **Plan-Historie implementieren** (aus vorigem Chat)
+2. ✅ **InfluxDB-Integration** für Langzeitdaten
+3. ✅ **Notifications** bei Ladestart/-ende
+4. ✅ **Grafana-Dashboard** als Alternative
+
+Willst du mit einem dieser Punkte weitermachen?
+
+---
+
+## 📊 Visualisierung
+
+### Was zeigen die Dashboards?
+
+**Alle Versionen zeigen:**
+- 🔋 Energie-Fluss (Power Flow Card)
+- 📅 Geplante Ladestunden
+- 💶 Strompreis-Verlauf
+- 📈 Batterie SOC-Trend
+- 🎛️ Steuerung (Auto/Manuell)
+
+**Zusätzlich in Standard/Kompakt:**
+- ⚡ Energie-Flüsse (PV/Netz/Batterie)
+- 📊 Detaillierte Plan-Statistiken
+- 🗂️ Vollständige Plan-Tabelle
+
+**Nur in Standard:**
+- ℹ️ Erweiterte System-Infos
+- 🔍 Noch mehr Details
+
+---
+
+## ✅ Installation Checklist
+
+- [ ] Dashboard-Variante gewählt
+- [ ] `QUICKSTART.md` gelesen
+- [ ] Entity-IDs geprüft
+- [ ] YAML-Datei in HA eingefügt
+- [ ] Browser-Cache geleert
+- [ ] Dashboard getestet
+- [ ] Auf verschiedenen Geräten geprüft
+
+---
+
+## 🆘 Bei Problemen
+
+**Erste Hilfe:**
+1. Browser-Cache leeren (Strg+Shift+R)
+2. Entity-IDs in Developer Tools prüfen
+3. Home Assistant Logs checken
+4. Browser-Konsole checken (F12)
+
+**Dokumentation:**
+- `QUICKSTART.md` → Häufige Anpassungen
+- `README_Dashboard.md` → Fehlerbehebung
+
+---
+
+## 🎉 Los geht's!
+
+**Starte jetzt mit:**
+```
+1. Öffne: QUICKSTART.md
+2. Wähle: battery_optimizer_dashboard_compact.yaml
+3. Folge: 3-Minuten-Setup
+4. Fertig! 🚀
+```
+
+Viel Erfolg mit deinem neuen Dashboard!
+
+---
+
+**Erstellt:** 16. November 2025  
+**Für:** Felix's Batterie-Optimierungssystem  
+**Version:** 1.0