Şefin Zulası

Elinizdeki malzemelerle tarif keşfetmenizi sağlayan çevrimdışı Flutter uygulaması

Türkçe · English

Demo Videosu

---

Proje Hakkında

Şefin Zulası, kullanıcıların ellerindeki malzemelere göre tarif aramasına, tarifleri karşılaştırmasına, eksik malzemeleri alışveriş listesine eklemesine ve günlük makro hedeflerini takip etmesine yardımcı olan bir Flutter mobil uygulamasıdır.

Uygulama, işlenmiş yerel tarif verisini kullanır ve temel kullanıcı tercihlerini cihaz üzerinde saklar. Böylece tarif arama, favoriler, notlar, alışveriş listesi ve beslenme takibi gibi ana özellikler backend gerektirmeden çalışır.

---

Öne Çıkan Özellikler

• Virgülle ayrılmış malzemelerle tarif arama
• Kalori, protein ve yağ değerlerine göre filtreleme
• Süre, kalori ve protein bazlı sıralama
• Tarif detayları, malzemeler ve adım adım yapılış
• Benzer tarif önerileri
• Favorilere ekleme
• Tariflere kişisel not bırakma
• Eksik malzemeleri alışveriş listesine aktarma
• İki tarifi besin değerleriyle karşılaştırma
• Günlük kalori ve makro hedeflerini takip etme
• Tarif paylaşma
• Açık ve koyu tema
• Yerel veri ve çevrimdışı kullanım

---

Uygulama Görünümü

Ana ekran	Arama sonuçları
Tarif özeti	Yapılış ve benzer tarifler
Tarif notu	Favoriler
Alışveriş listesi	Tarif karşılaştırma
Makro takibi	Koyu tema

---

Kullanım Akışı

1. Arama alanına mevcut malzemeleri virgülle ayırarak girin.
2. Sonuçları süre veya besin değerlerine göre filtreleyin ve sıralayın.
3. Tarif detayında malzemeleri, besin değerlerini ve yapılış adımlarını inceleyin.
4. Tarifi favorilere ekleyin, kişisel not oluşturun veya paylaşın.
5. Eksik malzemeleri alışveriş listesine aktarın.
6. Tarifleri karşılaştırın ve günlük makro takibine ekleyin.

---

Teknoloji Yığını

• Flutter / Dart
• Material 3
• SharedPreferences
• Share Plus
• Cached Network Image
• Yerel JSON veri seti
• Python ve Pandas tabanlı veri hazırlama araçları

---

Proje Yapısı

recipes-app/
├── assets/
│   └── hazir_tarifler.json
├── lib/
│   ├── main.dart
│   ├── models/
│   │   └── recipe.dart
│   └── services/
│       ├── favorites_service.dart
│       ├── notes_service.dart
│       ├── nutrition_calculator_service.dart
│       ├── recipe_service.dart
│       ├── search_history_service.dart
│       └── shopping_list_service.dart
├── python_data/
├── pubspec.yaml
└── README.md

---

Kurulum

Gereksinimler

• Flutter SDK 3.8.1 veya üzeri
• Dart SDK
• Android Studio, VS Code veya desteklenen başka bir Flutter geliştirme ortamı

Çalıştırma

git clone https://github.com/BurakKocDev/recipes-app.git
cd recipes-app
flutter pub get
flutter run

---

Yerel Veri ve Kalıcılık

Tarif verileri uygulama paketindeki JSON dosyasından okunur. Favoriler, alışveriş listesi, tarif notları, tema tercihi ve günlük beslenme hedefleri cihaz üzerinde saklanır.

---

Sınırlılıklar

• Tarif ve beslenme bilgileri kullanılan veri setindeki değerlere bağlıdır.
• Uygulama çevrimdışı ve yerel veri odaklıdır; hesap senkronizasyonu veya bulut yedekleme içermez.
• Tarif görsellerinin kullanılabilirliği veri kaynağına bağlı olabilir.
• Bu proje eğitim, prototipleme ve portföy amacıyla geliştirilmiştir.

---

Amaç

Şefin Zulası; mobil arayüz tasarımı, yerel veri işleme, kullanıcı tercihlerinin saklanması ve günlük yaşam odaklı yardımcı özelliklerin tek bir Flutter uygulamasında birleştirildiği kapsamlı bir mobil proje örneğidir.