frost-backend

Telegram WebApp için gerçek zamanlı clicker oyun sunucusu. WebSocket akışı, oyun ekonomisi ve Telegram bot entegrasyonu tek serviste. 🚀

✨ Öne Çıkanlar

• WebSocket tabanlı anlık oyun akışı
• Clicker ve AutoClicker yükseltmeleri
• Başarımlar, kuponlar, davet sistemi
• Telegram bot + admin bildirim botu
• MongoDB ile kalıcı kullanıcı verisi

🧭 İstek Akışı

• Telegram WebApp initData → kullanıcı kimliği
• WebSocket login → kullanıcı state oluşturma
• ping → fiyat, hız ve başarımlar güncelleme
• sorting/achievements/coupon → UI verileri

⚙️ Kurulum

1. .env.example dosyasını .env olarak kopyala.
2. Bağımlılıkları yükle.

npm install

3. Sunucuyu başlat.

npm start

🔐 Ortam Değişkenleri

• MONGODB_URI MongoDB bağlantı string’i
• TELEGRAM_BOT_TOKEN Telegram bot token
• TELEGRAM_NOTIFY_TOKEN Admin bildirim bot token
• PUBLIC_BASE_URL Avatar URL’leri için base URL
• TELEGRAM_WEBAPP_URL Bot üzerindeki WebApp buton URL’i
• FROST_SHARED_SECRET WebSocket payload şifreleme anahtarı
• RENEW_INTERVAL_MS Liderlik tablosu yenileme süresi (ms)
• FROST_DEV true veya false
• PORT Sunucu portu

🧠 WebSocket Olayları

• login Telegram kullanıcı bilgisi ile giriş
• ping kullanıcı state güncellemesi
• upgrade clicker/autoClicker yükseltme
• sorting liderlik tablosu isteği
• achievements başarımlar isteği
• coupon kupon kullanımı

📁 Proje Yapısı

• src/modules HTTP modülleri
• src/functions çekirdek yardımcı fonksiyonlar
• src/databases Mongoose şemaları
• src/game (opsiyonel) client build çıktısı

📸 Ekran Görüntüleri

🛡️ Güvenlik Notu

• Secret değerler .env içinde tutulur.
• Repo içinde hassas bilgi bulunmaz.

🗺️ Yol Haritası

• Anti-fraud katmanı
• Admin paneli
• Yeni etkinlik ve ödül mekanikleri

🤝 Katkı

• Issue açarak öneri bırakabilirsin.
• PR’larda mevcut kod stilini koru.

🔗 İlgili Repo

• Client: frost-client

📄 Lisans

• MIT