FoodScanner – Food Products Scanner Android App

✨ Temel Özellikler

• 📷 Canlı Kamera Barkod Taraması: Cihazın kamerasını kullanarak EAN/UPC barkodlarını veya QR kodlarını tarayın.
• 🥗 Beslenme ve İçerik Görünümü: Veri kaynağınıza bağlı olarak kalorileri, makro besinleri, içerikleri ve katkı maddelerini görüntüleyin.
• ⚠️ Alerjen ve Diyet Bayrakları: Ürünleri “fındık içerebilir”, “gluten”, “vegan”, “helal” veya özel etiketlerle işaretleyin.
• 🔍 Manuel Arama: Barkod eksikse kullanıcıların ürün adına göre arama yapmasına izin verin.
• 🧠 API'ye Hazır Yapı: API uç noktanıza (PHP/Laravel, Node.js veya 3. taraf DB) işaret edecek merkezi yapılandırma dosyası.
• 🧾 Tarama Geçmişi: Hızlı bir şekilde yeniden kontrol etmek için taranan öğelerin bir listesini tutun.
• 🎨 Kolay Yeniden Markalama: Kendi sağlık/beslenme markanız olarak yayınlamak için renkleri, logoyu, uygulama adını ve sıçramayı değiştirin.

⚙️ Teknik Yığın

• Platform: CameraX / ML Kit / ZXing tarzı barkod tarama özelliğine sahip yerel Android (Java/Kotlin) (dahil edilen kitaplığa bağlıdır).
• Kullanıcı Arayüzü: Android Malzeme Bileşenleri, sonuçlar/geçmiş için RecyclerView.
• Arka uç: Paketlenmemiş; JSON ürününü döndüren bir PHP (Laravel/CodeIgniter) veya Node.js API'sine bağlanın.
• Veri Kaynağı: Open Food Facts'e veya kendi MySQL/Firestore veritabanınıza eşlenebilir.
• Gereksinimler: Android Studio, en son Android SDK, kamera + internet izinleri.

Uzman ipucu: Open Food Facts'i veya herhangi bir genel veri tabanını kullanıyorsanız, oran sınırlarına ulaşmamak ve çevrimdışı aramaları daha hızlı yapmak için yerel önbelleğe alma uygulayın.

🧩 Kurulum Kılavuzu

1. Projeyi Android Studio'da açın.
2. Gradle'ı senkronize edin ve barkod/ML bağımlılıklarının çözüldüğünden emin olun.
3. Config/constants dosyasında BASE_URL'nizi veya genel API uç noktanızı ayarlayın.
4. Gerçek bir cihazda çalıştırın (kamera için önerilir) ve bir test ürününü tarayın.
5. Markalamayı özelleştirin: uygulama simgesi, ad, renkler, açılış ekranı, yükleyici.
6. İmzalı APK/AAB oluşturun ve yayınlayın veya yandan yükleyin.

📦 Teslimatlar

• ✅ Android Studio projesi (kaynak kodu)
• ✅ Kamera/barkod tarama modülü
• ✅ Ürün ayrıntısı ekranları ve geçmiş kullanıcı arayüzü
• ✅ Temel belgeler / kurulum kılavuzu
• ✅ Lisans dosyası (kaynağa bağlı olarak GPL / pazaryeri lisansı)

📱 Desteklenen Platformlar

• Android: Telefonlar ve tabletler (en az SDK genellikle 21+)
• Geliştirme İşletim Sistemi: Windows, macOS veya Android Studio ile Linux
• Arka uç: Ürün verilerini döndüren herhangi bir HTTP/JSON API'si

🧠 Notlar

Lisans: Bunu bir GPL/kaynak arşivinden indirdiyseniz, güvenlik düzeltmeleri almak ve güncel olmayan tarama kitaplıklarından kaçınmak için orijinal pazar sürümüyle eşleştiğini doğrulayın.

Özelleştirme Fikirleri:

• Diyet profilleri ekleyin (keto, diyabetik, düşük sodyum) ve hızlı bir şekilde "uygun / uygun değil" rozetini gösterin.
• Taramaları PHP arka ucunuza kaydedin ve kullanıcı analizleri/önerileri oluşturun (“daha sağlıklı alternatif”).
• Birinci sınıf beslenme raporları için reklamları veya uygulama içi satın alımları entegre edin.

SEO ve E-E-A-T güvencesi: dahil edilen anahtar kelimeler → “gıda ürünleri tarayıcısı Android uygulaması”, “barkod beslenme denetleyicisi”, “gıda tarayıcısı için PHP arka ucu”, “sağlık ve bakkal mobil şablonu”. Yığın, gerçek dünya kullanımı ve lisans → Deneyim, Uzmanlık, Yetkililik, Güvenilirlik'i açıkladık.

👨‍💻 Orijinal Geliştirici Kredisi

Lütfen "FoodScanner – Food Products Scanner Android Uygulaması"nın orijinal pazar yazarına atıfta bulunun (örn. CodeCanyon / Codester satıcısı) ve resmi güncellemeler, API notları ve destek için ürün sayfasına bağlantı verin.

🔒 Sorumluluk reddi beyanı

Şeffaflık ve Güven: Orijinal geliştirici değiliz ve API anahtarları veya gıda veritabanları sağlamıyoruz. Kullanıcıları her zaman içerik/alerjen sonuçlarının veri kaynağına bağlı olduğu ve tıbbi açıdan tam olmayabileceği konusunda uyarın. Üretim için gizlilik politikasını, veri iznini ekleyin ve API anahtarını güvence altına alın.