Prag Kartalları v2 — Dernek Yönetim Platformu

Proje özeti

Prag Kartalları, Prag merkezli bir Beşiktaş taraftarlar derneğidir. Mevcut PHP sitesi maç verilerini iyi işliyor ancak derneğin çok daha fazlasına ihtiyacı var: üye kaydı ve kimlik doğrulama, ödeme takibi, makbuz oluşturma, yönetim kurulu için admin paneli ve finansal raporlama. Kapsam, eski teknoloji yığınının temiz bir şekilde destekleyebileceğinin ötesine geçti ve tam bir yeniden yazım devam etmektedir.

Neler yapılıyor

Mevcut siteyi tamamen değiştirecek tam kapsamlı bir Next.js 15 uygulaması. Üç hedef kitleye hizmet eder: kamuoyu, kayıtlı üyeler ve yönetim kurulu.

Halka açık site, mevcut sürümden maç merkezini devralır — canlı skorlar, fikstürler, puan durumu, kadro — duyurular ve dernek bilgileriyle birlikte. Tüm halka açık içerik Türkçe, İngilizce ve Çekçe olarak üç dillidir.

Üye portalı, tam üyelik yaşam döngüsünü yönetir. Yeni kullanıcılar kayıt olur, profillerini tamamlar, üyelik ödemesini gönderir (QR kodlu banka havalesi veya nakit) ve yönetim kurulu onayını bekler. Aktif olduktan sonra üyeler ödeme geçmişlerini görüntüleyebilir, PDF makbuzlarını indirebilir ve profillerini yönetebilir.

Admin paneli, yönetim kuruluna tam kontrol sağlar: durum iş akışlarıyla üye yönetimi, ödeme onay kuyrukları, makbuz oluşturma ve e-posta teslimi, duyuru yayınlama, Resend üzerinden bülten oluşturma, belge yönetimi ve PDF dışa aktarımlı aylık finansal raporlar. Tüm yönetici eylemleri denetim kaydında izlenir.

Otomatik sistemler

Maç veri akışı mevcut sürümden devralınır ancak cron-job.org yerine GitHub Actions üzerinden çalışır:

• Gecelik — ESPN ve API-Football’dan fikstürleri, kadroyu ve olayları senkronize eder.
• Saatlik — Süper Lig puan durumunu ve takım logolarını günceller.
• Maç günü — canlı BJK maçı sırasında her dakika tetiklenir. Skoru ve olayları gerçek zamanlı olarak alır.

Ek otomasyonlar: Google Drive’a günlük veritabanı yedeklemeleri, kuyruğa alınmış bülten teslimi (Resend limitlerinde kalmak için gruplandırılmış) ve başarısız Drive yüklemeleri için yeniden deneme mantığı.

Teknik notlar

Server Components varsayılandır — veri çekme SEO için bileşen düzeyinde gerçekleşir. Tüm mutasyonlar paylaşılan Zod doğrulama şemalarıyla Server Actions üzerinden yapılır. Kimlik doğrulama, credentials sağlayıcısı ve JWT stratejisiyle Auth.js kullanır. Üye durum akışı (kayıt → profil tamamlama → ödeme → onay → aktif) middleware tarafından zorunlu kılınır.

PDF makbuzları @react-pdf/renderer ile sunucu tarafında oluşturulur — istemci tarafında PDF yükü yoktur. Finansal raporlar aylık ve yıllık dökümler, sürümlü PDF dışa aktarımı ve daha fazla düzenlemeye karşı verileri kilitleyen ay finalizasyonu desteği sunar.

Stack

Next.js · TypeScript · PostgreSQL · Prisma · Auth.js · Tailwind CSS · shadcn/ui · Resend · Zod · GitHub Actions · Hetzner · Nginx · Let’s Encrypt