diff --git a/VIBECHAT.md b/VIBECHAT.md new file mode 100644 index 0000000..80d5deb --- /dev/null +++ b/VIBECHAT.md @@ -0,0 +1,83 @@ +# 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!* 🖨️ \ No newline at end of file