Muzibu AI Görsel & HLS Toplu İşlem Sistemi

✅

🎯 Özet - Sistem Zaten Mevcut ve Çalışıyor!

Muzibu müzik platformunda tamamen otomatik, ölçeklenebilir ve tenant-aware bir AI görsel ve HLS streaming sistemi zaten çalışıyor!

🎨

AI Görsel Üretimi

Leonardo AI + GPT-4 Enhancement

🎵

HLS Streaming

FFmpeg + 4sn chunk + Audio filters

📦

Toplu İşlem

Queue-based batch processing

📝

Basit Anlatım (Herkes İçin)

🎨 1. AI Görsel Üretim Sistemi

Ne yapar?
Şarkı, albüm, çalma listesi, müzik türü ve sektör için otomatik profesyonel kapak görselleri oluşturur. Kullanıcı görselleri yapay zeka ile saniyeler içinde hazırlanır.

Nasıl çalışır?
Leonardo AI adlı görüntü üretim servisi kullanır. Şarkı başlığı veya albüm adını alır, GPT-4 ile zengin bir görsel tarifi oluşturur, sonra bu tariften yüksek kaliteli görsel üretir.

Ne zaman çalışır?

Yeni şarkı eklendiğinde otomatik görsel üretir
Admin panelden toplu görsel üretimi yapılabilir
Tek tek şarkılar için manuel üretim mümkün

💡 Özel Filtre: Sistem insan figürü göstermeyi tercih etmiyor. Bunun yerine manzara, soyut sanat, ışık efektleri, enstrüman siluetleri kullanıyor. Bu sayede görseller daha evrensel ve müzik odaklı oluyor.

🎵 2. HLS Streaming Sistemi

Ne yapar?
MP3 dosyalarını internet üzerinden kesintisiz, hızlı ve optimize şekilde dinlenmesi için hazırlar. Kullanıcılar şarkıya hızlı başlar, internet bağlantısına göre kalite ayarlanır.

Nasıl çalışır?
MP3 dosyasını küçük parçalara böler (her parça 4 saniye). Bu parçaları HLS formatında depolar. Böylece şarkı indirme beklemeden başlatılır, sadece gerekli parçalar yüklenir.

Neden önemli?

Hızlı başlatma: İlk 4 saniye yüklenir, şarkı çalmaya başlar
Bant genişliği tasarrufu: Sadece dinlenen kısım yüklenir
Ses kalitesi koruması: Orijinal kalite asla düşürülmez
Profesyonel ses düzenleme: Ses seviyesi normalize edilir, stereo genişletilir

📦 3. Toplu İşlem Altyapısı

Ne yapar?
Tek seferde onlarca veya yüzlerce şarkı için görsel üretimi, HLS dönüşümü veya her ikisini birden yapar. Manuel tek tek işlem yapmaya gerek kalmaz.

Hangi işlemler toplu yapılabilir?

Toplu şarkı yükleme: Albüme çoklu MP3 yükle (metadata otomatik çekilir)
Toplu HLS üretimi: HLS'i olmayan şarkıları toplu dönüştür
Toplu AI görsel üretimi: Görseli olmayan içeriklere toplu görsel üret
İkisini birlikte: Şarkı yüklerken otomatik HLS + görsel üretimi

⚡ Kuyruk Sistemi: İşlemler arka planda sırayla yapılır. 100 şarkı yükleseniz bile sistem donmaz, her işlemi sırasıyla tamamlar. İlerleme durumunu admin panelden görebilirsiniz.

🔧

Teknik Detaylar (Geliştiriciler İçin)

🎨 AI Görsel Üretim - Teknik Mimari

📂 Core Services

/app/Services/Media/LeonardoAIService.php - Leonardo AI entegrasyonu (1770 satır)
/Modules/AI/app/Services/AIImageGenerationService.php - DALL-E 3 entegrasyonu (256 satır)

⚙️ Jobs (Queue System)

/Modules/Muzibu/app/Jobs/GenerateSongCover.php - Şarkı görseli (162 satır)
/Modules/Muzibu/app/Jobs/GenerateGenericMuzibyCover.php - Evrensel görsel (183 satır)
/Modules/MediaManagement/app/Jobs/GenerateAICover.php - MediaManagement entegrasyonu

🎯 Desteklenen Modeller

song → Modules\Muzibu\App\Models\Song
album → Modules\Muzibu\App\Models\Album
playlist → Modules\Muzibu\App\Models\Playlist
genre → Modules\Muzibu\App\Models\Genre (müzik türü)
sektor → Modules\Muzibu\App\Models\Sector (radyo sektörü)
radio → Modules\Muzibu\App\Models\Radio

