59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
# Melo Cloud Sync – Phasen-Plan
|
||
|
||
> Stand: 26.07.2026
|
||
> Server: Aingrad (Netcup RS 1000)
|
||
> Technik: Python/Flask + SQLite + Symlinks
|
||
|
||
---
|
||
|
||
## 🔴 **Phase 1: Registry-Server**
|
||
|
||
```
|
||
/var/lib/melo-cloud/
|
||
├── registry/ ← Alle Songs (nur 1x physisch)
|
||
│ └── abc123.mp3
|
||
├── users/
|
||
│ ├── baka/ ← Symlinks auf registry/
|
||
│ └── melo/ ← Symlinks auf registry/
|
||
└── covers/ ← Original-Cover von YouTube
|
||
```
|
||
|
||
- [ ] Flask API (Port 8993)
|
||
- [ ] SQLite DB mit `registry` + `user_songs` Tabellen
|
||
- [ ] Auth per Navidrome-Credentials
|
||
- [ ] Upload-API: SHA256-Check → fpcalc-Fingerprint → speichern in Registry → Hardlink
|
||
- [ ] Deduplizierung: SHA256 + Fingerprint + Titel-Similarität (>90%)
|
||
- [ ] Custom-Titel/Cover pro User
|
||
- [ ] Systemd-Service `melo-cloud.service`
|
||
|
||
## 🟡 **Phase 2: Sync-API**
|
||
|
||
- [ ] `POST /api/cloud/upload` – MP3 hochladen + Registry-Check
|
||
- [ ] `GET /api/cloud/download` – Song vom Server runterladen
|
||
- [ ] `GET /api/cloud/list` – Alle eigenen Songs + Status
|
||
- [ ] `DELETE /api/cloud/delete` – Link in User-Cloud löschen
|
||
- [ ] `GET /api/cloud/status` – Übersicht (Count, letzter Sync)
|
||
|
||
## 🟢 **Phase 3: CloudScreen (Flutter)**
|
||
|
||
- [ ] Neuer Tab "Cloud" mit Bottom-Nav
|
||
- [ ] Upload: Lokale MP3s → Server mit Fortschritt
|
||
- [ ] Download: Server-Songs → Lokal (Batch)
|
||
- [ ] Sync-Logik: `checkLocalVsServer()` → Diff anzeigen
|
||
- [ ] Sync-Intervall: Manuell / 3h / 6h / 12h
|
||
|
||
## 🔵 **Phase 4: Playlist-Teilen**
|
||
|
||
- [ ] Share-Button → 6-stelliger Code generieren
|
||
- [ ] Code eingeben → Playlist importieren
|
||
- [ ] "Nur passende Songs" / "Alle inkl. fehlende" Auswahl
|
||
- [ ] Matching: Per `registry.orig_title` → Levenshtein-Abgleich
|
||
|
||
## 🟣 **Phase 5: Geräteübergreifender Sync**
|
||
|
||
- [ ] Push-Benachrichtigung bei neuen Songs
|
||
- [ ] Auto-Sync nach Intervall
|
||
- [ ] Lösch-Sync über Geräte
|
||
- [ ] Konflikte: Server = Source of Truth
|
||
- [ ] Sync-Protokoll (letzte 50 Aktionen)
|