Muzibu Mobile

Muzibu Mobile App — Ekran Haritasi
====================================

Tab Navigator (Alt Menu)
├── Home Tab
│   ├── HomeScreen                — Onerileri, yeni cikanlar, populerler
│   ├── AlbumDetailScreen         — Album detay + sarki listesi
│   ├── ArtistDetailScreen        — Sanatci profili + albumler + sarkilar
│   ├── PlaylistDetailScreen      — Playlist detay + sarki listesi
│   └── GenreDetailScreen         — Tur sarkilari
│
├── Discover Tab
│   ├── DiscoverScreen            — Turler, sanatcilar, radyolar, sektorler
│   ├── GenreListScreen           — Tum turler
│   ├── ArtistListScreen          — Tum sanatcilar
│   ├── RadioListScreen           — Radyo istasyonlari
│   └── SectorDetailScreen        — Sektor playlistleri
│
├── Search Tab
│   └── SearchScreen              — Anlık arama (Meilisearch)
│       ├── SearchResultsScreen   — Filtreli sonuclar
│       └── [Detail Screens]      — Sarki/Album/Artist/Playlist detay
│
├── Library Tab
│   ├── LibraryScreen             — Favoriler, Playlistler, Indirilenler
│   ├── FavoritesScreen           — Favori sarkilar/albumler
│   ├── MyPlaylistsScreen         — Kullanici playlistleri
│   ├── PlaylistEditScreen        — Playlist duzenle (drag-drop)
│   ├── DownloadsScreen           — Offline indirilenler
│   └── ListeningHistoryScreen    — Dinleme gecmisi
│
└── Profile Tab
    ├── ProfileScreen             — Profil bilgileri, ayarlar
    ├── SettingsScreen            — Ses kalitesi, bildirimler, depolama
    ├── SubscriptionScreen        — Abonelik planlari, odeme
    ├── DevicesScreen             — Bagli cihazlar
    └── AboutScreen               — Hakkinda, lisanslar

Modal / Overlay Screens
├── FullPlayerScreen              — Tam ekran player (swipe up)
│   ├── Queue Tab                 — Siradaki sarkilar
│   ├── Lyrics Tab                — Sarki sozu
│   └── Related Tab               — Benzer sarkilar
├── AddToPlaylistModal            — Playliste ekle (bottom sheet)
├── LoginModal                    — Giris ekrani (modal)
├── QualityPickerModal            — Ses kalitesi secimi
└── SleepTimerModal               — Uyku zamanlayicisi

Player Katmanlari
==================

1. Transport Layer (react-native-track-player)
   ├── iOS: AVPlayer (native HLS destegi)
   ├── Android: ExoPlayer (native HLS + DASH)
   ├── Background playback (uygulama kapali)
   ├── Lock screen kontrolleri
   ├── Notification controls (Android)
   ├── Control Center (iOS)
   └── Bluetooth / AirPlay / CarPlay

2. Player Service (Headless JS)
   ├── playbackService.ts         — Arka plan event handler
   ├── Oynatma olaylari:
   │   ├── Event.RemotePlay       — Dis cihaz "cal"
   │   ├── Event.RemotePause      — Dis cihaz "duraklat"
   │   ├── Event.RemoteNext       — Sonraki sarki
   │   ├── Event.RemotePrevious   — Onceki sarki
   │   ├── Event.RemoteSeek       — Surukle
   │   └── Event.PlaybackError    — Hata yonetimi
   └── Track metadata (baslik, sanatci, kapak)

3. Queue Manager (Zustand Store)
   ├── currentQueue: Track[]      — Siradaki sarkilar
   ├── currentIndex: number       — Aktif sarki indexi
   ├── shuffleMode: boolean       — Karistirma
   ├── repeatMode: off|one|all    — Tekrar modu
   ├── contextType: string        — Kaynak (album, playlist, genre...)
   ├── contextId: number          — Kaynak ID'si
   └── autoRefill()               — Kuyruk bitince otomatik yenile (API)

4. Stream Resolver
   ├── getStreamUrl(songId)       — API'den signed URL al
   ├── Format secimi:
   │   ├── WiFi: HLS auto (4 seviye)
   │   ├── 4G: HLS soft (3 seviye)
   │   ├── 3G: MP3 128k
   │   └── 2G: MP3 64k
   ├── Token yenileme (expire)
   └── Offline fallback (SQLite)

5. Analytics Tracker
   ├── trackStart(songId)         — Dinleme basla
   ├── trackHit(songId)           — 30sn dinleme (play_count++)
   ├── trackEnd(songId, data)     — Dinleme bitir
   └── Batch send (offline kuyruk)

Offline Indirme Akisi
======================

AŞAMA 1: INDIRME ISTEGI
User: "Bu albumu indir" butonuna basar
   ↓
App: Premium kontrolu (subscription_expires_at > now?)
   ├── Hayir → "Premium uyelik gerekli" modal goster
   └── Evet ↓
App: Download token al (POST /api/muzibu/songs/{id}/download-token)
   ↓ Response: { token, expires_at, format, quality }

AŞAMA 2: DOSYA INDIRME
For each song in album:
   ↓
   1. Stream URL al (signed, 60dk gecerli)
   2. expo-file-system ile indir
      ├── WiFi: MP3 orijinal kalite (veya HLS mid 128k tek dosya)
      └── 4G: MP3 128k (veri tasarrufu)
   3. Indirme ilerlemesi goster (%42 gibi)
   4. AES-256 ile sifreleme (APP_KEY + user_id + song_id)
   5. Sifrelenmis dosya → app sandbox'a kaydet
      iOS:  Documents/offline/{songId}.enc
      Android: files/offline/{songId}.enc

AŞAMA 3: METADATA KAYDI
SQLite'a kaydet:
   ├── song_id, title, artist, album, duration
   ├── cover_url (lokal kopya)
   ├── file_path (sifrelenmis dosya yolu)
   ├── encryption_key_hash
   ├── downloaded_at, expires_at
   └── quality (mp3_128, mp3_original, vb.)

AŞAMA 4: CALMA (OFFLINE)
Kullanici sarkiyi calmak ister:
   ↓
1. SQLite'dan metadata oku
2. Premium hala gecerli mi? (expires_at kontrolu)
   ├── Hayir → "Aboneliginiz sona erdi" uyarisi
   └── Evet ↓
3. Sifrelenmis dosyayi oku
4. Bellek icinde coz (AES-256 decrypt)
5. Gecici dosya olustur (tmp/{random}.mp3)
6. react-native-track-player ile cal
7. Calma bitince gecici dosyayi sil

AŞAMA 5: TEMIZLIK & SYNC
Periyodik kontrol (her acilista + 24 saatte bir):
   ├── Abonelik kontrolu (API veya lokal cache)
   ├── Suresi dolmus indirmeler → Sil
   ├── Depolama alani kontrolu (uyarı >2GB)
   └── Online olunca: Dinleme istatistikleri sync