🎵 Muzibu Platform - Complete Technical Guide

API Endpoint

{
  "email": "user@example.com",
  "password": "******",
  "remember": true
}

AuthController::login()

1. Auth::attempt() - Credentials doğrula
2. session()->regenerate() - Session ID yenile
3. Cache::forget() - Premium cache temizle
4. DeviceService::registerSession() - Cihaz kaydet

DeviceService::registerSession()

// 1. Session ID al (Redis'ten)
$sessionId = session()->getId();

// 2. user_active_sessions tablosuna kaydet
DB::table('user_active_sessions')
  ->updateOrInsert(
    ['session_id' => $sessionId],
    [
      'user_id' => $user->id,
      'device_name' => 'OS X - Chrome',
      'last_activity' => now()
    ]
  );

// 3. Limit kontrolü ve cleanup
$this->handlePostLoginDeviceLimit($user);

Session Storage

⚠️ Redis Session Driver Zorunlu!

# .env
SESSION_DRIVER=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379

Session Redis'te, device tracking DB'de (hybrid sistem)

3-Seviyeli Device Limit Hierarchy

DeviceService::getDeviceLimit($user):

1. User Override (VIP/Ban)
   → $user->device_limit (nullable)

2. Subscription Plan
   → $subscription->plan->device_limit

3. Tenant Settings Fallback
   → setting('auth_device_limit')

4. Ultimate Fallback
   → return 1;

Session Polling (30 saniye)

// player-core.js
startSessionPolling() {
  setInterval(() => {
    fetch('/api/auth/check-session')
      .then(r => r.json())
      .then(data => {
        if (!data.valid) {
          // Session sonlandırıldı
          showDeviceLimitModal();
        }
      });
  }, 30000);
}

Backend Check

// AuthController::checkSession()
$isValid = $deviceService
  ->updateSessionActivity($user);

if (!$isValid) {
  // Session DB'de yok = başka yerden kapatıldı
  Auth::logout();
  return [
    'valid' => false,
    'reason' => 'device_limit_exceeded'
  ];
}

User::isPremium()

// 5 dakikalık cache (performans)
$cacheKey = 'user_' . $this->id .
  '_is_premium_tenant_' . tenant()->id;

return Cache::remember($cacheKey, 300, function() {
  return $this->subscriptions()
    ->where('status', 'active')
    ->where('current_period_end', '>', now())
    ->exists();
});

User::isTrialActive()

return $this->subscriptions()
  ->whereIn('status', ['active', 'trial'])
  ->where('has_trial', true)
  ->whereNotNull('trial_ends_at')
  ->where('trial_ends_at', '>', now())
  ->exists();

Sidebar Badge Logic

// sidebar-left.blade.php
@if($user->isTrialActive())
  <span class="badge bg-yellow-500">
    Deneme Üyesi
  </span>
@elseif($user->isPremium())
  <span class="badge bg-green-500">
    Premium Üye
  </span>
@else
  <span class="badge bg-slate-500">
    Ücretsiz Üye
  </span>
@endif

Subscription Tablosu

subscriptions (tenant DB):
- id
- user_id
- plan_id
- status: 'active' | 'trial' | 'canceled'
- has_trial: boolean
- trial_ends_at: datetime
- current_period_end: datetime

player-core.js - play()

async play(song) {
  // 1. Premium kontrolü
  const isPremium = await this.checkPremiumStatus();

  // 2. URL al
  const url = isPremium
    ? `/api/muzibu/songs/${song.id}/stream` // HLS
    : `/api/muzibu/songs/${song.id}/serve?force_mp3=1`;

  // 3. Howler.js ile çal
  this.playWithHowler(url, song);
}

Streaming Endpoints

Guest Preview Config

guestPreviewConfig: {
  maxPreviewDuration: 30,  // saniye
  showUpgradeModal: true,
  allowSeek: false,        // Seek engelli
  previewMessage: '30 saniyelik önizleme'
}

Seek Block (Free users)

// player-core.js:1085
if (!this.isPremium && seekTo > 30) {
  console.log('🔒 Seek blocked: max 30s');
  return;
}

Queue State Management

// muzibu-store.js
state: {
  queue: [],           // Şarkı listesi
  queueIndex: 0,       // Şu anki index
  playContext: {
    type: 'playlist',  // playlist|album|genre
    id: 123,
    name: 'Chill Vibes'
  }
}

Queue Monitor (10 saniye)

// player-core.js:3037
startQueueMonitor() {
  setInterval(() => {
    const remaining = queue.length - queueIndex;
    console.log(`Queue Check: ${remaining} songs`);

    if (remaining < 5) {
      this.refillQueue(); // Auto-refill
    }
  }, 10000);
}

Refill API

POST /api/muzibu/queue/refill
{
  "type": "genre",   // Context type
  "id": 3,           // Context ID
  "offset": 15,      // Skip already played
  "limit": 15        // How many to fetch
}

Response:
{
  "songs": [...],    // New songs
  "has_more": true
}

Aggressive Preload

// player-core.js:2944
aggressivePreload() {
  // Sonraki 3 şarkıyı önceden yükle
  const nextSongs = queue.slice(
    queueIndex + 1,
    queueIndex + 4
  );

  nextSongs.forEach(song => {
    this.preloadSong(song);
  });
}

Database Mapping

Central (tuufi_4ekim):
├── users
├── roles
├── permissions
├── tenants
└── domains

Tenant (tenant_muzibu_1528d0):
├── songs
├── albums
├── artists
├── playlists
├── genres
├── subscriptions
├── subscription_plans
└── user_active_sessions  ← NEW!

user_active_sessions Table

CREATE TABLE user_active_sessions (
  id BIGINT PRIMARY KEY,
  user_id BIGINT,
  session_id VARCHAR(255) UNIQUE,
  ip_address VARCHAR(45),
  user_agent TEXT,
  device_type VARCHAR(50),
  device_name VARCHAR(255),
  browser VARCHAR(100),
  platform VARCHAR(100),
  last_activity TIMESTAMP,

  INDEX (user_id),
  INDEX (session_id)
);