citrus/docs/SEEDER_USAGE.md

Veritabanı Seeder Kullanım Kılavuzu

Genel Bakış

Sistemde 2 ana seeder bulunmaktadır:

1. PageSeeder - Örnek sayfalar (home, about, services, contact, pricing)
2. SettingSeeder - Site ayarları ve yapılandırmaları

Seeder'ları Çalıştırma

Tüm Seeder'ları Çalıştırma

php artisan db:seed

Sadece Page Seeder'ı Çalıştırma

php artisan db:seed --class=PageSeeder

Sadece Setting Seeder'ı Çalıştırma

php artisan db:seed --class=SettingSeeder

Fresh Migration + Seed (Dikkat: Tüm veriler silinir!)

php artisan migrate:fresh --seed

---

PageSeeder İçeriği

Oluşturulan Sayfalar

1. Anasayfa (slug: home)

   • is_homepage: true
   • template: home
   • Bloklar: Hero, Features, Stats, CTA
   • Durum: published

2. Hakkımızda (slug: about)

   • template: generic
   • Bloklar: Hero, Features
   • Durum: published

3. Hizmetlerimiz (slug: services)

   • template: generic
   • Bloklar: Hero, Features (6 hizmet)
   • Durum: published

4. İletişim (slug: contact)

   • template: generic
   • Bloklar: Hero, Contact Form
   • Durum: published

5. Fiyatlandırma (slug: pricing)

   • template: generic
   • Bloklar: Hero, Pricing (3 paket)
   • Durum: published
   • show_in_menu: false (menüde görünmez)

Blok Yapısı Örneği

{
  "sections": [
    {
      "type": "hero",
      "data": {
        "badge": "YENİ PLATFORM",
        "title": "Modern ve Çok Amaçlı Web Çözümleri",
        "subtitle": "...",
        "primary_button_text": "Hemen Başla",
        "primary_button_url": "#features"
      }
    },
    {
      "type": "features",
      "data": {
        "section_title": "Neden Truncgil Citrus?",
        "features": [...]
      }
    }
  ]
}

---

SettingSeeder İçeriği

Gruplar ve Ayarlar

Grup	Açıklama	Örnek Ayarlar
general	Genel site ayarları	site_name, site_description, logo, favicon
theme	Tema ve renk ayarları	primary_color, secondary_color, custom_css
localization	Dil ve bölge ayarları	timezone, currency, date_format
email	E-posta sunucu ayarları	mail_host, mail_port, mail_from
social	Sosyal medya linkleri	facebook, instagram, linkedin, twitter
layout	Frontend layout ayarları	default_meta_title, logo_path, favicon_path
seo	SEO ve analitik ayarları	google_analytics, meta_keywords
security	Güvenlik ayarları	max_login_attempts, password_rules
upload	Dosya yükleme ayarları	max_size, allowed_types, image_quality
notification	Bildirim ayarları	email_enabled, sms_enabled
cache	Cache ayarları	cache_driver, cache_duration
payment	Ödeme ayarları	default_gateway, test_mode
api	API ayarları	rate_limit, auth_method
logging	Log ayarları	log_level, retention_days
performance	Performans ayarları	query_cache, cdn_enabled
integration	3. parti entegrasyonlar	recaptcha, stripe, paypal

Frontend için Kritik Ayarlar

// Layout için
'default_meta_title' => 'Truncgil Citrus - Modern Web Çözümleri'
'default_meta_description' => 'Yenilikçi teknoloji çözümleri...'
'default_meta_image' => 'assets/img/demos/f1.png'
'logo_path' => 'assets/img/truncgil-yatay.svg'
'favicon_path' => 'assets/img/favicon.ico'

// Sosyal medya
'social_links' => {
  'facebook': 'https://facebook.com/',
  'instagram': 'https://instagram.com/',
  'linkedin': 'https://linkedin.com/',
  'twitter': 'https://twitter.com/'
}

---

Seeder Sonrası Kontrol

1. Veritabanı Kontrolü

# Pages tablosunu kontrol et
php artisan tinker
>>> App\Models\Page::count()
=> 5

>>> App\Models\Page::where('status', 'published')->count()
=> 5

>>> App\Models\Page::where('is_homepage', true)->first()->slug
=> "home"

2. Setting Kontrolü

php artisan tinker
>>> App\Models\Setting::where('key', 'default_meta_title')->first()->value
=> "Truncgil Citrus - Modern Web Çözümleri"

>>> App\Models\Setting::where('key', 'social_links')->first()->value
=> "{\"facebook\":\"https://facebook.com/\",...}"

3. Frontend Kontrolü

• https://citrus.truncgil.com/ → Anasayfa (home template + bloklar)
• https://citrus.truncgil.com/about → Hakkımızda
• https://citrus.truncgil.com/services → Hizmetler
• https://citrus.truncgil.com/contact → İletişim
• https://citrus.truncgil.com/pricing → Fiyatlandırma

---

Özelleştirme

Yeni Sayfa Ekleme

database/seeders/PageSeeder.php içinde $pages dizisine ekleyin:

[
    'title' => 'Portfolyo',
    'slug' => 'portfolio',
    'template' => 'generic',
    'status' => 'published',
    'show_in_menu' => true,
    'sort_order' => 6,
    'published_at' => now(),
    'sections' => [
        // Bloklar...
    ],
]

Var Olan Sayfayı Güncelleme

Seeder updateOrCreate kullanıyor, slug'a göre günceller:

php artisan db:seed --class=PageSeeder

Aynı slug varsa güncellenir, yoksa yeni kayıt oluşturulur.

Setting Değerlerini Değiştirme

database/seeders/SettingSeeder.php içinde ilgili value alanını değiştirin ve çalıştırın:

php artisan db:seed --class=SettingSeeder

---

Sorun Giderme

"Class not found" Hatası

composer dump-autoload
php artisan clear-compiled
php artisan config:clear
php artisan db:seed

"Table doesn't exist" Hatası

php artisan migrate
php artisan db:seed

Seeder Çalışmıyor

# Verbose mode ile hata detaylarını görün
php artisan db:seed --class=PageSeeder -vvv

Fresh Start (Tüm veriyi sıfırlama)

php artisan migrate:fresh --seed

⚠️ Uyarı: Bu komut tüm tabloları siler ve yeniden oluşturur!

---

Son Güncelleme: {{ now()->format('d.m.Y H:i') }}