Mimari ve Teknoloji
Kur'ancılar platformu, performans, ölçeklenebilirlik ve modern geliştirici deneyimi (DX) odaklı teknolojiler üzerine inşa edilmiştir.
Frontend
- Next.js 14: App Router mimarisi.
- TypeScript: Tam tip güvenliği.
- Tailwind CSS: Utility-first styling.
- Lucide React: İkon seti.
- Framer Motion: Animasyonlar.
Backend & Data
- Supabase: PostgreSQL veritabanı.
- Clerk: Kimlik doğrulama (Auth).
- Vercel Cron: Zamanlanmış görevler.
- Edge Functions: Düşük gecikmeli API.
Güvenlik Altyapısı
RLS (Row Level Security)
Tüm veritabanı sorguları Supabase RLS politikaları ile korunur. Kullanıcılar sadece kendi verilerine erişebilir veya izin verilen public verileri okuyabilir.
Middleware Koruması
Clerk middleware, yetkisiz erişimleri sayfa düzeyinde engeller. Hassas rotalar (örn: /ayarlar, /bildirimler) otomatik olarak korunur.
Önemli Bileşenler ve Altyapı
Veritabanı Şeması (Supabase)
| Tablo | Açıklama |
|---|---|
| profiles | Kullanıcı profilleri (Puan, Streak, Şehir, Bildirim Ayarı). Clerk ID ile eşleşir. |
| comments | Kuran ayetlerine yapılan yorumlar. Recursive parent_id ile yanıtları destekler. |
| forum_posts | Forum gönderileri. Başlık, içerik ve kategori barındırır. |
| push_subscriptions | Web Push (VAPID) abonelik bilgileri (Endpoint, Keys). |
Yapay Zeka Destekli Semantik Arama
Uygulama, klasik kelime eşleşmesi yerine Cerebras AI ve Llama-3.3-70b modelini kullanarak anlam bazlı arama yapar.
- NLP Analizi: Kullanıcının "Moralim bozuk" gibi doğal dil sorgularını analiz eder.
- Bağlamsal Eşleşme: Sorguya en uygun ayetleri anlam bütünlüğü içinde önerir (Örn: İnşirah Suresi).
- Sub-second Latency: Cerebras donanımı sayesinde sonuçlar milisaniyeler içinde döner.
Diğer Önemli Bileşenler
Hybrid View EngineHem meal (kart) hem de mushaf (okuma) modlarını tek bileşende yöneten render motoru.
Audio Player ContextGlobal ses durumunu yöneten ve sayfalar arası kesintisiz oynatma sağlayan React Context.
Service WorkerPWA desteği ve Push bildirimlerini arka planda dinleyen worker.