Son Kullan

English summary

Canlı demo: https://cantsdlnn.github.io/son-kullan/

Evdeki ürünleri son kullanma tarihine göre sıralayan, önce tüketilecekleri görünür kılan ve israf eğilimini yerel olarak özetleyen çevrimdışı bir web uygulaması.

Hesap açmak veya sunucuya veri göndermek gerekmez. Kayıtlar kullanılan tarayıcının yerel depolama alanında kalır.

Neden bu proje?

Ev stoğu çoğu zaman ürün alınırken değil, tarihi geçtiğinde hatırlanıyor. Son Kullan küçük bir günlük yaşam problemini ölçülebilir kurallara dönüştürüyor: tarihleri güvenilir biçimde karşılaştırıyor, yakın tarihli ürünleri öne alıyor ve sonuçlanan kayıtlar üzerinden israf oranını açıklanabilir biçimde hesaplıyor.

Özellikler

• Son kullanma tarihine göre deterministik “önce tüket” sırası
• Geçmiş, bugün, 1–3 gün, 4–7 gün ve daha sonrası için görünür durumlar
• Tüketildi/israf edildi yaşam döngüsü ve geçmiş kaydı
• Kayıt sayısına dayalı israf oranı ve en sık israf edilen kategori
• Doğrulanan JSON yedeği alma ve geri yükleme
• Yerel kayıt; hesap, analitik veya sunucu yok
• Kurulum sonrası çevrimdışı çalışan PWA
• İzin verilirse sistem bildirimi, verilmezse uygulama içi hatırlatma
• Klavye odağı, atlama bağlantısı, canlı durum bölgesi ve hareket azaltma desteği
• Responsive arayüz

Hızlı başlangıç

Node.js 22 veya daha yeni bir LTS sürümü gerekir.

npm ci
npm run dev

Terminalde gösterilen yerel adresi tarayıcıda açın.

Test ve derleme

npm test
npm run build
npm audit --audit-level=moderate

Testler tarih doğrulama ve artık yıl sınırlarını, öncelik sırasını, israf özetini, bildirim geri dönüşünü ve içe aktarılan verinin şema bütünlüğünü kapsar. Son doğrulama raporu: docs/test-report.md.

Tarih yaklaşımı

Uygulama yalnızca gün hassasiyetinde çalışır. YYYY-MM-DD değerleri takvim tarihi olarak doğrulanır ve iki tarih arasındaki fark UTC gün anahtarları üzerinden hesaplanır. Böylece yaz/kış saati geçişlerinin “bir gün” hesabını bozması engellenir; kullanıcının bugünkü tarihi ise yerel takvimden alınır.

Veri ve gizlilik

• Ürün verisi bir sunucuya gönderilmez.
• localStorage cihazda şifreli bir kasa değildir; ortak cihazlarda hassas notlar yazılmamalıdır.
• JSON yedeği kullanıcı tarafından korunmalıdır.
• Sistem bildirimi yalnızca kullanıcı düğmeye bastığında ve tarayıcı izni varsa oluşturulur; arka planda zamanlanmış bildirim iddiası yoktur.

Proje belgeleri

• Gereksinimler
• Mimari
• ADR-001: Yerel öncelikli veri
• ADR-002: Takvim günü hesabı
• Test raporu
• Yapay zekâ kullanım beyanı
• Güvenlik politikası

Bilinen sınırlar

• Tarayıcı verisi temizlenirse ve yedek yoksa kayıtlar geri getirilemez.
• Çoklu cihaz eşitlemesi ve kullanıcı hesabı yoktur.
• Bildirimler tarayıcı ve işletim sistemi desteğine bağlıdır; kritik liste her durumda uygulama içinde görünür.
• Farklı birimlerdeki miktarlar anlamlı biçimde toplanamayacağı için israf oranı ürün adedi değil, sonuçlanan kayıt sayısı üzerinden hesaplanır.
• Uygulama gıda güvenliği tavsiyesi vermez; ambalaj ve üretici bilgisi esas alınmalıdır.

AI kullanımı

Üretken yapay zekâyı gereksinimleri sınır durumlarına dönüştürme, alternatif tasarımları değerlendirme, test senaryolarını genişletme ve kod inceleme desteği için kullandım. Tarih modeli, veri sınırları, kabul kriterleri ve nihai doğrulama sorumluluğu bana aittir. Ayrıntılar: AI_USAGE.md.

Lisans

MIT