Muzibu.com Sistem Analizi

📋 Hızlı Özet

Platform Tipi

Multi-Tenant SaaS

Framework

Laravel 12

Modül Sayısı

29 Modül

Ana Sektör

Müzik Streaming

📝 Basit Anlatım (Herkes İçin)

Platform Nedir?

Muzibu.com, çok kiracılı (multi-tenant) bir web platformudur. Bunu bir apartman binası gibi düşünebilirsiniz: Tek bir bina (sistem) var ama içinde farklı daireler (kiracılar/tenant'lar) bulunuyor. Her daire kendi bağımsız alanına sahip ama altyapı ortak kullanılıyor. Bu sayede her müşteri kendi web sitesini bu platform üzerinde yönetebiliyor.

Ana Özellikler

🎵 Müzik Streaming

Spotify benzeri bir müzik platformu. Şarkılar, albümler, çalma listeleri, sanatçılar ve sektör bazlı kategoriler var. Müzikler güvenli şekilde şifrelenmiş olarak akış yapıyor (HLS encryption).

🛒 E-Ticaret

Online mağaza sistemi. Ürün satışı, sepet yönetimi, ödeme işlemleri ve sipariş takibi yapılabiliyor.

🤖 Yapay Zeka Asistanı

AI destekli sohbet sistemi. Kullanıcılar AI ile konuşarak playlist oluşturabilir, müzik önerileri alabilir.

📝 Blog ve İçerik Yönetimi

Blog yazıları, sayfalar ve portföy içerikleri yönetilebiliyor. SEO optimizasyonu ile arama motorlarında üst sıralarda çıkmaya yardımcı oluyor.

Kiracılar (Tenant'lar)

Sistemde şu an 3 ana kiracı bulunuyor:

1. Tuufi.com (Merkezi Yönetim)

Ana yönetim paneli. Tüm kiracıları buradan yönetiyorsunuz.

2. İxtif.com (Endüstriyel Ekipman)

Forklift ve transpalet gibi endüstriyel ekipmanların satıldığı site.

3. Muzibu.com (Müzik Platformu)

Müzik streaming platformu. Şarkı, albüm, playlist sistemi var.

Neden Önemli?

✓ Tek kodla çok site: Aynı kodu kullanarak farklı müşterilere farklı siteler sunabiliyorsunuz.
✓ Güvenli veri izolasyonu: Her kiracının verisi ayrı veritabanında tutuluyor, birbirine karışmıyor.
✓ Modüler yapı: İstediğiniz özelliği açıp kapatabilirsiniz. Bir müşteri e-ticaret istiyor, diğeri sadece blog istiyor - her ikisini de karşılayabiliyorsunuz.
✓ Gelişmiş teknolojiler: Modern ve hızlı çalışan araçlar kullanılmış. Sistem performanslı ve ölçeklenebilir.

🔧 Teknik Detaylar (Geliştiriciler İçin)

Teknoloji Stack

Backend

• Laravel 12
• PHP 8.2+
• Livewire 3.5+
• Stancl/Tenancy 3.8

Frontend

• Tailwind CSS v4
• Alpine.js 3.x
• Tabler.io (Admin)
• Bootstrap 5

Infrastructure

• Redis 7+
• MySQL 8.0+
• Meilisearch
• Node.js 20+

Modül Listesi (29 Modül)

Core Modules

• TenantManagement
• UserManagement
• SettingManagement
• ThemeManagement
• ModuleManagement

Content Modules

• Page
• Blog
• Portfolio
• Announcement
• MediaManagement
• MenuManagement
• WidgetManagement

E-Commerce

• Shop
• Cart
• Payment
• Coupon
• Subscription

Feature Modules

• Muzibu (Music)
• AI
• Search
• Favorite
• ReviewSystem

Utility Modules

• Mail
• SeoManagement
• LanguageManagement
• Service
• Studio

Proje Yapısı

/var/www/vhosts/muzibu.com/httpdocs/
├── app/                      # Core application code
│   ├── Models/                 (18 models)
│   ├── Http/Controllers/
│   ├── Livewire/
│   ├── Services/
│   └── Helpers/
├── Modules/                  # 29 independent modules
│   ├── Muzibu/                 (Music streaming)
│   ├── Shop/                   (E-commerce)
│   ├── AI/                     (AI Assistant)
│   └── ...
├── resources/
│   ├── views/
│   │   └── themes/             (Theme files)
│   ├── css/
│   └── js/
├── public/
│   ├── css/                    (Compiled tenant CSS)
│   └── readme/                 (Documentation)
├── storage/                 (2.1M)
├── vendor/                  (273M - Composer packages)
└── node_modules/            (272M - NPM packages)

Multi-Tenant Mimari

Kullanılan Package: stancl/tenancy 3.8

Central Database (tuufi_4ekim)

→ tenants
→ domains
→ users (global)
→ roles & permissions
→ subscriptions
→ invoices

Tenant Databases (tenant_X)

→ pages, blogs, products
→ songs, albums, playlists
→ media, settings
→ seo_meta
→ menus, widgets

Önemli Composer Paketleri

Core Packages

• laravel/framework - Laravel 12
• livewire/livewire - Livewire 3.5+
• nwidart/laravel-modules - Module system
• stancl/tenancy - Multi-tenancy

Media & Files

• spatie/laravel-medialibrary
• intervention/image
• barryvdh/laravel-dompdf
• james-heinrich/getid3 - Audio metadata

Features

• openai-php/client - AI integration
• laravel/scout + meilisearch
• simplesoftwareio/simple-qrcode
• spatie/laravel-permission

Dev Tools

• laravel/horizon - Queue monitoring
• laravel/telescope - Debug tool
• laravel/pulse - Performance
• barryvdh/laravel-debugbar

Muzibu Modülü - Veritabanı Tabloları

Location: Modules/Muzibu/database/migrations/tenant/

• muzibu_artists - Sanatçılar
• muzibu_genres - Müzik türleri
• muzibu_albums - Albümler
• muzibu_songs - Şarkılar
• muzibu_sectors - Sektör kategorileri
• muzibu_playlists - Çalma listeleri
• muzibu_radios - Radyo kanalları
• muzibu_playlist_song - Playlist-Song pivot
• muzibu_song_plays - Dinlenme istatistikleri

API Endpoints

File: routes/api.php (18,929 bytes)

Auth & Session

POST /api/auth/login
GET /api/auth/check-session
GET /api/auth/active-devices
POST /api/auth/terminate-device

Muzibu

GET /api/muzibu/songs/{id}/stream
GET /api/muzibu/playlists
GET /api/muzibu/albums
POST /api/muzibu/favorites/toggle

AI Assistant

POST /api/ai/v1/assistant/chat

Build Scripts

# Production build
npm run prod                  # All tenant CSS + Laravel Mix

# Tenant-specific CSS
npm run css:all               # Build all tenant CSS
npm run css:muzibu            # Build tenant-1001.css
npm run css:ixtif             # Build tenant-2.css

# Development
npm run dev                   # Watch mode
composer dev                  # Start all services (server+queue+vite)

Güvenlik Özellikleri

✓ HLS Encryption: Müzik dosyaları şifrelenmiş HLS streaming ile korunuyor
✓ Device Limit: Cookie-based cihaz tanıma ve LIFO logout mekanizması
✓ Distributed Lock: Race condition koruması (Cache::lock)
✓ Permission System: Spatie Laravel Permission ile rol tabanlı yetkilendirme
✓ Rate Limiting: API ve web route'ları için throttle

🚀 Son Güncellemeler

v6.0.0 - Device/Session Limit System (22 Aralık 2025)

• Cookie-based cihaz tanıma sistemi
• LIFO mekanizması: Yeni cihaz girişinde eski otomatik çıkış
• Distributed Lock ile race condition koruması
• 33 dosya değiştirildi, 1,303 ekleme, 718 silme

v5.9.0 - Tailwind v4 Migration (21 Aralık 2025)

• Tailwind CSS v3 → v4.1.18 geçişi
• Tenant-aware CSS build sistemi
• Homepage yeniden tasarım - modern card layout
• Performance optimizasyonu

v5.8.0 - AI & Security Updates (Aralık 2025)

• AI Chat dinamik context sistemi (ben/biz ayrımı)
• HLS streaming güvenlik güncellemeleri
• Console log cleanup (110+ gereksiz log silindi)
• Premium access & toast system düzeltmeleri

⚡ Performans Araçları

Monitoring

• Laravel Horizon (Queue)
• Laravel Telescope (Debug)
• Laravel Pulse (Performance)

Caching

• Redis (Session + Cache)
• OPCache (PHP)
• Response Cache

Search

• Meilisearch
• Laravel Scout
• Full-text indexing

💡 Öneriler ve Notlar

✅ Güçlü Yanlar

• Modern ve güncel teknolojiler (Laravel 12, Tailwind v4)
• Modüler yapı sayesinde kolay genişletilebilir
• Multi-tenant mimari ile tek sistemde çoklu site yönetimi
• Kapsamlı güvenlik önlemleri (HLS encryption, device limit, rate limiting)
• İyi dokümante edilmiş (CLAUDE.md, README.md, HTML raporları)

📌 Dikkat Edilmesi Gerekenler

• Migration işlemleri: Veritabanı değişikliklerinde 3 aşamalı onay sistemi kullanılmalı
• Dosya izinleri: Her dosya oluşturma/düzenleme sonrası chown tuufi.com_:psaserv gerekli
• Cache temizleme: Değişiklik yansımadığında "Nuclear Cache" prosedürü uygulanmalı
• Tenant awareness: Kod yazarken hangi tenant için olduğu kontrol edilmeli
• CSS build: Tailwind class eklendiğinde safelist'e eklenmeli ve npm run prod çalıştırılmalı

⚠️ Yasak Komutlar

Bu komutlar ASLA çalıştırılmamalı (veri kaybı riski!):

• php artisan migrate:fresh
• php artisan db:wipe
• php artisan media-library:clear
• rm -rf storage/
• redis-cli FLUSHALL

📊 Proje İstatistikleri

29

Modül

~27k

Satır Kod (Models)

545M

Dependencies

3

Aktif Tenant