🎵 Muzibu Teması - Kalan İşler

1. SPA Navigation KRİTİK

SPA (Single Page Application - Sayfa yenilenmeden gezinme) sistemi. Şu anda sayfalar arası geçişte müzik duruyor çünkü sayfa yeniden yükleniyor.

Yapılacaklar:

• Client-side routing (JavaScript ile URL yönetimi)
• window.history.pushState() ile sayfa değiştirme
• AJAX ile içerik yükleme (sayfa reload yok)
• Player state'i koruma (müzik kesintisiz devam)
• Back/Forward browser butonları çalışmalı

Beklenen Sonuç: Spotify gibi kesintisiz müzik deneyimi.

2. Gerçek Müzik Playback KRİTİK

Player şu anda sadece UI. Gerçek müzik dosyalarını çalabilmeli. HLS (HTTP Live Streaming - Apple'ın akış protokolü) ile adaptive bitrate streaming.

Yapılacaklar:

• HLS.js kütüphanesi entegrasyonu (zaten dahil)
• Audio element ile HLS stream bağlama
• Play/Pause/Seek fonksiyonlarını gerçek audio'ya bağlama
• Şarkı değiştiğinde yeni stream yükleme
• Hata yönetimi (stream bulunamadı, network hatası)
• Loading durumu gösterme
• MP3 fallback (HLS yoksa direkt MP3 çalma)

Beklenen Sonuç: Gerçek müzik dosyalarını kesintisiz akış yapabilme.

3. Database Schema & Migrations KRİTİK

Müzik verileri için veritabanı yapısı. Şu anda Modules/Muzibu altında migration'lar var ama henüz çalıştırılmadı.

Yapılacaklar:

• Mevcut migration'ları kontrol et (artists, albums, songs, playlists, genres, sectors)
• Tenant migration'ları çalıştır: php artisan tenants:migrate
• Central migration'ları çalıştır: php artisan migrate
• İlişkileri test et (HasMany, BelongsTo, BelongsToMany)
• Seed data oluştur (demo müzikler, playlistler)

Beklenen Sonuç: Database yapısı hazır, demo veriler yüklü.

4. Backend API Endpoints KRİTİK

Frontend'in verileri çekebilmesi için API endpoint'leri.

Yapılacaklar:

• GET /api/playlists - Playlist listesi
• GET /api/playlists/{id} - Playlist detayı (şarkılarla)
• GET /api/albums - Albüm listesi
• GET /api/albums/{id} - Albüm detayı (şarkılarla)
• GET /api/songs/recent - Son dinlenen şarkılar
• GET /api/genres - Tür listesi
• GET /api/sectors - Sektör listesi
• Tenant-aware endpoint'ler (her tenant kendi verilerini görsün)
• Pagination (sayfa başına 20-50 kayıt)

Beklenen Sonuç: Frontend dinamik veri çekebilecek.

5. Volume Normalization KRİTİK

Farklı şarkıların ses seviyesi farklı olabilir. B2B müzik platformu için ses dengelemesi şart.

Yapılacaklar:

• Web Audio API (Tarayıcıda gelişmiş ses işleme) ile GainNode oluşturma
• Her şarkının loudness değerini database'de saklama
• Şarkı değiştiğinde GainNode'u ayarlama
• Hedef loudness: -14 LUFS (Spotify standardı)
• Kullanıcı volüm ayarı + normalization birleşimi

Beklenen Sonuç: Tüm şarkılar aynı ses seviyesinde çalacak.

6. Playlist Detail Page Yüksek

Playlist'e tıklayınca açılacak detay sayfası (Spotify'daki gibi).

Yapılacaklar:

