melo-app/.hermes.md

Melo App — Entwickler-Regeln (Ponytail-Prinzip)

Dieses Projekt wird nach dem Ponytail-Prinzip entwickelt: minimaler Code, maximale Wirkung, keine überflüssigen Abstraktionen.

📐 Kernregeln für die Entwicklung

1. Minimalismus & Struktur

• Kein Overengineering: Keine komplexen Repository-Muster oder unnötige Service-Klassen. Direkte, einfache Lösungen (wie Singleton-Datenbank-Helfer direkt in ViewModels/Widgets) sind bevorzugt.
• Dateigröße: Versuche, Dateien unter 500 Zeilen zu halten. Größere UI-Teile oder Widgets in separate Widget-Dateien auslagern.
• Maximal 100 Zeilen pro Task: Halte die Änderungen pro Commit kompakt und zielgerichtet (max. ~100 Zeilen neuer Code).

2. Sprachregeln (Deutsch)

• Variablen & Methoden: Alle Bezeichner für Variablen, Methoden, Funktionen und Widgets werden strikt auf Deutsch benannt (z. B. _ladeSongs(), _aktiverTab, letzteSongs).
• Kommentare: Dokumentation und Code-Kommentare werden ausschließlich auf Deutsch verfasst und erklären das Warum, nicht das Was.

3. Qualitäts-Sicherung & Tests

• Ressourcen freigeben: Stelle sicher, dass jede StreamSubscription und jeder AudioPlayer in dispose() der Widgets oder Services ordnungsgemäß gecancelled/geschlossen wird, um Speicherlecks zu verhindern.
• Fehlerbehandlung: Jeder Dateizugriff, Web-Download oder Datenbank-Vorgang wird mit einem sicheren try-catch-Block abgesichert.
• Sicherer Build: Vor jedem Commit muss die App fehlerfrei bauen. Führe im Zweifel einen schnellen Test-Build durch: flutter build apk --release --split-per-abi