Ne yediğini bilen insanlar için makro takipçisi.

Kapsam

Makro takip uygulaması pazarı kalabalık ve çoğunda aynı sorun var: besin veritabanı İngilizce öncelikli, barkod adımı hantal, görsel dil ya spor mağazası kadar bağırgan ya hastane kadar klinik. Kapsam, Türkçede premium hissettiren, kullanıcının ne yediğini bildiğine saygı duyan ve kasada tek elle çalışan bir takipçiydi.

Ne kurdum

• Türkçe besin veritabanı. Yaygın Türk yemekleri ve malzemeleri için yerel veritabanı (100 gram üzerinden değerler) — kullanıcı öğle yemeğini İngilizce arama terimine çevirmek zorunda kalmıyor.
• Canlı barkod tarama. Tam ekran kamera, özel kesikli maske ve hareketli tarama çizgisi. Geçerli bir taramada alt panel yukarı kayıyor: ürün, canlı porsiyon–kalori hesabı ve tek dokunuşla ekleme.
• OpenFoodFacts entegrasyonu. OpenFoodFacts API'sine bağlanan REST istemcisi ve yerel önbellek katmanı — tekrar taranan barkod anında dönüyor ve çevrimdışı çalışıyor.
• Mifflin–St Jeor BMH/TDEE motoru. Kullanıcı profilinden kişiselleştirilmiş günlük hedefler — yaş, cinsiyet, boy, kilo, aktivite düzeyi, hedef — cihaz üzerinde hesaplanıyor.
• Ana ekran halkası ve öğün bölümleri. Kalan kalori halkası, dört öğün bölümü (kahvaltı, öğle, akşam, ara öğün), su takibi ve günler boyunca akan geçmiş grafiği.
• İkili eylem butonu. Barkod tarayıcı için ölçülü bir ikincil buton, ana "Besin Ekle" butonunun üzerinde duruyor — tek parmak, iki kısayol.
• Bulut derleme. Her gönderimde imzalı sürüm APK'sı üreten GitHub Actions akışı — uygulama yerel Flutter kurulumu olmadan yayına çıkabiliyor.

Tasarım dili

Koyu zemin, sıcak vurgu, ferah tipografi ve ölçülü kullanılan tek bir vurgu rengi. Halkalar, kartlar ve listeler aynı geometriyi paylaşıyor; böylece uygulama tek bir nesne gibi okunuyor. İkonlar çizgisel, hareketler kısa ve yaylı, ilk ekrandaki her şey tek bir soruyu yanıtlıyor: bugün ne kadar makro hakkım kaldı?

Analiz

Barkod akışı uygulamanın en küçük ama en önemli yüzeyi — uygulamanın günlük kullanım kazandığı ya da silindiği an burası. Orta seviye bir Android'de ilk taramaya kadar geçen süre iki saniyenin altında; alt panel kullanıcı yazarken porsiyon hesabını canlı gösteriyor, yani 40 gram ile 60 gram arasındaki fark o anda güncelleniyor. Uygulamanın genel tasarım ilkesi bu: her ekran bir soruyu yanıtlar, sonra yoldan çekilir.

Mühendislik notları

Bulut derleme hattını temize çıkarmak dört denemeyi aldı: Dart'ta çalışma zamanı ifadesiyle const derleme hatası, Kotlin sürüm uyuşmazlığı (shared_preferences_android Kotlin 1.9+ isterken Flutter 3.24 varsayılanı 1.7'ydi) ve izin bloğunun <application> etiketinin öncesine değil içine düştüğü bir Android manifest birleştirme sorunu. Sonuç: Flutter 3.27.0, düzeltilmiş bir sed ekleme kalıbı ve her gönderimde temiz, imzalı APK. Bu hikâye şunu hatırlatıyor: "yapay zekâ öncelikli" mobil projelerin çoğu hâlâ sıkıcı derleme hattında hayat buluyor ya da ölüyor.