• Playlist header: Cover image, isim, açıklama, şarkı sayısı
• Şarkı listesi: Sıra no, kapak, isim, artist, albüm, süre
• Play butonu (playlist'i baştan çalmaya başla)
• Her şarkının yanında context menu (add to queue, add to playlist)
• Hover efekti: Üzerine gelince play butonu görünsün

Beklenen Sonuç: Kullanıcı playlist detaylarını görebilecek ve çalabilecek.

7. Album Detail Page Yüksek

Albüm detay sayfası (Playlist detayına benzer ama artist bilgisi daha ön planda).

Yapılacaklar:

• Album header: Cover, isim, artist, yıl, toplam süre
• Şarkı listesi (track numarası ile)
• Artist bilgisi (artist sayfasına link)
• Play all butonu

Beklenen Sonuç: Albüm detayları görüntülenebilecek.

8. Queue Management Yüksek

Sırada hangi şarkılar var? Sırayı yönetme (silme, sıralama).

Yapılacaklar:

• Sağ tarafta açılır Queue sidebar
• Şu an çalan şarkı en üstte vurgulu
• Sıradaki şarkılar altında listelenir
• Drag & drop ile sıralama değiştirme
• Şarkıyı sıradan çıkarma (X butonu)
• Queue'yu temizleme butonu

Beklenen Sonuç: Kullanıcı dinleme sırasını görebilecek ve düzenleyebilecek.

9. Search Functionality Yüksek

Üst bardaki arama çubuğu çalışmalı. Meilisearch (Hızlı arama motoru, Laravel Scout ile entegre) ile gerçek zamanlı arama.

Yapılacaklar:

• Meilisearch kurulumu (zaten sistemde olabilir)
• Laravel Scout konfigürasyonu
• Song, Album, Playlist, Artist modellerini indexleme
• Arama API endpoint: GET /api/search?q=...
• Dropdown ile gerçek zamanlı sonuçlar (yazdıkça göster)
• Kategori bazlı sonuçlar (Songs, Albums, Playlists, Artists)
• Klavye navigasyonu (arrow keys ile gezinme, enter ile seçme)

Beklenen Sonuç: Kullanıcı yazdıkça sonuçları görecek.

10. Favorites Backend Yüksek

Kalp ikonları şu anda sadece localStorage kullanıyor. Database'e kaydetmeliyiz.

Yapılacaklar:

• Polymorphic relation: favorites tablosu (user_id, favoritable_type, favoritable_id)
• API endpoint: POST /api/favorites (favorilere ekle)
• API endpoint: DELETE /api/favorites/{id} (favorilerden çıkar)
• API endpoint: GET /api/favorites (kullanıcının favorileri)
• Frontend'de kalp ikonlarını backend'e bağlama
• Favoriler sayfası (kullanıcının tüm favorileri)

Beklenen Sonuç: Favoriler kalıcı olacak, hesaba bağlı olacak.

11. Recently Played Tracking Orta

Kullanıcının son dinlediği şarkıları takip etme.

Yapılacaklar:

• song_plays tablosuna kayıt atma (user_id, song_id, played_at)
• Şarkı %50'sini geçince "dinlendi" sayma
• "Jump Back In" bölümünde son dinlenenleri gösterme
• Duplicate kaydı önleme (aynı şarkıyı arka arkaya dinlediyse)

Beklenen Sonuç: "Jump Back In" bölümü dinamik olacak.

12. Genre & Sector Pages Orta

Türlere ve sektörlere göre filtreleme sayfaları.

Yapılacaklar:

• /genres/{slug} sayfası (örn: /genres/pop)
• /sectors/{slug} sayfası (örn: /sectors/cafe-restaurant)
• Filtrelenmiş playlist/albüm listesi
• Sidebar'da aktif genre/sector vurgulama

Beklenen Sonuç: Kullanıcılar sektörlerine özel müzik bulabilecek.

13. Repeat Modes Orta

Repeat butonunun gerçekten çalışması (off, all, one).

Yapılacaklar:

• Repeat state: off, all, one
• Repeat butonu tıklanınca state değişsin
• Şarkı bitince repeat mode'a göre davranış:
  • off: Sıradaki şarkıya geç, sıra bitince dur
  • all: Sıradaki şarkıya geç, sıra bitince başa dön
  • one: Aynı şarkıyı tekrar çal

Beklenen Sonuç: Kullanıcı tekrar modunu seçebilecek.

14. Shuffle Mode Orta

Karıştırma modu (queue'yu rastgele sırala).

Yapılacaklar:

• Shuffle butonuna tıklayınca queue'yu karıştır
• Fisher-Yates algoritması ile rastgele sıralama
• Şu an çalan şarkı yerinde kalsın
• Shuffle kapatınca orijinal sıraya dön

Beklenen Sonuç: Kullanıcı karışık dinleme yapabilecek.

15. Device Limit Enforcement Orta

B2B plan: Aynı anda max X cihaz dinleyebilir (örn: 5 cihaz).

Yapılacaklar:

• Device fingerprinting (browser, IP, user agent ile unique ID)
• active_sessions tablosu (user_id, device_id, last_active)
• Play'e bastığında aktif cihaz sayısını kontrol et
• Limit aşıldıysa hata göster: "Max X cihaz aktif olabilir"
• Aktif cihazları listeleme sayfası (kullanıcı hangi cihazlardan dinliyor?)
• Cihazı deaktif etme butonu

Beklenen Sonuç: Şirketler plan limitlerini aşamayacak.

16. Artist Pages Düşük

Artist detay sayfası (discography, bio, top songs).

17. Playlist Creation Düşük

Kullanıcılar kendi playlistlerini oluşturabilsin.

18. Lyrics Display Düşük

Şarkı sözlerini gösterme (sync'li veya statik).

19. Admin Panel Düşük

Müzik yönetimi için admin paneli (şarkı yükleme, playlist düzenleme).

20. Analytics Dashboard Düşük

Şirketler için dinleme istatistikleri (en çok dinlenen şarkılar, sektör analizi).