diff --git a/VIBECHAT.md b/VIBECHAT.md index 80d5deb..ce64911 100644 --- a/VIBECHAT.md +++ b/VIBECHAT.md @@ -61,16 +61,33 @@ - Type Hints verwenden - PEP 8 einhalten - Async/Await korrekt nutzen +- **Circular Imports vermeiden**: Konstanten in das Modul verschieben, das sie primär nutzt ### Bluetooth - BLE bevorzugen (zuverlässiger) - Classic Bluetooth als Fallback -- Zeitouts sinnvoll setzen +- Zeitouts sinnvoll setzen (5-10 Sekunden) +- **Fehlerbehandlung**: Klare Meldungen ohne komplexe Wiederherstellung ### Home Assistant - Add-on Standards einhalten - Konfiguration validieren - Logging für Debugging +- **Versionierung**: Immer Version erhöhen, damit Änderungen erkannt werden + +### Wichtige Lektionen + +1. **Circular Imports**: Verursachen `ImportError` und verhindern den Start + - Lösung: Konstanten in das nutzende Modul verschieben + - Beispiel: `PRINTHEAD_PX` → `imaging.py` + +2. **Versionierung**: Jede Änderung needs neue Version (0.1.42, etc.) + - Home Assistant erkennt nur Änderungen mit neuer Version + - Immer config.yaml + api.py + CHANGELOG.md aktualisieren + +3. **Einfachheit**: Komplexe Logik oft Quelle von Problemen + - Bevorzuge direkte Verbindungen über Wiederherstellungsversuche + - Klare Fehler > komplexe Recovery ## Entscheidungsfindung