267 lines
7.7 KiB
Markdown
267 lines
7.7 KiB
Markdown
# 📚 Clerk Dokümantasyon İndeksi
|
||
|
||
LetsGoCappadocia uygulaması için Clerk kimlik doğrulama sistemi kurulum ve yönetim rehberleri.
|
||
|
||
---
|
||
|
||
## 🚀 Hızlı Başlangıç
|
||
|
||
### Yeni Kullanıcılar İçin (İlk Kurulum)
|
||
|
||
1. **Başlangıç:** [CLERK_QUICK_REFERENCE.md](./CLERK_QUICK_REFERENCE.md)
|
||
- ⏱️ 5 dakika
|
||
- 🎯 3 adımda kurulum
|
||
- ✅ Hızlı doğrulama
|
||
|
||
2. **Detaylı Kurulum:** [CLERK_SETUP_GUIDE.md](./CLERK_SETUP_GUIDE.md)
|
||
- ⏱️ 15 dakika
|
||
- 📖 Kapsamlı açıklamalar
|
||
- 🔒 Güvenlik en iyi uygulamaları
|
||
- 💰 Maliyet tahmini
|
||
|
||
3. **Görsel Rehber:** [CLERK_VISUAL_GUIDE.md](./CLERK_VISUAL_GUIDE.md)
|
||
- ⏱️ 20 dakika
|
||
- 📸 Ekran ekran açıklamalar
|
||
- 🎨 Hangi butona tıklayacağınızı gösterir
|
||
- ✅ Test kullanıcı oluşturma
|
||
|
||
---
|
||
|
||
## 🔧 Sorun Giderme
|
||
|
||
### Kurulum Sonrası Sorunlar
|
||
|
||
1. **Genel Sorunlar:** [CLERK_TROUBLESHOOTING.md](./CLERK_TROUBLESHOOTING.md)
|
||
- ❌ Yaygın hatalar ve çözümleri
|
||
- 🔍 Debug teknikleri
|
||
- 📊 Log analizi
|
||
|
||
2. **Kimlik Doğrulama Sorunları:** [CLERK_AUTH_ISSUES_SUMMARY.md](./CLERK_AUTH_ISSUES_SUMMARY.md)
|
||
- 🔐 Login/logout sorunları
|
||
- 👤 Profil oluşturma hataları
|
||
- 🔄 Session yönetimi
|
||
|
||
3. **JWT Token Sorunları:** [CLERK_JWT_FIX_INDEX.md](./CLERK_JWT_FIX_INDEX.md)
|
||
- 🎫 Token doğrulama hataları
|
||
- 🔄 Token yenileme sorunları
|
||
- 🛠️ JWT yapılandırması
|
||
|
||
---
|
||
|
||
## 📖 Özel Konular
|
||
|
||
### Database Senkronizasyonu
|
||
- **Rehber:** [CLERK_DATABASE_SYNC.md](./CLERK_DATABASE_SYNC.md)
|
||
- **Konu:** Clerk kullanıcıları ile Supabase profilleri senkronizasyonu
|
||
- **Ne zaman kullanılır:** Webhook sorunları, profil oluşturma hataları
|
||
|
||
### Kayıt Sorunları
|
||
- **Rehber:** [CLERK_REGISTRATION_FIX.md](./CLERK_REGISTRATION_FIX.md)
|
||
- **Konu:** Kullanıcı kaydı sırasında oluşan hatalar
|
||
- **Ne zaman kullanılır:** Sign up çalışmıyor, profil oluşmuyor
|
||
|
||
### Şifre Yönetimi
|
||
- **Rehber:** [CLERK_PASSWORD_GUIDE.md](./CLERK_PASSWORD_GUIDE.md)
|
||
- **Konu:** Şifre sıfırlama, şifre politikaları
|
||
- **Ne zaman kullanılır:** Şifre unuttum, şifre değiştirme
|
||
|
||
### JWT Token Düzeltmeleri
|
||
- **Ana Rehber:** [CLERK_JWT_FIX.md](./CLERK_JWT_FIX.md)
|
||
- **Hızlı Çözüm:** [CLERK_JWT_FIX_QUICK.md](./CLERK_JWT_FIX_QUICK.md)
|
||
- **Özet:** [CLERK_JWT_FIX_SUMMARY.md](./CLERK_JWT_FIX_SUMMARY.md)
|
||
- **Doğrulama:** [CLERK_JWT_FIX_VERIFICATION.md](./CLERK_JWT_FIX_VERIFICATION.md)
|
||
- **Diyagram:** [CLERK_JWT_FIX_DIAGRAM.md](./CLERK_JWT_FIX_DIAGRAM.md)
|
||
|
||
---
|
||
|
||
## 🎯 Kullanım Senaryolarına Göre Rehberler
|
||
|
||
### Senaryo 1: İlk Kez Clerk Kuruyorum
|
||
```
|
||
1. CLERK_QUICK_REFERENCE.md (5 dk)
|
||
2. CLERK_VISUAL_GUIDE.md (20 dk)
|
||
3. Test et ve doğrula
|
||
```
|
||
|
||
### Senaryo 2: Kurulum Yaptım Ama Çalışmıyor
|
||
```
|
||
1. CLERK_TROUBLESHOOTING.md
|
||
2. CLERK_AUTH_ISSUES_SUMMARY.md
|
||
3. İlgili özel konu rehberi
|
||
```
|
||
|
||
### Senaryo 3: Webhook Sorunları Yaşıyorum
|
||
```
|
||
1. CLERK_DATABASE_SYNC.md
|
||
2. CLERK_SETUP_GUIDE.md (Webhook bölümü)
|
||
3. Supabase logs kontrol
|
||
```
|
||
|
||
### Senaryo 4: JWT Token Hataları Alıyorum
|
||
```
|
||
1. CLERK_JWT_FIX_QUICK.md (Hızlı çözüm)
|
||
2. CLERK_JWT_FIX.md (Detaylı açıklama)
|
||
3. CLERK_JWT_FIX_VERIFICATION.md (Doğrulama)
|
||
```
|
||
|
||
### Senaryo 5: Kullanıcı Kaydı Çalışmıyor
|
||
```
|
||
1. CLERK_REGISTRATION_FIX.md
|
||
2. CLERK_DATABASE_SYNC.md
|
||
3. CLERK_TROUBLESHOOTING.md
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 Hızlı Referans Tablosu
|
||
|
||
| Sorun | Rehber | Süre | Zorluk |
|
||
|-------|--------|------|--------|
|
||
| İlk kurulum | CLERK_QUICK_REFERENCE.md | 5 dk | Kolay |
|
||
| Detaylı kurulum | CLERK_SETUP_GUIDE.md | 15 dk | Kolay |
|
||
| Görsel kurulum | CLERK_VISUAL_GUIDE.md | 20 dk | Kolay |
|
||
| Genel sorunlar | CLERK_TROUBLESHOOTING.md | 10 dk | Orta |
|
||
| Auth sorunları | CLERK_AUTH_ISSUES_SUMMARY.md | 15 dk | Orta |
|
||
| JWT sorunları | CLERK_JWT_FIX_QUICK.md | 10 dk | Orta |
|
||
| Database sync | CLERK_DATABASE_SYNC.md | 20 dk | İleri |
|
||
| Kayıt sorunları | CLERK_REGISTRATION_FIX.md | 15 dk | Orta |
|
||
| Şifre yönetimi | CLERK_PASSWORD_GUIDE.md | 10 dk | Kolay |
|
||
|
||
---
|
||
|
||
## 🔑 API Anahtarları Özeti
|
||
|
||
### Frontend (.env dosyası)
|
||
```bash
|
||
VITE_CLERK_PUBLISHABLE_KEY=pk_test_...
|
||
```
|
||
|
||
### Backend (Supabase Secrets)
|
||
```bash
|
||
CLERK_SECRET_KEY=sk_test_...
|
||
CLERK_WEBHOOK_SECRET=whsec_...
|
||
```
|
||
|
||
**Detaylar:** [CLERK_SETUP_GUIDE.md](./CLERK_SETUP_GUIDE.md)
|
||
|
||
---
|
||
|
||
## 🔗 Dış Kaynaklar
|
||
|
||
### Clerk Resmi Dokümantasyon
|
||
- **Ana Sayfa:** https://clerk.com/docs
|
||
- **React SDK:** https://clerk.com/docs/references/react/overview
|
||
- **Webhooks:** https://clerk.com/docs/integrations/webhooks
|
||
- **API Reference:** https://clerk.com/docs/reference/backend-api
|
||
|
||
### Clerk Dashboard
|
||
- **Ana Dashboard:** https://dashboard.clerk.com/
|
||
- **API Keys:** https://dashboard.clerk.com/last-active?path=api-keys
|
||
- **Webhooks:** https://dashboard.clerk.com/last-active?path=webhooks
|
||
- **Users:** https://dashboard.clerk.com/last-active?path=users
|
||
|
||
### Supabase Dashboard
|
||
- **Proje:** https://supabase.com/dashboard/project/vtztatcglebrnvikvntf
|
||
- **Edge Functions:** https://supabase.com/dashboard/project/vtztatcglebrnvikvntf/functions
|
||
- **Table Editor:** https://supabase.com/dashboard/project/vtztatcglebrnvikvntf/editor
|
||
- **Logs:** https://supabase.com/dashboard/project/vtztatcglebrnvikvntf/logs
|
||
|
||
---
|
||
|
||
## 💡 İpuçları
|
||
|
||
### Yeni Başlayanlar İçin
|
||
1. ✅ Önce CLERK_QUICK_REFERENCE.md'yi okuyun
|
||
2. ✅ Adım adım ilerleyin, acele etmeyin
|
||
3. ✅ Her adımı test edin
|
||
4. ✅ Hata alırsanız CLERK_TROUBLESHOOTING.md'ye bakın
|
||
|
||
### İleri Seviye Kullanıcılar İçin
|
||
1. ✅ JWT token yapılandırmasını optimize edin
|
||
2. ✅ Webhook retry mekanizmasını kurun
|
||
3. ✅ Custom claims ekleyin
|
||
4. ✅ Multi-factor authentication aktif edin
|
||
|
||
### Güvenlik
|
||
1. ⚠️ Secret key'leri asla paylaşmayın
|
||
2. ⚠️ Production'da test anahtarları kullanmayın
|
||
3. ⚠️ Anahtarları düzenli olarak rotate edin
|
||
4. ⚠️ Webhook endpoint'inizi koruyun
|
||
|
||
---
|
||
|
||
## 🆘 Yardım Alma
|
||
|
||
### Uygulama İçi Destek
|
||
1. **Admin Panel > Settings > Support**
|
||
2. **Admin Panel > Logs** (Hata logları)
|
||
3. **Admin Panel > Clerk Diagnostics** (Bağlantı testi)
|
||
|
||
### Clerk Desteği
|
||
- **Email:** support@clerk.com
|
||
- **Discord:** https://clerk.com/discord
|
||
- **Status Page:** https://status.clerk.com/
|
||
|
||
### Supabase Desteği
|
||
- **Discord:** https://discord.supabase.com/
|
||
- **GitHub:** https://github.com/supabase/supabase/discussions
|
||
|
||
---
|
||
|
||
## 📊 Dokümantasyon Durumu
|
||
|
||
| Dosya | Durum | Son Güncelleme |
|
||
|-------|-------|----------------|
|
||
| CLERK_QUICK_REFERENCE.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_SETUP_GUIDE.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_VISUAL_GUIDE.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_TROUBLESHOOTING.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_AUTH_ISSUES_SUMMARY.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_DATABASE_SYNC.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_REGISTRATION_FIX.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_PASSWORD_GUIDE.md | ✅ Güncel | 2026-02-26 |
|
||
| CLERK_JWT_FIX_*.md | ✅ Güncel | 2026-02-26 |
|
||
|
||
---
|
||
|
||
## 🎓 Öğrenme Yolu
|
||
|
||
### Seviye 1: Başlangıç (1 saat)
|
||
1. CLERK_QUICK_REFERENCE.md
|
||
2. CLERK_VISUAL_GUIDE.md
|
||
3. İlk test kullanıcı oluşturma
|
||
|
||
### Seviye 2: Orta (2 saat)
|
||
1. CLERK_SETUP_GUIDE.md (tamamı)
|
||
2. CLERK_TROUBLESHOOTING.md
|
||
3. Webhook yapılandırması
|
||
|
||
### Seviye 3: İleri (4 saat)
|
||
1. CLERK_JWT_FIX.md
|
||
2. CLERK_DATABASE_SYNC.md
|
||
3. Custom claims ve advanced features
|
||
|
||
---
|
||
|
||
## ✅ Kurulum Checklist
|
||
|
||
Kurulumu tamamlamak için:
|
||
|
||
- [ ] Clerk hesabı oluşturuldu
|
||
- [ ] Uygulama oluşturuldu
|
||
- [ ] VITE_CLERK_PUBLISHABLE_KEY yapılandırıldı
|
||
- [ ] CLERK_SECRET_KEY Supabase'e eklendi
|
||
- [ ] Webhook endpoint oluşturuldu
|
||
- [ ] CLERK_WEBHOOK_SECRET Supabase'e eklendi
|
||
- [ ] Frontend testi yapıldı (login formu görünüyor)
|
||
- [ ] Backend testi yapıldı (Clerk Diagnostics)
|
||
- [ ] Webhook testi yapıldı (test event gönderildi)
|
||
- [ ] Test kullanıcı oluşturuldu
|
||
- [ ] Profil database'de oluşturuldu
|
||
|
||
---
|
||
|
||
**Son Güncelleme:** 2026-02-26
|
||
**Versiyon:** 1.0
|
||
**Toplam Rehber Sayısı:** 15
|