📍 Neresi Burası?

İpuçlarını oku, haritada yeri bul.

Dünya ve Türkiye haritalarında oynanan, Türkçe bir coğrafya bilgi oyunu.

▶ Oyna: neresi-burasi-project.vercel.app

Oyun nedir?

Sana bir yerin ipuçları verilir; sen de haritada o yeri bulmaya çalışırsın. Her oyun 5 sorudan oluşur. İpuçları genelden özele doğru gider: ilkini ücretsiz görürsün, daha fazlasını açmak istersen puanından feda edersin. Haritaya dokunup tahminini işaretlersin; tahmin doğru yere ne kadar yakınsa o kadar çok puan kazanırsın.

• 🌍 İki harita: Dünya (ülkeler) ve Türkiye (81 il)
• 🎚️ Üç zorluk: Kolay, Orta, Zor. Zorlaştıkça ipucu azalır ama puan katsayısı artar.
• 📚 300 soru: Yapılar, doğa, yemek, tarih, kültür. Her oyunda rastgele 5 tanesi seçilir.
• 🏆 Sıralama: Hesabı olan oyuncuların skorları sıralamaya girer. Hesap açmadan da oynayabilirsin.
• 🤝 Arkadaşınla yarış: Oda kodu paylaş, aynı soruları aynı anda oyna; daha yakın, daha az ipucuyla ve daha hızlı bilen kazanır. Oyun bitince "tekrar oyna" diyebilirsin.
• 🏙️ Şehir etiketleri: Dünya haritasında yakınlaştıkça şehir adları görünür (Kolay'da hepsi, Orta'da büyükler, Zor'da yok).
• 📱 Mobil uyumlu: Telefonda rahat kullanılır; ileride iOS/Android uygulamasına dönüştürülecek.

Ekran görüntüleri

Harita ve zorluk seçimi	Oyun ekranı
Önce harita, sonra zorluk seçilir.	Solda ipuçları, sağda harita. Tahmin haritaya dokunarak işaretlenir.

Sonuç ekranı	Dünya haritası
Doğru yer (yeşil), tahminin (kırmızı), mesafe ve puan.	Dünya haritasında ülke adları Türkçe; üzerine gelinen ülke vurgulanır.

Sıralama	Kayıt
Harita, zorluk ve döneme göre filtrelenir.	Sıralamaya girmek için kullanıcı adıyla kayıt olunur.

Telefonda: ipuçları üstte, harita altta.

Nasıl çalışır?

Oynanış

1. Harita (Dünya / Türkiye) ve zorluk seçilir.
2. Sunucu rastgele 5 soru seçer ve yalnızca ilk ipucunu gönderir.
3. İstenirse sonraki ipuçları tek tek açılır (her biri puanı düşürür).
4. Oyuncu haritaya dokunup tahminini işaretler ve Tahmini onayla der.
5. Sunucu mesafeyi ve puanı hesaplar; doğru konum ancak o zaman gösterilir.
6. 5 soru sonunda toplam puan görülür ve hesabı olan oyuncunun skoru sıralamaya girer.

Arkadaşla yarış (çok oyunculu)

1. Oda kurulur; 5 harfli oda kodu ya da bağlantı arkadaşa gönderilir (misafir de katılabilir).
2. İki oyuncu aynı 5 soruyu aynı anda görür; her soru için 30 saniye vardır ve ekranda geri sayım çubuğu görünür.
3. İpuçları süre içinde kendiliğinden açılır. Tahminini onaylayan oyuncuya sonradan açılan ipuçları gösterilmez.
4. İkisi de tahmin edince (ya da süre dolunca) sonuç görülür: doğru yer, iki tahmin, mesafe, süre ve puan.
5. 5 soru sonunda toplam puanı yüksek olan kazanır. İstenirse "tekrar oyna" ile aynı ayarlarla yeni bir oyun başlar (rakip kabul eder ya da reddeder).

soruPuanı = (mesafePuanı + bölgeBonusu) × zorlukKatsayısı × ipucuKatsayısı × hızKatsayısı
hızKatsayısı = 0,75 + 0,25 × (kalanSüre / 30)     anında 1,00 · son saniye 0,75

Doğru cevap ve rakibin tahmini soru bitene kadar kimseye gönderilmez; süre sunucu saatiyle ölçülür.

Puanlama (tek oyunculu)

mesafePuanı = 1000 × e^(−mesafe_km / ölçek)     ölçek: Dünya 1500 km · Türkiye 75 km
bölgeBonusu = tahmin doğru ülke/il içindeyse +500
soruPuanı   = (mesafePuanı + bölgeBonusu) × ipucuKatsayısı × zorlukKatsayısı

Zorluk	İpucu sayısı	Zorluk katsayısı	İpucu katsayıları (1 → son ipucu)
Kolay	4	×1,0	1,00 · 0,80 · 0,60 · 0,40
Orta	3	×1,5	1,00 · 0,70 · 0,45
Zor	2	×2,0	1,00 · 0,60

Mimari

flowchart LR
    A["Tarayıcı<br/>(ileride mobil uygulama)<br/>Next.js arayüzü + MapLibre harita"] -->|JSON istekleri| B["Next.js API<br/>oyun kuralları ve puanlama"]
    B --> C[("Supabase<br/>PostgreSQL + Auth")]
    B --> D["Sınır dosyaları (GeoJSON)<br/>Turf.js ile bölge kontrolü"]

Oyun mantığı arayüzde değil API'de durur; mobil uygulama da aynı uç noktaları kullanacak.

Hileye karşı

• Doğru cevabın koordinatı ve bölge kodu, tahmin yapılmadan önce istemciye hiç gönderilmez.
• Açılmamış ipuçları gönderilmez; her ipucu ayrı istekle alınır ve sayısı sunucuda tutulur.
• Mesafe, bölge kontrolü ve puan yalnızca sunucuda hesaplanır; istemcinin puanına güvenilmez.
• Aynı soruya ikinci tahmin ve bitmiş oyuna tahmin kabul edilmez.
• Veritabanı tablolarına istemci doğrudan erişemez (Row Level Security).
• Çok oyunculuda cevap ve rakibin tahmini soru bitene kadar gizlidir; süre sunucuda ölçülür.
• Her istemci için uç nokta başına hız sınırı uygulanır (giriş, kayıt, şifre sıfırlama dahil).

Kullanılan teknolojiler

	Teknoloji	Ne için?
🖥️	Next.js 16 (App Router) + TypeScript	Arayüz ve API tek projede
🗺️	MapLibre GL JS	Harita; altlık harita yok, yalnızca kendi GeoJSON katmanlarımız
📐	Turf.js	Mesafe (haversine) ve "nokta hangi ülkede/ilde" kontrolü
🗄️	Supabase (PostgreSQL + Auth)	Sorular, oyunlar, hesaplar ve sıralama
🎨	Tailwind CSS 4	Mobil öncelikli, koyu tema
✅	Zod	Tüm API girdilerinin doğrulanması
🧪	Vitest	Puanlama, coğrafi hesap, oyun kuralları ve soru kalitesi testleri
☁️	Vercel	Yayın
📱	Capacitor (planlanan)	iOS/Android uygulaması

This is the beginning of the README. Read the rest at the original. Read the full README ↗