HLS 4-Saniye Standardizasyon

## GOREV: Muzibu HLS Standardizasyon — Production (~30K Sarki)

Kullanicilar su an orijinal MP3 dinliyor. Orijinal MP3 dosyalarina DOKUNULMAYACAK.
Amac: Her sarki icin HLS varyantlari + MP3 fallback dosyalari URETMEK.

Detayli bilgi icin bu dosyayi oku:
public/readme/2026/02/22/hls-4sn-standardizasyon/index.html

## Her sarki icin uretilecekler:
- HLS high: 4sn segment, VOD, AES-128 encrypted (orijinal bitrate)
- HLS ultralow: 32kbps, mono, 22050Hz, 4sn segment
- HLS low: 64kbps, mono, 22050Hz, 4sn segment
- HLS mid: 128kbps, stereo, 44100Hz, 4sn segment
- master.m3u8: 4 varyant referansi
- MP3 128k: 128kbps stereo fallback
- MP3 64k: 64kbps mono son care fallback
- enc.keyinfo URI: /hls-key/muzibu/songs/{id} formatinda

## ADIMLAR (SIRAYLA!)

### 1. Kod cek + cache temizle
```bash
cd /var/www/vhosts/muzibu.com/httpdocs
git pull origin main
php artisan cache:clear && php artisan route:clear && php artisan config:clear && php artisan view:clear
composer dump-autoload
curl -s -k https://muzibu.com/opcache-reset.php
php artisan config:cache && php artisan route:cache
```
opcache-reset KRITIK! Yoksa Horizon eski kodu kullanir.

### 2. Dry-run
```bash
php artisan tenants:run hls:add-variants --tenants=1001 \
    --option="quality=all" --option="mp3-128=1" --option="mp3-64=1" \
    --option="refresh-master=1" --option="re-encode-high=1" \
    --option="dry-run=1"
```
Beklenen: "Toplam HLS: ~30000, Islenecek: ~30000". Bana sonucu raporla.

### 3. 10 sarki test
```bash
php artisan tenants:run hls:add-variants --tenants=1001 \
    --option="quality=all" --option="mp3-128=1" --option="mp3-64=1" \
    --option="refresh-master=1" --option="re-encode-high=1" \
    --option="limit=10"
```
Beklenen: "10 basarili, 0 basarisiz". Ilk 10 sarkiyi dogrula:
- playlist.m3u8: #EXTINF ~4.0xx (6.xxx OLMAMALI)
- master.m3u8: 4 varyant (ultralow + low + mid + original)
- enc.keyinfo 1. satir: /hls-key/ ile baslamali (storage OLMAMALI)
- #EXT-X-PLAYLIST-TYPE:VOD olmali
- mp3_128/{id}.mp3 ve mp3_64/{id}.mp3 mevcut olmali
Bana sonucu raporla. Sorun varsa DURMA.

### 4. Tam re-encode (3 paralel terminal)
```bash
# Terminal 1 (screen -S hls-batch1)
php artisan tenants:run hls:add-variants --tenants=1001 \
    --option="quality=all" --option="mp3-128=1" --option="mp3-64=1" \
    --option="refresh-master=1" --option="re-encode-high=1" \
    --option="limit=10000" --option="offset=0"

# Terminal 2 (screen -S hls-batch2)
php artisan tenants:run hls:add-variants --tenants=1001 \
    --option="quality=all" --option="mp3-128=1" --option="mp3-64=1" \
    --option="refresh-master=1" --option="re-encode-high=1" \
    --option="limit=10000" --option="offset=10000"

# Terminal 3 (screen -S hls-batch3)
php artisan tenants:run hls:add-variants --tenants=1001 \
    --option="quality=all" --option="mp3-128=1" --option="mp3-64=1" \
    --option="refresh-master=1" --option="re-encode-high=1" \
    --option="limit=10000" --option="offset=20000"
```
screen kullan — terminal kapansa da devam etsin.

### 5. enc.keyinfo URI fix
Re-encode sonrasi eski kodla uretilmis enc.keyinfo'lardaki storage URL'leri duzelt:
```bash
cd /var/www/vhosts/muzibu.com/httpdocs
HLS_BASE="storage/tenant1001/app/public/muzibu/hls"
DOMAIN="https://muzibu.com"
fixed=0
for dir in $HLS_BASE/*/; do
    id=$(basename "$dir")
    for keyinfo in "$dir/enc.keyinfo" "$dir/ultralow/enc.keyinfo" "$dir/low/enc.keyinfo" "$dir/mid/enc.keyinfo"; do
        [ ! -f "$keyinfo" ] && continue
        uri=$(head -1 "$keyinfo")
        if echo "$uri" | grep -q "storage"; then
            variant=""
            case "$keyinfo" in */ultralow/*) variant="?v=ultralow";; */low/*) variant="?v=low";; */mid/*) variant="?v=mid";; esac
            sed -i "1s|.*|${DOMAIN}/hls-key/muzibu/songs/${id}${variant}|" "$keyinfo"
            fixed=$((fixed + 1))
        fi
    done
done
echo "Duzeltildi: $fixed dosya"
```

### 6. Final dogrulama + cache temizligi
```bash
php artisan cache:clear && php artisan view:clear && php artisan responsecache:clear
```
Rastgele 20 sarki kontrol et ve bana su bilgileri raporla:
- Toplam HLS klasor sayisi
- master.m3u8 olan sarki sayisi
- MP3 128k dosya sayisi
- MP3 64k dosya sayisi
- 20 rastgele sarkida: segment suresi (4sn mi?), varyant sayisi, VOD tipi, enc.keyinfo URI

## KURALLAR
- Orijinal MP3'lere DOKUNMA (sadece okunur, kaynak dosya)
- Servis restart YAPMA (apache, nginx, redis)
- Migration YOK, sadece dosya uretimi
- Hata olursa komut durmaz, sayar ve devam eder
- Kesilirse ayni komutu tekrar calistir (mevcut dosyalari atlar)
- Her adim sonrasi bana durum raporla