# CLAUDE.md — Melo Projekt (Server-Klon)

## 🎯 Projekt
- **Melo**: Musik-App (Flutter, Android) — Nachfolger des alten "Melo"-Projekts
- Design: Schwarz (#0B0B10) / Rot (#c0392b) — Dark Theme, 5 Tabs
- Features (frühere Version): Player, Playlisten, Favoriten, Recaps, Cloud-Sync (JWT), Offline-Tombstones, Echtzeit-Sync (SSE)
- Git: http://git.baka-net.de/dustin/Melo.git (Repo heißt "Melo"!)
- Der Code hier ist ein BUILD-KLON für den Server (Builds + Tests)

## ⚙️ Build-Umgebung (Server!)
- Android SDK: ANDROID_HOME=/home/dustin/Android
- Flutter: /home/dustin/development/flutter/bin/flutter
- Build: flutter build apk --target-platform android-arm64
- Bekannte Fixes: compileSdk=37 gesetzt (in android/app/build.gradle.kts), kotlin.jvm.target.validation.mode=warning (gradle.properties)
- ACHTUNG: permission_handler + on_audio_query verlangen SDK 37 — kein echtes android-37 SDK (Kopie von 36!)

## 🛡️ Sicherheitsregeln
- NIE Passwörter/API-Keys in Code oder Commits
- Keine .env committen
- Bei Unsicherheit: Fragen statt raten

## 📋 CHANGELOG-PFLICHT
- Nach JEDER Aufgabe → CHANGELOG.md aktualisieren (neueste zuerst, einfach erklärt!)
- Format: ✅ Was gemacht · 🔧 Details · 🐛 Fixes
- Changelog IMMER mit dem Code committen!

## 🤖 Arbeitsweise
- Vor jedem Commit: @code-reviewer die Änderungen reviewen lassen
- Bei neuen Features: @planner für den Plan, @tdd-guide für Tests
- Bei Sicherheitsfragen: @security-reviewer
- Ponytail-Prinzip: minimale, robuste Lösungen bevorzugen
- Nach Abschluss: commit + push nach git.baka-net.de