Genel Bakış

Eros App, gerçek bir işletmeniz için sıfırdan geliştirdiğim tam entegre dijital yönetim platformudur. Sistem; müşteri mobil uygulaması, kasa/garson modülleri, web tabanlı admin paneli ve güçlü bir Firebase backend'den oluşan monorepo mimarisi ile tasarlanmıştır.

Proje, günlük 1000+ aktif kullanıcı ve 1000+ QR işlem kapasitesiyle ölçeklenebilir şekilde optimize edilmiştir.

Platform üç ana katmandan oluşur: Müşterilerin kullandığı React Native mobil uygulama, işletme sahiplerinin kullandığı Next.js web admin paneli ve tüm iş mantığını yöneten Firebase serverless backend.

Ana İşlevler

Müşteri Mobil Uygulaması

• Menü Görüntüleme: Kategorilere ayrılmış ürün listesi, varyasyon seçimi (boyut, süt tipi)
• Dijital Cüzdan: Bakiye ve Coin (sadakat puanı) takibi
• QR ile Ödeme: Sepet oluşturma, QR kod üretme, kasada onaylama
• Kampanya & Abonelik: Paket satın alma, kullanım hakkı takibi
• Sipariş Geçmişi: Tüm işlemlerin detaylı kaydı
• Push Bildirimler: Bakiye yüklemesi, kampanya duyuruları

Kasa/Garson Modülü

• QR Okuyucu: Müşteri QR kodunu tarama
• Bakiye Yükleme: Müşteri hesabına para ekleme
• Sipariş Onaylama: Admin onaylı ödeme akışı
• Hızlı İşlem: Optimize edilmiş iş akışı

Web Admin Paneli

• Dashboard: Gerçek zamanlı satış istatistikleri, grafikler
• Ürün Yönetimi: CRUD işlemleri, kategori/varyasyon yönetimi
• Sipariş Yönetimi: Sipariş listesi, onaylama, iptal
• Kullanıcı Yönetimi: Bakiye yükleme, admin atama, kullanıcı detayları
• Kampanya Yönetimi: Kampanya oluşturma, düzenleme, istatistikler
• Raporlama: Satış raporları, kullanıcı analizleri

Özellikler

Sadakat Sistemi (Coin)

Her ödemede otomatik olarak %10 sadakat puanı kazanılır. Kullanıcılar biriken puanlarını sonraki ödemelerinde kullanabilir. Sistem, puan hesaplama ve bakiye güncellemelerini atomik işlemlerle gerçekleştirir.

Kampanya & Abonelik Sistemi

Admin panelinden saatlik, günlük, haftalık veya aylık kampanyalar oluşturulabilir. Kampanyalar tek bir ürüne, birden fazla ürüne veya tüm kategoriye uygulanabilir. Kullanıcılar kampanya satın aldığında belirli sayıda kullanım hakkı kazanır ve bu haklar günlük limite tabi tutulabilir. Sistem, geçerlilik süresi dolan abonelikleri otomatik olarak pasife alır.

QR Kod Ödeme Sistemi

Müşteri sepetini oluşturduktan sonra 'QR Oluştur' butonuna basar. Sistem 60 saniyelik benzersiz bir oturum oluşturur ve QR kod üretir. Kasa personeli bu QR'ı okuttuğunda müşteri bilgileri ve sepet detayları ekrana gelir. Admin onayladığında atomik bir işlemle bakiye düşülür, Coin puan eklenir ve işlem kaydı oluşturulur.

Push Bildirimler (FCM)

iOS ve Android için native Firebase Cloud Messaging entegrasyonu yapılmıştır. Bakiye yüklemesi, yeni kampanya duyuruları ve sipariş durumu güncellemeleri anlık olarak kullanıcılara iletilir.

Güvenlik ve Yetkilendirme

Altı Katmanlı Güvenlik Mimarisi

• Firebase App Check: Sahte istek koruması (Play Integrity API - Android, App Attest - iOS)
• Rate Limiting: Client (60/dakika), Server (100/dakika), Auth (5/dakika), Ödeme (10/dakika)
• IP Engelleme: Şüpheli aktivite tespit sonrası otomatik engelleme
• Firebase Authentication: Email/password + Custom Claims rol yönetimi
• Firestore Security Rules: Rol tabanlı satır seviyesi erişim kontrolü
• Nonce Koruması: Her QR işleminde benzersiz değer üretimi ve tekrar kullanımı engeli

Teknik Stack

• Mobil: Expo, React Native, TypeScript, NativeWind
• Web Admin: Next.js 14, React, TypeScript, Tailwind CSS
• Backend: Firebase Cloud Functions v2, Node.js, Cloud Firestore, Firebase Auth, Storage, FCM
• Deployment: EAS Build (mobil), Vercel (web), Firebase Hosting & Functions (backend)

Metrikler & Ölçeklenebilirlik

• Günlük 1000+ aktif kullanıcı
• 1000+ QR işlem kapasitesi
• Aylık 2 milyon Cloud Functions çağrısı
• Günlük 50.000 Firestore okuma
• Günlük 20.000 Firestore yazma
• 5GB Storage kapasitesi

Öne Çıkan Özellikler

• Enterprise-Grade Güvenlik: App Check, Rate Limiting, IP Engelleme, Nonce Koruması
• Akıllı Coin Sistemi: Otomatik %10 kazanım, transfer ve referral bonusu
• Esnek Kampanya Sistemi: Saatlik, günlük, haftalık, aylık teklifleri
• Native Push Bildirimler: iOS ve Android FCM entegrasyonu
• Production-Ready: Vercel ve Firebase ile profesyonel deployment
• Sınırsız İşletme: Aynı platformda birden çok şube yönetimi
• High Performance: Firestore indexes, batch writes, caching

Ürün Paketleri

Starter

• Mobil Uygulama (Müşteri)
• Kasa Modülü (1 Terminal)
• Admin Paneli (3 Admin)
• Firebase Backend
• Temel Raporlama

Professional

• Tüm Starter Özellikler
• 5 Kasa Terminal
• Unlimited Admin
• Gelişmiş Raporlama
• Kampanya Yönetimi
• API Erişimi

Enterprise

• Tüm Professional Özellikler
• Unlimited Kasalar
• Şube Yönetimi
• White Label Seçeneği
• Özel Entegrasyonlar
• 24/7 Premium Destek