🚀 İşlem Akışı (Otomatik)

AlbumBulkUploadComponent → Şarkı yükle
Song::create() → Şarkı kaydı oluştur
muzibu_generate_ai_cover($song, $title, 'song') → Helper çağır
GenerateSongCover::dispatch() → Queue'ya ekle
LeonardoAIService::generateFreeImagination() → GPT-4 + Leonardo AI
$song->addMediaFromUrl() → hero collection'a kaydet
ai_use_credits(1) → Kredi düş (1 görsel = 1 kredi)

💰 Kredi Sistemi


                                            ai_use_credits(1, null, [

                                              'usage_type' => 'image_generation',

                                              'provider_name' => 'leonardo',

                                              'model' => 'lucid-origin',

                                              'operation_type' => 'song_cover_free_imagination',

                                              'credit_cost' => 1

                                            ]);

✅ Kullanıcı Görseli Kontrolü


                                            if ($song->hasMedia('hero')) {

                                              Log::info('SKIPPED - Hero already exists');

                                              return; // AI üretme!

                                            }

Kullanıcı kendi görselini yüklemişse AI üretimi yapılmaz.

🎵 HLS Streaming - Teknik Mimari

📂 Core Service & Jobs

/app/Services/Muzibu/HLSService.php - HLS conversion servisi (355 satır)
/Modules/Muzibu/app/Jobs/ConvertToHLSJob.php - Tekli HLS (196 satır)
/Modules/Muzibu/app/Jobs/ProcessBulkSongHLSJob.php - Toplu HLS (134 satır)
/Modules/Muzibu/app/Http/Livewire/Admin/SongBulkConvertComponent.php - Admin UI (241 satır)

🎯 HLS Format Özellikleri

Codec: AAC (HLS standart)
Sample Rate: 48kHz
Channels: Stereo (2)
Chunk Duration: 4 saniye (hızlı başlatma)
Playlist Type: VOD (Video-on-Demand)
Encryption: Yok (browser uyumluluğu için)

🔒 Bitrate Koruması

Orijinal bitrate ASLA düşürülmez:

≤128 kbps → 128k
≤160 kbps → 160k
≤192 kbps → 192k
≤256 kbps → 256k
≤320 kbps → 320k
>320 kbps → Orijinal bitrate kullan (lossless korunur)

🎚️ Audio Filters (Ultimate Edition)

loudnorm=I=-16:TP=-1.5:LRA=11 - Loudness normalization
stereotools=mlev=1.2 - Stereo genişletme
equalizer=f=100:t=q:w=1:g=1 - Bass boost +1dB
equalizer=f=8000:t=q:w=1:g=-2 - Treble cut -2dB
lowpass=f=14000 - Low-pass filter 14kHz

📁 Dosya Yapısı (Tenant Storage)


                                            storage/tenant1001/app/public/muzibu/

                                            ├── songs/

                                            │   └── song_xxx.mp3 (Orijinal MP3)

                                            └── hls/

                                                └── {song_id}/

                                                    ├── playlist.m3u8 (Master playlist)

                                                    ├── segment-000.ts (4 saniye)

                                                    ├── segment-001.ts

                                                    └── segment-002.ts

URL: https://muzibu.com/storage/tenant1001/muzibu/hls/{song_id}/playlist.m3u8

🚀 İşlem Akışı (Otomatik)

