🛠️ Yedek Parça Ürünleri - Büyük Güncelleme Planı

📅 Tarih: 2025-12-03 00:30 | 🎯 Tenant: ixtif.com (Tenant 2) | 📦 Kapsam: 690 Yedek Parça Ürünü

📊 Durum Analizi

690
Toplam Yedek Parça Ürünü
688
FAQ Eksik (%99.7)
688
Excerpt Eksik (%99.7)
100
Alt Kategori

⚠️ Kritik Sorunlar

1. Görseller Silindi: Body içindeki görseller (hero collection hariç) silinmiş. Görsel yokken sticky kolon boş duruyor.

2. FAQ & Excerpt Eksik: Neredeyse tüm yedek parça ürünlerinde FAQ ve kısa açıklama yok. SEO ve kullanıcı deneyimi zayıf.

3. Layout Sorunu: Sticky kolonun içinde görsel olmadığı için boş alan oluşuyor.

Kategori Yapısı: Yedek Parça (ID: 7) ana kategorisi altında 100 alt kategori var. Örnek: Lastik Jant Teker (ID: 8), Motor Grubu (ID: 9), Çatal/Ataşman (ID: 10), Elektrik/Elektronik (ID: 16), Ampul (ID: 74), vb.

🎯 3 Ana Görev

Görev 1: Görsel Alanını Kaldır Yüksek Öncelik

📍 Sorun

Body içindeki görseller silinmiş. Sticky kolonun içinde görsel alanı var ama gösterecek görsel yok. Bu durumda kolon boş kalıyor ve sayfa düzeni bozuk görünüyor.

✅ Çözüm

Yedek parça ürünlerinde sticky kolonun içindeki görsel alanını tamamen kaldır. Yazı alanını full genişliğe çıkar. Böylece görsel olmasa bile sayfa düzgün görünür.

🔧 Teknik Yaklaşım

1. Kategori Kontrolü: ShopController'da yedek parça kategorilerini tespit et (ID: 7 ve alt kategorileri).

2. View Parametresi: View'a $isYedekParca = true parametresi gönder.

3. Blade Şartı: show.blade.php içinde:

@if ($isYedekParca) {{-- Yedek parça: Görsel yok, yazı full genişlik --}} <div class="lg:col-span-3"> {{-- Tüm içerik burada --}} </div> @else {{-- Normal ürün: lg:col-span-2 + lg:col-span-1 (sticky) --}} <div class="lg:col-span-2">...</div> <div class="lg:col-span-1">...</div> @endif

Görev 2: FAQ Oluştur ve Ekle Yüksek Öncelik

📍 Sorun

688 üründe FAQ yok (%99.7). FAQ olmadan:
• SEO zayıf (Google Rich Snippets yok)
• Kullanıcı soruları cevapsız
• Satış dönüşümü düşük

✅ Çözüm: OpenAI ile Oto-Oluşturma

Her ürün için OpenAI kullanarak ürün başlığı ve kategorisine özel FAQ oluştur.

🔧 FAQ Üretim Süreci

1. Prompt Hazırla:

"[ÜRÜN BAŞLIĞI] için Türkçe SSS (Sıkça Sorulan Sorular) oluştur. Kategori: [KATEGORİ] Sektör: Forklift yedek parçaları 5 adet soru-cevap oluştur: 1. Teknik özellikler 2. Uyumluluk / Hangi modellerde kullanılır? 3. Garanti süresi 4. Teslimat süresi 5. Montaj / Kurulum JSON formatında döndür: [ {\"question\": \"...\", \"answer\": \"...\"}, ... ]"

2. OpenAI API Çağrısı: GPT-4 veya GPT-3.5-turbo kullan
3. JSON Parse: Dönen JSON'u parse et
4. Database Kaydet: faq_data JSON fieldine kaydet

⚡ Toplu İşlem Stratejisi

Yöntem 1: Queue Job (Önerilen)
• Her ürün için job kuyruğa at
• Saniyede 1-2 ürün işle (rate limiting)
• Toplam süre: ~6-12 saat

Yöntem 2: Batch API
• 50'şer ürün grupla
• Batch API ile toplu gönder
• Daha hızlı ama hata yönetimi zor

Görev 3: Excerpt (Kısa Açıklama) Ekle Yüksek Öncelik

📍 Sorun

688 üründe excerpt (short_description) yok. Excerpt olmadan:
• Google arama sonuçlarında açıklama eksik
• Ürün listelerinde tanım yok
• Meta description boş

✅ Çözüm: OpenAI ile Oto-Oluşturma

Her ürün için 150-200 karakter arası kısa, özlü açıklama oluştur.

🔧 Excerpt Üretim Süreci

Prompt Örneği:

"[ÜRÜN BAŞLIĞI] için Türkçe kısa ürün açıklaması yaz. Kategori: [KATEGORİ] Gereksinimler: - 150-200 karakter - SEO dostu - Ürünün ne olduğunu ve ne için kullanıldığını açıkla - Teknik terimler kullan - Sadece metni döndür, ek format yok"

Örnek Çıktı:
"15x4-1/2-8 ebadında siyah dolgu forklift lastiği. Yüksek dayanıklılı, uzun ömürlü. Elektrikli forkliftler için ideal. Hızlı teslimat."

⚡ FAQ ile Birleştir

Excerpt ve FAQ oluşturmayı aynı API çağrısında birleştirerek maliyet ve süreyi azalt.

{ "excerpt": "...", "faq": [ {"question": "...", "answer": "..."}, ... ] }

🚀 Uygulama Planı

  1. Kategori Fonksiyonu Yaz: Yedek parça kategorilerini tespit eden helper fonksiyon oluştur.
  2. ShopController Güncelle: show() metoduna $isYedekParca parametresi ekle.
  3. View Dosyasını Güncelle: show.blade.php içinde sticky kolonu kaldır (yedek parça için).
  4. OpenAI Service Oluştur: FAQ ve excerpt üretimi için servis sınıfı yaz.
  5. Queue Job Oluştur: Toplu işlem için job sınıfı hazırla.
  6. Test Et: 5-10 ürünle test yap, sonuçları kontrol et.
  7. Toplu Çalıştır: 690 ürünün tamamı için job'u başlat.
  8. Doğrulama: FAQ ve excerpt'lerin kaydedildiğini kontrol et.
  9. Cache Temizle: OPcache, view cache, response cache temizle.
  10. Final Test: Birkaç ürün sayfasını açıp layout ve içeriği kontrol et.

💰 Maliyet & Süre Tahmini

$3-5
OpenAI Maliyeti (GPT-3.5)
6-12 saat
Toplam İşlem Süresi
2-3 saat
Geliştirme Süresi
Not: Rate limiting nedeniyle saniyede 1-2 ürün işlenebilir. 690 ürün için toplam ~6-12 saat süre. Background job ile çalıştırılacağı için kullanıcı beklemez.

⚠️ Riskler ve Önlemler

Risk 1: OpenAI API Hatası

Önlem: Try-catch ile hataları yakala. Hata olan ürünleri log'a yaz, sonra tekrar işle.

Risk 2: Rate Limiting

Önlem: Job'a delay ekle (1-2 saniye). Retry mekanizması kur.

Risk 3: JSON Cast Sorunu

Önlem: Kaydederken JSON formatını doğrula. json_encode() kullan.

Risk 4: Layout Bozulması

Önlem: View değişikliklerini test ortamında dene. Rollback planı hazırla.

✅ Başarı Kriterleri