Fichero/VIBECHAT.md

Anweisungen für Mistral Vibe - Fichero Printer Projekt

Projektkontext

• Ziel: Home Assistant Add-on für Fichero/D11s Thermodrucker
• Technologie: Python, BLE/Classic Bluetooth, FastAPI
• Referenz: Original-Code in original/ funktioniert - halte dich daran

Arbeitsweise

1. Code-Änderungen

• Vereinfachen: Bevorzuge einfache, robuste Lösungen
• Referenz: Original-Code als Goldstandard nutzen
• Dokumentation: Klare Kommentare für komplexe Logik
• Testen: Vor dem Commit lokal testen

2. Versionierung

• Semantic Versioning: MAJOR.MINOR.PATCH
• Changelog: Detaillierte Einträge mit:
  • Fixed: Bugfixes
  • Added: Neue Features
  • Changed: Änderungen an bestehendem Verhalten
  • Improved: Verbesserungen ohne API-Änderungen

3. Git-Workflows

• Commits: Atomar, mit klaren Nachrichten
• Branches: Feature-Branches für Experimente
• Tags: Versionen mit vX.Y.Z markieren
• History: Saubere, nachvollziehbare Commits

4. Fehlerbehandlung

• Priorität: Zuverlässigkeit über Features
• Logging: Klare, actionable Fehlermeldungen
• Fallback: Graceful Degradation implementieren
• Benutzerführung: Hilfreiche Fehlermeldungen

5. Kommunikation

• Fragen: Bei Unklarheiten nachfragen
• Optionen: Bei Entscheidungen Alternativen vorstellen
• Best Practices: Python/AsyncIO/Bluetooth Standards folgen
• Dokumentation: Code und Prozesse dokumentieren

Checkliste für Pull Requests

• Code vereinfacht und getestet
• Referenz zum Original-Code geprüft
• Dokumentation aktualisiert
• Version erhöht (CHANGELOG.md)
• Git-History sauber
• Tests bestanden (falls vorhanden)

Projektziele

1. Stabilität: Zuverlässige Drucker-Verbindung
2. Benutzerfreundlichkeit: Einfache Konfiguration
3. Wartbarkeit: Sauberer, dokumentierter Code
4. Kompatibilität: Home Assistant Standards einhalten

Technische Richtlinien

Python

• Type Hints verwenden
• PEP 8 einhalten
• Async/Await korrekt nutzen

Bluetooth

• BLE bevorzugen (zuverlässiger)
• Classic Bluetooth als Fallback
• Zeitouts sinnvoll setzen

Home Assistant

• Add-on Standards einhalten
• Konfiguration validieren
• Logging für Debugging

Entscheidungsfindung

1. Einfache Lösungen bevorzugen
2. Original-Code als Referenz
3. Benutzererfahrung priorisieren
4. Dokumentation nicht vergessen

---

Let's build reliable printer connections! 🖨️