AlbumBulkUploadComponent → Şarkı yükle
Song::create() → MP3 kaydı oluştur
ConvertToHLSJob::dispatch($song) → Queue'ya ekle
FFmpeg → MP3'ü HLS'e çevir (4sn chunk'lar, audio filters)
song.hls_path = 'muzibu/hls/{song_id}/playlist.m3u8' → DB güncelle
Cache invalidate → MuzibuCacheService

📦 Toplu İşlem - Teknik Altyapı

📂 Bulk Operations Components

/Modules/Muzibu/app/Http/Livewire/Admin/AlbumBulkUploadComponent.php (410 satır) - Toplu şarkı yükleme
/Modules/Muzibu/app/Http/Livewire/Admin/SongBulkConvertComponent.php (241 satır) - Toplu HLS dönüşümü
/Modules/Muzibu/app/Http/Livewire/Admin/AICoverComponent.php (142 satır) - Toplu AI görsel

⚙️ Queue Yapılandırması

muzibu_my_playlist - AI görsel üretimi queue
muzibu_tenant_{id}_hls - HLS conversion (tenant-aware)
muzibu_isolated - Toplu işlemler (bulk update/delete)

⏱️ Job Özellikleri

AI Görsel: timeout=180s (3 dakika), tries=1 (retry yok)
HLS Conversion: timeout=600s (10 dakika), tries=3 (3 deneme)
Bulk Operations: timeout=900s (15 dakika), tries=1

📊 Progress Tracking

Cache-based ilerleme takibi:

Her işlem için unique batch ID
Cache'de ilerleme yüzdesi
Başarılı/başarısız sayısı
Admin panelde real-time güncelleme

🎨

AI Görsel Prompt Sistemi - Detaylı Analiz

✨ Leonardo AI - Serbest Hayal Gücü Modu (Aktif)

✅ ŞU ANDA KULLANIMDA (2025-12-26 İtibariyle)

Serbest hayal gücü modu aktif. AI minimum kısıtlama ile kendi yaratıcılığını kullanıyor. GPT-4 ile 11 altın kurala göre prompt zenginleştirme yapılıyor.

🎯 Ana Özellikler

GPT-4 Enhancement: Basit başlık → Zengin profesyonel prompt
11 Altın Kural: Photo type, subject, environment, camera angle, composition, lighting, camera+lens, film stock, imperfections, mood, post-processing
Minimal Negative Prompt: Sadece NSFW yasağı (yazı yasağı yok!)
İnsansız Görsel Tercih: AI'a "insan figürü kullanma" talimatı verilmiş
Yüksek Çözünürlük: 1472x832 (16:9 ratio)
Random Style: 5 stil (stock_photo 3x ağırlık, commercial_photo, photographic, cinematic, creative)

🚫 İnsan Figürü Filtresi (Zaten Mevcut!)

GPT-4'e Verilen Talimat:

"IMPORTANT: Unless the title EXPLICITLY requires human figures (e.g., 'dancing couple', 'portrait', 'crowd'), prefer imagery WITHOUT people. Focus on landscapes, atmospheres, abstract shapes, instruments, or symbolic representations of emotions (e.g., sunset for love, rain for longing)."

Türkçesi:
"ÖNEMLİ: Başlık açıkça insan figürü gerektirmedikçe (örn: 'dans eden çift', 'portre', 'kalabalık'), İNSANSIZ görselleri tercih et. Manzara, atmosfer, soyut şekiller, enstrümanlar veya duyguların sembolik temsilleri kullan (örn: aşk için gün batımı, özlem için yağmur)."

📸 11 Altın Kural Detayları

Photo Type: Stock photograph, Commercial photo
Subject: İnsansız tercih edilir (manzara, atmosfer, soyut, enstrüman)
Environment: AI kendi seçer (uygun ortam)
Camera Angle: AI kendi seçer (perspektif, açı)
Composition: AI kendi seçer (kare düzeni)
Lighting: AI kendi seçer (ışık düzeni, atmosfer)
Camera + Lens: Profesyonel ekipman (Canon R5, Sony A7R, Nikon Z9 vb.)
Film Stock: Analog film estetiği (Kodak Portra, Fuji Velvia vb.)
Imperfections: Doğal kusurlar (lens dust, grain, vignette)
Mood: AI kendi seçer (duygusal atmosfer)
Post-Processing: AI kendi seçer (renk, kontrast, ton)

⚠️ Özel Durumlar

Başlık anlamsızsa (örn: "a", "asdf", "xxx")
→ Abstract sanat veya müzik temalı görsel (enstrüman, sahne, stüdyo, ses dalgaları)
Başlık müstehcen/uygunsuzsa
→ Abstract sanat veya müzik enstrümanları/konser atmosferi
Duygular (Aşk, Özlem, Yalnızlık)
→ Sembolik görseller (güneş batımı, yağmur, boş sokak, ışık efektleri)
Müzik temalı
→ Enstrüman siluetleri, konser sahne ışıkları, stüdyo ekipmanları, ses dalgaları

🎨 Örnek Prompt Dönüşümü

INPUT (Şarkı Başlığı):

"Yağmurlu Bir Akşam"

OUTPUT (GPT-4 Enhanced Prompt):

"Stock photograph of a rainy evening atmosphere without people, empty city street with glowing streetlights reflecting on wet asphalt, moody urban environment, low angle perspective capturing rain droplets, dramatic composition with leading lines, soft diffused lighting with warm street lamp glow, Canon EOS R5 with 24-70mm f/2.8 lens, Kodak Portra 400 film stock aesthetic, subtle grain and vignette, melancholic mood, cinematic color grading with enhanced blues and warm tones"

❌ Eski Sistem (Disable Edildi)

🚫 ARTIK KULLANILMIYOR

Tenant-spesifik prompt'lar (tenant 2: endüstriyel, tenant 1001: müzik) ve agresif kısıtlamalar (yazı yasağı, marka yasağı) artık kullanılmıyor. Kod yorum satırında (buildIndustrialDynamicPrompt).

📋 Eski Sistemin Özellikleri

Agresif Negative Prompt: text, letters, words, numbers, brand names, logos (50+ kelime)
Tenant-Spesifik: Tenant 2 → endüstriyel ekipman, Tenant 1001 → müzik
11 Kural Havuzları: Her kural için 50-100 seçenek listesi
Katı Ortam Kuralları: Sadece belirli ortamlarda (warehouse, studio vb.)

✅ Mevcut Prompt Durumu (Sonuç)

🎯 İNSAN FİGÜRÜ ZATEن MEVCUT FİLTREDE!

Sisteminiz zaten insan figürlerini filtreliyor. GPT-4'e verilen talimat açık ve net: "İnsansız görseller tercih et, manzara/atmosfer/soyut kullan."

✅ Sistemin Tercih Ettiği

• Manzaralar (şehir, doğa, gün batımı)
• Atmosfer (yağmur, sis, ışık)
• Soyut sanat (şekiller, renkler)
• Müzik enstrümanları (gitar, piyano)
• Ses dalgaları, ışık efektleri
• Konser sahne atmosferi

❌ Sistemin Kaçındığı

• İnsan figürleri (genel)
• Yüz portreleri
• Kalabalık sahneler
• Dans eden insanlar (zorunlu değilse)
• Gruplar, çiftler

📊 Negative Prompt (Minimal)


                                        "nsfw, nude, naked, porn, explicit sexual content"

Sadece uygunsuz içerik yasak. Yazı, marka, logo yasağı YOK (AI kendi karar veriyor).

💡

Öneriler & İyileştirmeler

🎨 1. İnsan Figürü Filtresi (ZATEN MEVCUT!)

✅ YAPMANIZA GEREK YOK

Sisteminiz zaten insan figürlerini filtreliyor. GPT-4 prompt enhancement'ında açık talimat var: "İnsansız görseller tercih et." Bu nedenle yeni bir filtre eklemenize gerek yok.

Mevcut durum: GPT-4'e verilen talimat zaten insan figürlerini minimize ediyor. Sadece başlık açıkça insan gerektiriyorsa (örn: "portre", "dans eden çift") insan figürü kullanılıyor.

Alternatif (opsiyonel): Daha da agresif filtre istiyorsanız, negative prompt'a ekleyebilirsiniz:


                                        "nsfw, nude, naked, porn, explicit sexual content, human, people, person, man, woman,
                                        face, portrait, crowd, group, hands, body, figure"

⚠️ Dikkat: Bu agresif filtreleme bazı başlıklar için uygun olmayabilir (örn: "İnsanlık Şarkısı", "Halkın Sesi" gibi insan odaklı konseptler).

📦 2. Toplu İşlem Kullanıcı Arayüzü (Admin Panel)

Mevcut durum: 3 ayrı sayfa (Toplu şarkı yükleme, Toplu HLS, Toplu AI görsel). Her işlem için ayrı sayfa gezilmesi gerekiyor.

Öneri: Tüm toplu işlemleri tek bir "Toplu İşlemler Dashboard'u" altında toplayın:

Toplu Şarkı Yükleme: Drag & drop + otomatik HLS + otomatik AI görsel (tek seferde)
Toplu HLS Üretimi: HLS'i olmayan şarkıları toplu dönüştür
Toplu AI Görsel: Görseli olmayan içeriklere toplu görsel üret
Kombine İşlemler: Seçili şarkılara hem HLS hem AI görsel üret
Progress Dashboard: Tüm aktif job'ların ilerlemesini tek yerden izle

🚀 3. Artisan Command (CLI Toplu İşlem)

Öneri: Admin panel dışında CLI ile toplu işlem yapma imkanı:


                                        # HLS'i olmayan tüm şarkıları dönüştür

                                        php artisan muzibu:convert-hls --missing-only


                                        # Görseli olmayan tüm şarkılara AI görsel üret

                                        php artisan muzibu:generate-covers --missing-only --type=song


                                        # Belirli albüm için hem HLS hem AI görsel

                                        php artisan muzibu:process-album 123 --with-hls --with-covers


                                        # Tüm Genre'ler için AI görsel üret

                                        php artisan muzibu:generate-covers --type=genre --force

Avantajları: Cron job ile otomatik toplu işlem, SSH üzerinden uzaktan işlem, daha fazla kontrol (dry-run, force, batch-size vb.)

📊 4. İstatistik & Rapor Sayfası

Öneri: Toplu işlem istatistiklerini göster:

Toplam şarkı sayısı / HLS'i olanlar / AI görseli olanlar
Albumler için aynı istatistikler
Son 7/30/90 günde üretilen görseller/HLS'ler
AI kredi kullanımı (aylık/yıllık)
Başarısız job'lar (retry gerekli mi?)
Ortalama işlem süreleri (HLS: ~45s, AI: ~120s)

🎨 5. AI Görsel Stilleri (Özelleştirme)

Öneri: Farklı görsel stilleri seçim imkanı:

Mevcut Stiller (Random)

• Stock Photo (3x ağırlık)
• Commercial Photo
• Photographic
• Cinematic
• Creative

Yeni Stil Önerileri

• Abstract Art (soyut sanat)
• Minimalist (minimal tasarım)
• Neon/Cyberpunk (elektronik müzik)
• Vintage/Retro (nostaljik)
• Watercolor (suluboya)
• 3D Render (modern)

Kullanım: Admin panelde stil seçimi dropdown'u eklenebilir. Farklı genre'ler için farklı stiller uygulanabilir (Rock → Grunge, Pop → Vibrant, Jazz → Vintage).

🔄 6. Re-generate Özelliği (Beğenmedim, Yeniden Üret)

Mevcut durum: Kullanıcı hero görseli varsa AI üretimi yapılmıyor (doğru davranış).

Öneri: Admin panelde "Yeniden Üret" butonu:

AI ile üretilmiş görseli beğenmezse → Yeniden üret (farklı prompt seed)
3-5 farklı varyasyon göster, en iyisini seç
Manuel prompt override (admin özel tarif yazabilir)
Style override (bu seferlik farklı stil dene)

⚡ 7. Queue Optimizasyonu (Önceliklendirme)

Öneri: İşlem önceliklendirme sistemi:

Yüksek öncelik: Manuel tekli işlemler (kullanıcı bekliyor)
Orta öncelik: Yeni içerik eklerken otomatik işlemler
Düşük öncelik: Toplu arka plan işlemleri (gece 03:00-06:00 arası)


                                        // Örnek priority kullanımı

                                        GenerateSongCover::dispatch($song)

                                          ->onQueue('muzibu_ai_high_priority');

🎯

Sonuç & Aksiyon Planı

✅ Sistem Durumu

Muzibu müzik platformu toplu AI görsel ve HLS üretimi için HAZIR ve TAM OTOMATİK çalışıyor! 🎉

✅ AI Görsel

• Leonardo AI + GPT-4
• 6 model tipi (song/album/playlist/genre/sector/radio)
• İnsan filtresi aktif
• Otomatik + Manuel

✅ HLS Streaming

• FFmpeg conversion
• 4sn chunk (hızlı başlatma)
• Audio filters (Ultimate Ed.)
• Bitrate koruması

✅ Toplu İşlem

• Bulk upload (çoklu MP3)
• Bulk HLS conversion
• Bulk AI cover generation
• Queue + Progress tracking

🚫 İnsan Figürü Filtresi

✅ ZATEN MEVCUT - YAPMANIZA GEREK YOK!

GPT-4 prompt enhancement'ında açık talimat var: "İnsansız görseller tercih et, manzara/atmosfer/soyut kullan." Sistemdeki görseller zaten insan figürü göstermeyi minimize ediyor. Ekstra filtre eklemenize gerek yok.

🚀 Önerilen Aksiyonlar (Opsiyonel İyileştirmeler)

Sisteminiz zaten çalışıyor, ancak şu eklemeler yapabilirsiniz:

Toplu İşlem Dashboard'u (3 sayfa yerine tek dashboard)
→ Admin panel UX iyileştirmesi
CLI Artisan Commands (SSH üzerinden toplu işlem)
→ Otomasyon ve cron job desteği
İstatistik Sayfası (AI/HLS kullanım raporları)
→ Görünürlük ve izleme
AI Stil Seçimi (abstract, minimal, vintage vb.)
→ Görsel çeşitliliği
Yeniden Üret Butonu (beğenmedim, tekrar üret)
→ Kullanıcı kontrolü

🎉 Sistem Hazır ve Çalışıyor!

Toplu AI görsel üretimi, HLS dönüşümü ve ikisini birlikte yapma altyapısı tam otomatik çalışıyor. İnsan figürü filtresi de zaten aktif. İstediğiniz zaman admin panelden veya otomatik olarak kullanabilirsiniz.