ZecLearn — Global canlı Zcash bilgi yarışması

Dünyanın her yerinden oyuncuların aynı anda katıldığı, sunucu yönetimli canlı Zcash yarışmaları. Web sitesi + telefona kurulabilir uygulama (PWA).

Öne çıkanlar

• Planlı global yarışmalar: Yönetici başlangıç saatini ve ödülü belirler; yarışma o saatte kendiliğinden başlar, sorular otomatik ilerler, host gerekmez.
• Sunucu yönetimli odalar: Sınıf/etkinlik için Kahoot tarzı oda; host projeksiyondan yönetir, oyuncular kod/QR ile katılır.
• Yenilemeye dayanıklı: Tüm oyun durumu veritabanında. Host da oyuncu da sayfayı yenilerse, interneti kopup gelirse ya da başka cihazdan açarsa kaldığı yerden devam eder.
• Hileye dayanıklı: Doğru cevap, cevap ekranına kadar istemciye hiç gönderilmez. Süre ve puan sunucu saatiyle hesaplanır (uzak ülkeler için gecikme payı var). Solo modda aynı quizi tekrar oynayarak puan kasılamaz.
• Zorunlu hesap: Google veya e-posta koduyla giriş; kullanıcı adı, ülke ve isteğe bağlı üniversite/takım.
• Liderlik: Oyuncu, ülke ve takım bazında; tüm zamanlar / 30 gün / hafta / bugün.
• ZEC ödülleri: İlk N kişiye otomatik ödül talebi açılır, kazanan Zcash adresini girer (u1 / zs / t adres biçimi denetlenir), yönetici gönderip işlem kimliğiyle "ödendi" işaretler.
• İçerik üretimi: Onaylı üreticiler quiz hazırlar (iki dilli editör + JSON içe aktarma), yöneticiler inceleyip yayınlar.
• TR / EN, koyu/açık tema, mobil öncelikli tasarım.

---

Mimari

Tarayıcı / Telefon (Next.js, PWA)
   │  supabase-js
   ├── RPC (PostgREST)  → supabase/migrations/*.sql içindeki güvenlik denetimli fonksiyonlar
   ├── Realtime         ← "game:<id>" kanalı: her durum değişikliği veritabanından yayınlanır
   └── Auth             → Google OAuth, e-posta OTP
Supabase Postgres  ← oyun motoru burada (faz geçişleri, puanlama, ödüller)
pg_cron (önerilir)  → her 5 sn'de zamanı gelen yarışmaları ilerletir

• Tablolara doğrudan erişim kapalı (RLS açık, politika yok). Her şey security definer RPC fonksiyonlarıyla yapılır; her fonksiyon kendi yetki denetimini yapar.
• Realtime koparsa istemci otomatik olarak yoklamaya (polling) geçer; oyun kesilmez.
• Süre dolduğunda geçişi herhangi bir istemci veya pg_cron tetikler; tekrarlı çağrılar güvenlidir.

---

Marka: isim ve resmi Zcash logosu

İsim: Uygulama adı lib/config.ts → SITE.name alanından gelir (menü, sayfa başlıkları, paylaşım görseli). Ayrıca public/manifest.webmanifest içindeki name / short_name alanlarını güncelleyin.

Resmi Zcash logosu: Zcash'in resmi marka kitinden indirdiğiniz dosyaları public/brand/ klasörüne koyun:

Dosya	Nerede görünür
public/brand/zcash-mark.svg	Menüdeki logo, Zcash kartı, giriş/katılım ekranları, oyuncu ekranı, favicon
public/brand/zcash-mark-white.svg	Koyu zeminler (isteğe bağlı)

Sonra uygulama ikonlarını ve paylaşım görselini yeniden üretin:

npm run brand

Dosya konana kadar arayüzde yerine sade bir "ZEC" rozeti görünür. Zcash ticari markası Zcash Foundation'a aittir; yayından önce marka kullanım koşullarına göz atmanızı öneririz.

Kurulum (yaklaşık 20 dakika)

1) Supabase projesi

1. https://supabase.com → New project (bölge olarak oyuncularına yakın bir yer seç, ör. Frankfurt).
2. SQL Editor'de sırayla çalıştır:
   1. supabase/migrations/0001_schema.sql
   2. supabase/migrations/0002_profiles_quizzes.sql
   3. supabase/migrations/0003_game_engine.sql
   4. supabase/migrations/0004_solo_leaderboard_admin.sql
   5. supabase/migrations/0005_quiz_covers.sql (kapak fotoğrafları için Storage kovası quiz-covers ve izinleri)
   6. supabase/migrations/0006_guests.sql (misafir girişi)
   7. supabase/migrations/0007_quiz_language.sql (tek dilli quizler: organizatör quizini istediği tek dilde hazırlar)
3. Database → Extensions → pg_cron'u aç, sonra supabase/optional/cron.sql dosyasını çalıştır. (Önerilir: kimse bağlı değilken bile planlı yarışmalar zamanında ilerler.)
4. Realtime → Settings: "Allow public access" / public channels açık olmalı (varsayılan). Oyun durumu herkese açıktır; doğru cevap içermez.

Supabase CLI kullanıyorsan: supabase link ve supabase db push aynı migration'ları uygular.

2) Giriş yöntemleri

Authentication → URL Configuration

• Site URL: https://alan-adin.com
• Redirect URLs: https://alan-adin.com/auth/callback ve geliştirme için http://localhost:3000/auth/callback

E-posta ile kod (OTP) — Authentication → Emails → Magic Link şablonuna kodu ekle:

<h2>ZecLearn giriş kodun</h2>
<p>Kodun: <strong>{{ .Token }}</strong></p>
<p>Ya da bu bağlantıya tıkla: <a href="{{ .ConfirmationURL }}">Giriş yap</a></p>

Gerçek kullanıcılar için SMTP ayarla (Authentication → SMTP Settings; Resend, Postmark, SES vb.). Supabase'in yerleşik e-posta servisi saatte yalnızca birkaç e-postaya izin verir.

Google ile giriş — Authentication → Providers → Google:

1. https://console.cloud.google.com → APIs & Services → Credentials → OAuth client ID (Web application)
2. Authorized redirect URI: https://<proje-ref>.supabase.co/auth/v1/callback
3. Client ID ve Secret'ı Supabase'e gir.

3) Yayına alma (Vercel)

1. Projeyi GitHub'a yükle.
2. https://vercel.com → Import → ortam değişkenleri (.env.example'a bak):
   • NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY (Supabase → Project Settings → API)
   • NEXT_PUBLIC_SITE_URL = yayındaki adresin
3. Deploy. Alan adını bağla ve Supabase Site URL / Redirect URLs ayarlarını güncelle.

4) İlk yönetici

Sitede giriş yapıp profilini oluştur, sonra supabase/optional/first_admin.sql içindeki e-postayı değiştirip çalıştır. Diğer yönetici/üretici atamaları sitedeki Yönetim → Kullanıcılar ekranından yapılır.

Yerelde geliştirme

cp .env.example .env.local   # Supabase bilgilerini gir
npm install
npm run dev                  # http://localhost:3000

---

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