cashra-backend

Telegram WebApp için gerçek zamanlı oyun sunucusu. WebSocket akışı, oyun motoru ve ekonomi yönetimi tek serviste. 🚀

✨ Öne Çıkanlar

• Telegram WebApp auth doğrulaması
• WebSocket tabanlı anlık oyun akışı
• Blackjack oyun motoru ve ekonomi yönetimi
• Modüler endpoint mimarisi

🧭 İstek Akışı

• Telegram WebApp initData → doğrulama
• WebSocket handshake → oyun state
• MongoDB → kullanıcı, oyun, mağaza ve istatistik

⚙️ 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_BOT_TOKEN Admin bildirim bot token
• PUBLIC_URL WebApp public URL
• DEV_MODE true veya false
• PORT Sunucu portu
• NGROK_AUTHTOKEN Opsiyonel, sadece dev
• NGROK_DOMAIN Opsiyonel, sadece dev
• ADS_NORMAL_PRICE Normal reklam ödülü
• ADS_ADULT_PRICE Adult reklam ödülü
• ADS_NORMAL_SMARTLINKS Normal smartlink listesi (virgülle)
• ADS_ADULT_SMARTLINKS Adult smartlink listesi (virgülle)
• ADS_NORMAL_POPUNDERS Normal popunder listesi (virgülle)
• ADS_ADULT_POPUNDERS Adult popunder listesi (virgülle)
• ADS_NORMAL_BANNERS Normal banner JSON array
• ADS_ADULT_BANNERS Adult banner JSON array

🧠 WebSocket Olayları

• login Telegram WebApp initData ile giriş
• ping kullanıcı state güncellemesi
• sorting liderlik tablosu isteği
• store mağaza verisi isteği
• create oyun başlatma
• hit kart çekme
• stand bekleme
• double double işlemi
• buy mağazadan satın alma

🧠 Oyun Motoru

• Blackjack kuralları ve kart puanlama
• Double, hit, stand akışları
• Kazanç ve kayıp hesaplaması

📁 Proje Yapısı

• src/modules HTTP modülleri
• src/functions çekirdek oyun ve yardımcı fonksiyonlar
• src/databases Mongoose şemaları

📸 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 ve detaylı metrikler
• Oyun modları

🤝 Katkı

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

🔗 İlgili Repo

• Client: cashra-client

📄 Lisans

• MIT