WidgetManagement Modülü

widget_by_id(id)              // ID'ye göre render
widget_by_slug(slug, params)   // Slug'a göre, params ile
widgets_by_position(position)  // Pozisyon'a göre render
parse_widget_shortcodes(html)  // Shortcode'ları işle
widget_cached(id, ttl, params) // Cache ile render
module_widget_by_id(id)        // Module widget render
module_widgets_by_module(modId)// Module'daki tüm module widget'ları
widget_file_by_id(id)          // File widget render

Singletonized: app('widget.service')

Temel metodlar:
- getAllWidgets()              → Tüm widget'lar
- getActiveWidgets()           → Aktif widget'lar
- getWidgetsByType(type)       → Türe göre
- getWidgetsForModule(modId)   → Modüle göre
- getTenantWidgets(position)   → Kiracı widget'ları
- renderWidgetsInPosition()    → Pozisyon'daki widget'ları render
- renderSingleWidget()         → Tekil widget render (cache ile)
- processWidget()              → Widget HTML işleme
- renderWidgetHtml()           → Handlebars şablon işleme
- clearWidgetCache()           → Cache temizle

Cache stratejisi:
- Key format: widget_{tenantId}_widget_{widgetId}
- TTL: 1440 dakika (24 saat)
- Kullanım: settings, CSS/JS, item'ler değişirse otomatik sıfırlanır

