Yapay Zekâ Asistanları

Shopizayn'da iki tür AI asistan var:

1. Site AI Studio (/site/editor): siteni Türkçe komutlarla düzenler
2. Canlı Destek AI: ürün/sipariş/fatura konularında soruları yanıtlar

Bu sayfa AI Studio'nun nasıl çalıştığını ve nasıl etkili kullanılacağını anlatır.

AI Studio Nasıl Çalışır?

Her tenant için ayrı bir storefront-template klonu tutuluyor (sunucuda /root/Shopizay/tenant-projects/<tenant-id>/<workspace>/). Sen mesaj yazınca:

1. Mesaj Claude Code SDK'ya gönderilir, system prompt'a tenant context'i eklenir.
2. Claude Read/Glob/Grep araçlarıyla ilgili dosyaları okur (şablonun src/components/, src/app/ altında).
3. Edit aracıyla değişikliği yapar.
4. Vite HMR otomatik tetiklenir, iframe yenilenir, sonucu görürsün.

Yani AI gerçekten kodu düzenliyor — wrapped layer değil. Bu nedenle:

• ✅ Karmaşık değişiklikleri tek prompt'ta yapabilir
• ✅ Yapay zekânın "vizyon"u var (önceki dosya içeriklerini okuyor)
• ⚠ Bazen yanlış dosyayı düzeltiyor — net açıklama yapmak gerek

Etkili Prompt Yazımı

Spesifik Ol

Kötü	İyi
"Site daha güzel olsun"	"Hero arka planına soft pembe gradient ekle, başlığı 4xl yap"
"Ürün kartları"	"Ürün kartlarına hover'da 4px translate-up ve shadow-lg geçişi"

Element Picker Kullan

Bir butonu, başlığı, kartı düzenlemek istiyorsan 🖱 Eleman Seç butonunu aç → iframe'de elementi tıkla → composer'a chip olarak eklenir. Sonra:

Bu butonu yeşil yap, "Hemen Al" yazsın.

AI elementi otomatik bulur (CSS class + DOM yolu).

Renk Paleti

Hex değerleri ile:

Primary rengi #2D6A4F (orman yeşili) yap, secondary #FFB703 (sıcak sarı). Tüm CTA butonları primary, link'ler secondary kullansın.

Tipografi

Google Fonts isimleriyle:

Başlık fontunu Playfair Display'e çevir, gövde IBM Plex Sans. Header ve hero başlıklarına özel tracking-tight ekle.

Bölüm Ekleme

Yeni section eklerken konum + içerik tipi + stil belirt:

Hero'nun altına "Müşteri Yorumları" bölümü ekle. 3 sütun grid, her kartta 5 yıldız, müşteri ismi, kısa yorum (2-3 cümle), profil resmi yuvarlak. Arka plan beyaz, kartlar gri border, hover'da yukarı translate.

Sınırlamalar

Plan-bazlı Limit

Plan	AI Promptu
Trial / yok	Günde 3
Esnaf	Saatte 5
Pro	Sınırsız

Limit aşılınca next reset'e kadar bekleyeceksin. Yoğun lansman dönemi için Pro önerilir.

Yapamayacağı Şeyler

• ❌ Backend kodu değiştirmek (tenant izolasyonu için)
• ❌ Yeni paket kurmak (pnpm add ... çalıştıramaz)
• ❌ Veritabanına yazmak (ürün/sipariş AI Studio dışında yönetilir)
• ❌ Üçüncü parti API entegrasyonu (PayTR, Stripe vs.) — admin tarafı

Ne Yapabilir?

• ✅ Tüm front-end (TSX/CSS/HTML) düzenlemesi
• ✅ Yeni component / section ekleme
• ✅ Tasarım sistemi (Tailwind config, design tokens)
• ✅ İçerik düzenleme (statik metinler, ürün kartları, hero CTA)
• ✅ Layout / responsive davranış
• ✅ Animasyon (Framer Motion / CSS keyframes)

Yaygın Sorular

Soru: AI yanlış dosyayı değiştirdi. Mesaja "Az önceki değişikliği geri al, X dosyasında Y yap" diye netleştir. Yakında otomatik undo butonu gelecek.

Soru: Çok yavaş yanıt veriyor. İlk birkaç prompt'ta workspace cold-start (~30sn klon + install). Sonra ~10-30 saniye bir yanıt normal. Promptun büyüklüğüne bağlı.

Soru: "Workspace başlatılamadı" hatası alıyorum.

1. Trial / abonelik aktif mi? (/billing kontrol)
2. Sayfayı yenile, tekrar dene
3. 5 dakikada çözülmezse destek@shopizayn.com

Soru: Kendi koduma erişim verebilir miyim? Şu an no — her tenant için ayrı klon tutuluyor, doğrudan dosya erişimi açmıyoruz. Kurumsal pakette dışa aktarma (zip indir) seçeneği var.

Soru: Sohbet geçmişim ne kadar saklanır? Konuşma geçmişin son 30 gün saklanır. Manuel sıfırlamak için "Sohbeti sıfırla" butonu — workspace dosyaları korunur.