Sorun Giderme ve SSS

CopyPatch v2 entegrasyonlarında karşılaşabileceğiniz yapılandırma, rota yönlendirme, yetkilendirme ve veritabanı durumlarını hızla teşhis edin.

1. CLI ile Hızlı Teşhis

Yerel yapılandırmanızı, ortam değişkenlerinizi ve veritabanı bağlantı sağlığınızı test etmenin en hızlı yolu doctor komutudur:

Terminal

# Çalışma zamanı teşhis komutunu çalıştırın
npx copypatch doctor

2. Hata Kodları Başvuru Tablosu

Hata Kodu	HTTP Durumu	Olası Neden	Çözüm Adımı
`ORIGIN_REJECTED`	`403 Forbidden`	İsteğin `Origin` başlığı uygulamanın host etki alanıyla tam olarak eşleşmiyor.	İsteklerin aynı kökenden (same-origin) yapıldığından emin olun. Harici proxy veya CORS ayarlarını kaldırın; uygulamayı doğrudan host adresi üzerinden açın.
`CSRF_FAILED`	`403 Forbidden`	`x-copypatch-csrf` başlığı eksik, geçersiz veya süresi dolmuş.	`?copypatch=1` ile sayfayı yenileyip yeniden giriş yapın. Özel bir `authAdapter` kullanıyorsanız, adaptörün `verifyMutation` fonksiyonunu denetleyin.
`UNAUTHORIZED`	`401 Unauthorized`	Oturum çerezi eksik, geçersiz veya zaman aşımına uğramış.	Parola modalı üzerinden oturum açın veya ana uygulamanızdaki kullanıcı hesabınıza giriş yapın.
`FORBIDDEN`	`403 Forbidden`	Kullanıcı istenen eylem için gerekli role sahip değil (taslak için `editor`, yayınlama için `publisher`).	Ana uygulamanızın kimlik doğrulama sisteminde veya adaptörünüzdeki rol tanımlamalarını kontrol edin.
`REVISION_CONFLICT`	`409 Conflict`	Siz sayfadayken başka bir ekip üyesi aktif dilde değişiklik yayınladı veya kaydetti.	En güncel metinleri yüklemek için sayfayı/anlık görüntüyü yenileyin ve düzenlemenizi veri kaybı olmadan tekrar uygulayın.
`VALIDATION_FAILED`	`400 Bad Request`	Geçersiz metin anahtarı formatı veya 64 KB yük sınırı aşıldı.	İçerik anahtarlarının noktayla ayrılmış alfa-sayısal formatta (örn. `hero.title`) olduğundan ve metinlerin düz metin olduğundan emin olun.
`STORAGE_UNAVAILABLE`	`503 Service Unavailable`	Veritabanı dosyası kilitli, dizin yazma izni yok veya PostgreSQL bağlantı havuzu yanıt vermiyor.	Migrasyonları çalıştırın (`copypatch migrate`), SQLite dizin izinlerini kontrol edin veya PostgreSQL bağlantı bilgilerinizi test edin.

3. Sık Karşılaşılan Durumlar ve Çözümleri

Düzenleme Araç Çubuğu Görünmüyor

URL sorgu parametresinin tam olarak ?copypatch=1 olduğunu teyit edin.
CopyPatchProvider sağlayıcısının ilgili bileşen ağacını kapsadığından emin olun.
Tembel yükleme sırasında bir hata oluşup oluşmadığını tarayıcınızın Geliştirici Araçları (Console) sekmesinden denetleyin.

Rota 404 Not Found Hatası Veriyor

Sunucunuzun API rotasını tam olarak /__copypatch/api/v2 adresine mount ettiğini doğrulayın.
Next.js App Router kullanıyorsanız klasör adının yüzde kodlamalı olduğundan emin olun: app/%5F%5Fcopypatch/api/v2/[...path]/route.ts.
Express kullanıyorsanız app.use('/__copypatch/api/v2', expressMiddleware(backend)) tanımının express.json() ve SPA fallback'lerinden önce yer aldığını kontrol edin.

4. Sıkça Sorulan Sorular (SSS)

CopyPatch içinde zengin metin (Rich-text / HTML) kullanabilir miyim?

Hayır. CopyPatch bilinçli olarak katı bir düz metin (plain-text) ilkesi uygular. HTML girişine izin vermek hem depolanmış XSS güvenlik riskleri yaratır hem de teknik bilgisi olmayan editörlerin sitenizin CSS ve mobil yerleşimini bozmasına neden olur.

CopyPatch'i tamamen statik bir CDN sitesinde (örn. GitHub Pages) çalıştırabilir miyim?

Statik çıktılar varsayılan yedek metinleri render edebilir; ancak salt statik bir barındırmada canlı düzenleme veya kaydetme yapılamaz. Güvenli mutasyonları işlemek ve veritabanına yazmak için Node.js, sunucusuz (serverless) veya konteyner tabanlı aktif bir sunucu çalışma zamanı gereklidir.