Sorumlulukları:
- processVariables()           → {{title}} gibi değişkenleri değiştir
- processItems()               → {{#each items}} döngüleri işle
- processModuleData()          → Module verilerini Handlebars'la işle
- processConditionalBlocks()   → {{#if condition}} blokları işle

Template Syntax:
- Değişkenler: {{variable}}, {{widget.title}}, {{items.0.name}}
- Koşullar: {{#if condition}}...{{/if}}
- Döngüler: {{#each items}}...{{/each}}
- Handlebars desteği: LitHTML/Handlebars.js

- getItemsForWidget()  → Widget'ın item'lerini al
- addItem()            → Item ekle (auto UUID, is_active=true)
- updateItem()         → Item güncelle
- deleteItem()         → Item sil
- reorderItems()       → Item'leri sırala

Desteklenen syntaxlar:
[[widget:slug param1=val1 param2=val2]]
[[widget:slug]]İçerik[[/widget:slug]]
[[module:moduleId]]
[[file:fileId]]

Örnek:
[[widget:hero title="Başlık" subtitle="Alt başlık"]]
[[widget:cards]]
  [[widget:card title="Card 1"]]
[[/widget:cards]]

Prefix: /admin/widgetmanagement
Middleware: ['admin', 'tenant']

Public (view):
- GET / → Widget listesi
- GET /gallery → Galeri
- GET /items/{tenantWidgetId} → Item listesi
- GET /preview/template/{widgetId} → Widget önizlemesi
- GET /preview/instance/{tenantWidgetId} → Instance önizlemesi

Protected (root role):
- GET /manage/{id?} → Widget editör
- GET /code-editor/{id} → Kod editör
- GET /file-widgets → File widget'ları
- GET /modules → Module widget'ları

Protected (update permission):
- GET /settings/{tenantWidgetId} → Widget ayarları
- GET /manage/item/{tenantWidgetId}/{itemId} → Item editör
- POST /form-builder/{widgetId}/save/{schemaType} → Schema kaydet

Preview endpoints:
- GET /preview/embed/{tenantWidgetId}
- GET /preview/embed/json/{tenantWidgetId}
- GET /api/module/{moduleId}

Hero widget'ları:
- blocks/hero/simple → Basit başlık
- blocks/hero/hero-1 → İmaj ile
- blocks/hero/ixtif-hero → İxtif özel

Layout widget'ları:
- blocks/layout/one-column → 1 kolon
- blocks/layout/two-columns → 2 eşit
- blocks/layout/three-columns → 3 eşit
- blocks/layout/four-columns → 4 eşit
- blocks/layout/masonry-grid → Masonry
- blocks/layout/asymmetric-grid → Asimetrik
- blocks/layout/sidebar-main-sidebar → Kenar çubuğu

Card widget'ları:
- blocks/cards/basic → Basit kartlar
- blocks/cards/grid → Grid düzeni

Form widget'ları:
- blocks/form/contact-form → İletişim formu
- blocks/form/contact-assistant → AI asistan formu
- blocks/form/muzibu-contact → Muzibu özel

Module widget'ları:
- blocks/modules/portfolio/list → Portfolio listesi
- blocks/modules/portfolio/detail → Portfolio detay
- blocks/modules/page/home → Ana sayfa
- blocks/modules/page/recent → Yeni sayfalar
- blocks/modules/announcement/list → Duyuru listesi

Diğer:
- blocks/testimonials/basic → Testimoniallar
- blocks/features/basic → Özellikler
- blocks/media/image → Resim
- blocks/content/hero → İçerik
- blocks/content/text → Metin

TenantWidget değişirse:
- update() → clearWidgetCache() çağrılır
- delete() → clearWidgetCache() çağrılır
- Livewire save → clearWidgetCache()

WidgetItem değişirse:
- create/update/delete → clearWidgetCache()

Position değişirse:
- TenantWidget::where('position', $pos) → Cache temizle

Settings değişirse:
- TenantWidget.update(['settings' => ...]) → Cache temizle

Widget render sırasında:
- WidgetService::$loadedCssFiles[] → Benzersiz dosyaları topla
- WidgetService::$loadedJsFiles[] → Benzersiz dosyaları topla
- Sayfanın footer'ında:
  {{ WidgetService::getStylesOutput() }}
  {{ WidgetService::getScriptsOutput() }}

Avantaj:
- Tekrarlanan CSS/JS yüklenmez
- Performance optimize edilir
- Sayfa yükleme süresi azalır

Widget Model getMediaDisk() metodu:
- Tenant context varsa → tenant disk kullanılır
- Central context varsa → public disk kullanılır
- Disk path: storage/app/public/
- URL: /storage/tenant{tenantId}/ (tenant context)

Örnek:
- Merkezi: /storage/widgets/hero-bg.jpg
- Tenant 2 (ixtif): /storage/tenant2/widgets/hero-bg.jpg
- Tenant 1001 (muzibu): /storage/tenant1001/widgets/hero-bg.jpg

Admin Paneli
    ↓
WidgetComponent.createInstance(widgetId)
    ↓
Widget::find(widgetId) ← Merkezi DB'den şablonu getir
    ↓
TenantWidget::create([
    'widget_id' => $widgetId,
    'order' => $maxOrder + 1,
    'settings' => ['title' => $widget->name, 'unique_id' => UUID]
])
    ↓
Database: tenant_{kiracı}.tenant_widgets INSERT
    ↓
clearWidgetCache(tenant()->id, null) ← Kiracının tüm position cache'ini temizle
    ↓
Frontend'de @widgets('position') çağrılırsa:
    ↓
Yeni TenantWidget render edilir ✅

Admin: /admin/widgetmanagement/manage/item/{tenantWidgetId}
    ↓
WidgetItemManageComponent.save()
    ↓
WidgetItemService.addItem(tenantWidgetId, {
    'title' => 'Yeni Card',
    'description' => '...',
    'image' => 'file.jpg'
})
    ↓
1. unique_id OTOMATIK oluştur (UUID)
2. is_active = true (VARSAYILAN)
3. order = max(order) + 1
4. Database: tenant_{kiracı}.widget_items INSERT
    ↓
5. clearWidgetCache(tenant()->id, tenantWidgetId)
    ↓
Frontend'de @widget(tenantWidgetId) çağrılırsa:
    ↓
    1. Cache miss (temizlendi)
    2. TenantWidget::with('widget', 'items').find(tenantWidgetId)
    3. Widget.content_html (şablon)
    4. WidgetItems processItems() ile {{#each items}}...{{/each}} işle
    5. New item görünür ✅

Blade: @widget(5)
    ↓
Helper: widget_by_id(5)
    ↓
Cache key: widget_{tenantId}_widget_5
    ↓
Cache varsa? EVET → Return (24 saat eski veri)
Cache miss? → Devam et
    ↓
TenantWidget::with('widget', 'items').find(5)
    ↓
TenantWidget.is_custom == true?
    ↓
    EVET: custom_html render et
    HAYIR:
        1. Widget.content_html al
        2. WidgetItems varsa: renderService.processItems()
        3. Settings varsa: renderService.processVariables()
        4. Module widget ise: getData() → renderService.processModuleData()
        5. CSS/JS dosyaları ekle
    ↓
Cache'e kaydet (TTL: 1440 dakika)
    ↓
HTML çıktı + CSS/JS global array'e ekle
    ↓
Page footer'da:
    WidgetService::getStylesOutput() →