21 lines
1.6 KiB
Markdown
21 lines
1.6 KiB
Markdown
# 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`
|