---

✨ Özellikler

🪙 Varlık Takibi

• Gram (24 ayar/has), 22 ayar gram altın, çeyrek, yarım, tam, Cumhuriyet ve Ata altını
• Ayarlı ziynet altınları (22/18/14 ayar) — has karşılığı otomatik hesaplanır
• Her altın varlığın has gram karşılığı listede gösterilir; toplam has altın 80 g nisabla karşılaştırılır
• Gümüş, Dolar, Euro, TL nakit (₺ simgesiyle) ve serbest "diğer" varlıklar
• Tüm varlıklar güncel kurla TL'ye çevrilir, dağılım grafiğiyle gösterilir
• Varlıklar sekmesinde, hangi türden toplam ne kadar varlığınız olduğunun rozet (chip) görünümünde dökümü

🌱 Zekât Hesabı

• Nisab: 80 gram has (24 ayar) altın karşılığı, güncel kurla otomatik
• Matrah = varlıklar + alacaklar − borçlar; nisabı aşınca %2,5 (1/40) hesaplanır
• Kamerî yıl (havl) takibi: nisaba ulaştığınız tarihi kaydedin, 354 gün dolunca uygulama uyarır
• Ödediğiniz zekâtları tarihçesiyle kaydedin; ödenen / kalan tutar otomatik izlenir, dönem tamamlanınca havl yenilenebilir
• Vade hatırlatıcısı 🔔 — bildirim izni verirseniz kamerî yılın dolmasına 7 gün kala hatırlatılır (Android APK'de uygulama kapalıyken de çalışan gerçek bildirim, web sürümünde uygulamayı açtığınızda)

🤝 Borç / Alacak

• TL, Dolar, Euro, gram/çeyrek/yarım/tam/Cumhuriyet/Ata altını veya gümüş cinsinden borç ve alacak kaydı
• Kısmi (aralıklı) ödeme takibi: her kayda birden çok ödeme eklenebilir, kalan bakiye otomatik hesaplanır
• Bir kayda dokununca açılan kişi kartında toplam/ödenen/kalan özeti ve tarih sıralı ödeme geçmişi düzenli liste halinde görünür
• Kayıtları düzenleme — kişi, tutar, birim ve vade sonradan değiştirilebilir
• Toplam kartlarında hangi para biriminden/üründen ne kadar borç veya alacak olduğunun dökümü
• Vade takibi — geciken kayıtlar kırmızı uyarı alır
• "Ödendi" işaretleme ve filtreleme
• Varlıklara otomatik aktarım: yeni alacak eklerken tutar varlıklarınızdan düşülür, yeni borçta eklenir; tahsilat/ödeme yaparken tersi işlenir. Hangi varlık kaydına işleneceğini siz seçersiniz, isterseniz onay kutusunu kaldırıp atlarsınız

🔒 Emanetler

• Zekâta dahil olmayan, sadece takip amaçlı bende duran veya bendeki (onda duran) emanet para/altın kayıtları
• Borç/alacak toplamlarına, zekât matrahına ve net servete hiç dahil edilmez
• Kısmi iade takibi: her kayda birden çok iade eklenebilir, kalan bakiye otomatik hesaplanır

☁️ Bulut Yedekleme (isteğe bağlı)

• Google ile giriş yaparak verilerinizi Supabase üzerinde yedekleyebilirsiniz
• Giriş yapmadan uygulama tamamen çevrimdışı ve cihaz-içi çalışmaya devam eder
• "Şimdi Buluta Yedekle" / "Buluttan Geri Yükle" ile manuel senkron; her kayıttan sonra otomatik arka plan senkronu
• Otomatik çekme: uygulama açıldığında, sekme/uygulama tekrar öne geldiğinde ve düzenli aralıklarla başka cihazdan gelen daha yeni veri varsa sessizce çekilir — elle "geri yükle" demeye gerek kalmadan diğer cihazdaki değişiklikler kısa sürede görünür
• Cihaz değiştirdiğinizde Google ile giriş yapıp buluttaki verilerinizi geri yükleyebilirsiniz
• Veri kaybı koruması: açılışta bulut önce okunur, karar verilmeden hiçbir otomatik senkron çalışmaz; boş yerel veri dolu bulut yedeğinin üzerine asla sessizce yazılamaz
• Günlük otomatik yerel yedekler: son 7 günün yedeği Ayarlar'dan geri yüklenebilir — buluta hiç girmeden de bir güvenlik ağı sağlar
• Senkron sağlığı görünür: Ayarlar'da son senkron "5 dakika önce ✓" biçiminde gösterilir; yedekleme başarısız olduysa veya 24 saattir yedek alınmadıysa Özet sayfasının tepesinde kırmızı uyarı çıkar — sessizce bozulan senkron fark edilmeden kalmaz

👥 Paylaşılan Kasalar (isteğe bağlı, v1.19.0)

• Verilerinizi eşinizle veya ortağınızla paylaşın: herkes kendi Google hesabıyla girer, hesap paylaşmak gerekmez
• Davet e-posta ile: davet ettiğiniz kişi aynı adresle giriş yaptığında kasa listesinde kendiliğinden görünür
• İki yetki düzeyi: Düzenleyen (kayıt ekler/değiştirir) veya İzleyici (yalnızca görür); yetki sonradan değiştirilebilir, üye çıkarılabilir
• Birden çok kasa tutup aralarında geçiş yapabilirsiniz (örn. "Kasam" ve "Ortak Kasa") — her kasanın kendi nisabı, havli ve zekât geçmişi vardır
• Değişiklikler karşı tarafta anında görünür (Supabase Realtime; bağlantı koparsa kısa aralıklı yoklama devralır)
• Çift taraflı düzenlemede veri kaybı yok: her kayıt zaman damgalı, silmeler "mezar taşı" olarak işaretli ve buluta yazma iyimser kilitli — siz varlık eklerken eşiniz borç eklerse ikisi de korunur
• Form doldururken karşı taraftan değişiklik gelirse ekranınız altınızdan yenilenmez, pencereyi kapatınca uygulanır
• Yetkiler sunucuda korunur (v1.23.5): roller yalnızca arayüzde değil veritabanı kurallarında da uygulanır — Düzenleyen kasanın sahipliğini ele geçiremez, İzleyici değişiklik yapamaz ve bildirim gönderemez; davetler yalnızca doğrulanmış e-posta adresiyle kabul edilir. Diğer üyelerden gelen notlar ve kayıtlar ekranda düz metin olarak gösterilir, içine kod gömülemez
• Sahiplik devredilebilir; kasadan ayrılabilir, sahibi kasayı silebilir. Hesabınızı silerseniz başka üyesi olan kasalar en eski üyeye devrolur
• ⚠️ Paylaştığınız kişi o kasadaki tüm finansal verinizi görür; paylaşılmış veri geri alınamaz (bkz. gizlilik politikası)
• Hareket geçmişi (v1.20.0) — kasadaki her ekleme/silme/güncelleme kimin yaptığı ve ne zaman yapıldığıyla kaydedilir; karşı taraf bir değişiklik yaptığında bildirim (toast) gösterilir, Ayarlar → Hareketler kartından geçmiş görüntülenebilir
• Kasa bildirimleri 🔔 (v1.22.0) — uygulama kapalıyken de haberiniz olur: diğer üye bir kayıt eklediğinde/değiştirdiğinde telefonunuza bildirim düşer. Ayarlar → Bulut Yedekleme'den açılır, kendi yaptığınız değişiklikler için bildirim gönderilmez ve bildirim metni finansal tutar içermez

📈 Diğer

• Servet geçmişi grafiği — net servetiniz günlük kaydedilir
• Gizlilik modu 🙈 — tek dokunuşla tüm tutarları gizleyin
• Kurlar otomatik internetten güncellenir — açılışta son çekimden 3 saat geçtiyse (gereksiz istekleri önlemek için), sonucu bir bildirimle gösterilir; elle güncelleme de her zaman mümkündür
• Kur tazeliği göstergesi — kurların ne zaman çekildiği "3 saat önce" biçiminde görünür; 24 saatten eskiyse hesaplamaların eski fiyatlara dayandığı uyarısı çıkar
• Çevrimdışı çalışır — bir kez açtıktan sonra internet olmadan da açılır (service worker); internet varken her zaman en güncel sürüm yüklenir
• JSON yedek alma / geri yükleme
• Silme gibi geri alınamaz işlemler uygulama içi onay penceresiyle yapılır (tarayıcı popup'u değil)

📱 Kurulum

Uygulama tek bir HTML dosyasıdır, kurulum gerektirmez:

1. kamilsaim.github.io/Bereket adresini (veya index.html dosyasını) telefonunuzun tarayıcısında açın
2. Tarayıcı menüsünden "Ana ekrana ekle" deyin
3. Artık uygulama gibi tam ekran açılır ✅

💡 Uygulama kamilsaim.github.io/Bereket üzerinde (GitHub Pages) canlıdır; internet yalnızca kur çekmek için gerekir, uygulama çevrimdışı da çalışır.

📱 Android: Uygulama ayrıca Capacitor ile bir Android APK kabuğu olarak paketlenmiştir; aynı canlı adresi bir uygulama olarak açar.

🔒 Gizlilik

Tüm verileriniz varsayılan olarak yalnızca kendi cihazınızda (localStorage) saklanır. Hiçbir sunucuya hiçbir veri gönderilmez. Kur güncelleme isteğe bağlıdır. Google ile giriş yapmayı seçerseniz veriler ayrıca Supabase'de, Row Level Security ile korunan size özel bir kayıtta saklanır. Giriş yapmazsanız bu adım hiç devreye girmez.

Bir kasayı paylaşmayı seçerseniz (v1.19.0), davet ettiğiniz kişiler o kasadaki tüm finansal verinizi görür ve davet için girdiğiniz e-posta adresleri sunucuda saklanır; paylaşılmış veri geri alınamaz. Paylaşımı kullanmadığınız sürece verilerinize yalnızca siz erişebilirsiniz. Ayrıntılar: gizlilik politikası.

🛠️ Teknik

Yapı	Tek dosya HTML + CSS + JS, framework yok (+ çevrimdışı için sw.js ve manifest.json)
Depolama	localStorage (JSON yedekleme ile taşınabilir)
Kur kaynağı	finans.truncgil.com (isteğe bağlı)
Bulut yedekleme	Supabase (isteğe bağlı, Google girişiyle)
Güvenlik	Row Level Security + rol koruma tetikleyicisi; arayüzde tüm kullanıcı verisi kaçışlı basılır
Tipografi	Marcellus + Manrope

📋 Sürüm Geçmişi

Sürüm	Tarih	Yenilikler
v1.23.x	05.10.2026	Güvenlik güncellemesi: paylaşılan kasada notlar ve kayıt kimlikleri üzerinden kod enjeksiyonu kapatıldı, düzenleyici rolündeki bir üyenin kasa sahipliğini ele geçirmesi sunucuda engellendi, davetler yalnızca doğrulanmış e-postayla kabul ediliyor, izleyiciler bildirim gönderemiyor (v1.23.5). Kasa seçilmediğinde Özet ekranında uyarı gösteriliyor (v1.23.4). Buluttan Geri Yükle, yerel (cihaza özel) kasadayken artık sessizce "veri bulunamadı" demek yerine açıklayıcı bir uyarı gösteriyor ve Kasalar bölümüne yönlendiriyor (v1.23.3). Kayıt formlarına çift gönderim kilidi eklendi (v1.23.2). APK sürümünde geri tuşu düzeltildi (v1.23.1). Özet ekranında son 24 saatteki servet değişim rozeti ve Varlıklar sekmesinde toplam/tür dağılımı/has altın özet kartı eklendi (v1.23.0)
v1.22.1	15.08.2026	iOS ana ekran modunda alt menünün ekranın dibine tam oturması sağlandı (viewport-fit=cover kaldırıldı)
v1.22.0	12.08.2026	Kasa hareketi bildirimleri: kasanızı paylaştığınız kişi bir kayıt eklediğinde/değiştirdiğinde uygulama kapalıyken de bildirim alırsınız (Ayarlar → Bulut Yedekleme'den açılır). Play sürümü için FCM, iOS ana ekran uygulaması ve tarayıcılar için Web Push kullanılır — bildirim yalnızca kimin ne tür işlem yaptığını taşır, finansal veri içermez. Ayrıca havl vade hatırlatması Play sürümünde de artık gerçekten çalışıyor (eksik olan bildirim eklentisi kuruldu)
v1.21.x	10.08.2026	Servet geçmişi grafiği yenilendi: noktalar gerçek tarihe göre yerleşiyor (eskiden dizi sırasına göreydi, 3 günlük boşluk ile 30 günlük boşluk aynı görünüyordu), parmakla sürükleyerek günlük değer okuma, 1 Ay/3 Ay/Tümü aralıkları, bugünkü nisab çizgisi, en düşük–en yüksek işaretleri. Ayrıca: script bozulursa boş ekran yerine çıkan kurtarma ekranı, iOS/Android'de grafikte seçim ve bağlam menüsünün engellenmesi, yeni cihazda bulut verisinin yeniden denenmesi (v1.21.1–.2), hareket geçmişi temizliğinin kalıcı ve tüm cihazlara yayılan hale gelmesi (v1.21.3)
v1.20.x	10.08.2026	Hareket geçmişi: kasadaki her ekleme/güncelleme/silme kim ve ne zaman bilgisiyle kaydedilir, karşı taraf değişiklik yapınca bildirim çıkar, Ayarlar → Hareketler'den görüntülenir. Üyelik bekçisi ile kasa daveti ve kasadan çıkarılma 20 saniye içinde algılanır (v1.20.1), hareketler kişi başlığı altında gruplanır (v1.20.2), ayrılan üye "(ayrıldı)" olarak işaretlenir ve geçmiş temizlenebilir (v1.20.3)
v1.19.x	10.08.2026	Paylaşılan kasalar: verileri eşinizle/ortağınızla paylaşma (Düzenleyen/İzleyici yetkileri, e-posta ile davet), birden çok kasa arası geçiş, Realtime ile anında senkron, kayıt bazlı birleştirme sayesinde çift taraflı düzenlemede veri kaybının önlenmesi, hesap silmede kasa sahipliğinin devri. Davet kabul edilince "kasaya geç" penceresi (v1.19.1), kasadan çıkarılan kişinin cihazındaki kopyanın silinmesi (v1.19.2), oturumsuz kullanıp sonradan giriş yapana bulut kasası teklifi (v1.19.3)
v1.18.0	29.07.2026	Borç/alacak ↔ varlık aktarımı: yeni kayıt, ödeme ekleme ve "ödendi" işaretlemede ilgili varlık kaydı seçilerek otomatik güncellenir
v1.17.0	28.07.2026	Çevrimdışı çalışma (service worker + manifest); bulut senkron durumu ve başarısız yedekleme uyarısı; havl vade hatırlatıcısı (bildirim); kur tazeliği göstergesi ve eski kur uyarısı
v1.16.1	28.07.2026	Logo yenilendi: uygulama içi, tarayıcı sekmesi ve ana ekran ikonu 512.png görseliyle güncellendi
v1.16.0	24.07.2026	Play Store gereksinimleri: uygulama içinden kalıcı hesap silme (Supabase Edge Function ile) ve web'den erişilebilen gizlilik politikası sayfası eklendi
v1.15.2	24.07.2026	Ana ekran ikonu iclogo.png ile güncellendi; Capacitor ile Android APK kabuğu hazırlandı; APK içinden Google girişi için deep-link akışı eklendi
v1.15.1	23.07.2026	Ana ekran (apple-touch-icon) logosu açık renkli logo2 görseliyle güncellendi
v1.15.0	23.07.2026	Üst yeşil başlık akıştan çıkarıldı: sayfa kaydırılınca içerik doğrudan başlığın arkasına doğru kayıyor; başlık yüksekliği biraz azaltıldı ve altındaki krem kemer inceltildi
v1.14.8	23.07.2026	Logolar yenilendi: uygulama içi ve tarayıcı/GitHub sekme ikonu iclogo, ana ekran (apple-touch-icon) logosu ayrı logo2 görseli oldu
v1.14.7	22.07.2026	Alt menü hizasının düzeldiği doğrulandı; Ayarlar'daki geçici "Ekran Tanılama" kartı kaldırıldı
v1.14.6	22.07.2026	Alt menünün iOS'ta ekranın dibine oturmaması kesin olarak çözüldü: kök neden black-translucent status bar ayarıydı (sayfa ekranın tepesinden başlıyor ama yüksekliği eksik bildiriliyordu, dipte 59pt ölü bant kalıyordu)
v1.14.4	22.07.2026	Alt menünün iOS'ta ekranın dibine oturmayıp yukarıda kalması kesin olarak düzeltildi: yüksekliği JS ile ölçme yöntemi kaldırıldı, kabuk CSS ile doğrudan ekrana sabitleniyor
v1.14.3	22.07.2026	iOS ana ekranda ilk açılışta alt menünün yukarıda kalması yeniden düzeltildi (yükseklik ~2,5 sn boyunca her karede ölçülüp en büyük değer uygulanıyor)
v1.14.2	22.07.2026	Açılışta kur çekme artık her seferinde değil, son başarılı çekimden 3 saat geçtiyse yapılıyor — gereksiz ağ isteği azaltıldı
v1.14.1	22.07.2026	iOS ana ekranda soğuk açılışta alt menünün yukarıda kalması düzeltildi: pencere yüksekliği load/orientationchange olaylarında ve gecikmeli olarak yeniden ölçülüyor
v1.14.0	22.07.2026	Veri kaybı koruması: açılışta bulut önce okunur, boş yerel veri dolu bulut yedeğinin üzerine asla sessizce yazılmaz; günlük otomatik yerel yedekler (son 7 gün, Ayarlar'dan geri yüklenebilir); iOS ana ekrandan silmenin verileri sildiği uyarısı
v1.13.0	22.07.2026	iOS ana ekran (standalone) modunda menü düğmelerinin altına basma gerektirmesi ve yeniden açılışta alttaki boşluk kesin çözüldü: flexbox uygulama kabuğuna geçildi
v1.12.1	22.07.2026	iOS'ta alt gezinme çubuğunun altındaki boşluk giderildi; Ayarlar'da sürüm numarası rozet olarak öne çıkarıldı
v1.12.0	21.07.2026	Kaydırma mimarisi yeniden yapıldı: tek kaydırıcı #app kabı (Android Chrome tek parmak kaydırma sorununun kesin çözümü); üst bar sticky
v1.11.3	21.07.2026	Bazı Android cihazlarda dokunmatik algılamanın başarısız olup kaydırmayı tamamen dondurduğu sorun için ek "pointer: coarse" kontrolü eklendi
v1.11.2	21.07.2026	Android'de bazı ekranlarda kaydırmanın kesikli/donuk çalışmasına yol açan fare tekerleği düzeltmesi artık sadece dokunmatiği olmayan cihazlarda devrede; Ayarlar'da logonun altına Bakara Suresi 110. ayet eklendi
v1.11.1	21.07.2026	Bulut Yedekleme bölümü Ayarlar'da program bilgisinin altına taşındı, tarih alanı büyüklük sorunu tekrar düzeltildi
v1.11.0	21.07.2026	Popup pencerelere kapatma (✕) düğmesi, tarih giriş alanı taşma düzeltmesi, varlıklara alış tarihi ve emanetlere tarih alanı eklendi
v1.10.1	21.07.2026	Oturum yenilemede geçici ağ hatalarında artık gereksiz çıkış yapılmıyor
v1.10.0	20.07.2026	Bulut senkronu otomatik hale geldi: açılış, sekme odağı ve 20 sn'lik periyotlarla sessiz kontrol/çekme
v1.9.1	20.07.2026	Varlık türü dökümü rozet (chip) tasarımıyla güncellendi
v1.9.0	20.07.2026	Varlıklar sekmesine tür bazlı döküm eklendi
v1.8.0	20.07.2026	Borç/Alacak toplam kartlarına para birimi/ürün bazlı döküm eklendi
v1.7.1	20.07.2026	Borç/alacak liste satırı sadeleşti: sadece kalan tutar kalın gösteriliyor
v1.7.0	20.07.2026	Borç/Alacak sekmesinde "Emanetler" bölümü: zekâta dahil olmayan emanet para/altın kayıtları, kısmi iade takibiyle
v1.6.0	20.07.2026	İsteğe bağlı bulut yedekleme: Google ile giriş, Supabase üzerinde senkron
v1.5.0	20.07.2026	Popup pencereler ortalanmış modal olarak açılıyor, silme onayları uygulama içi popup ile yapılıyor, Ayarlar'dan sürüm geçmişi kaldırıldı, açılışta kurlar otomatik güncelleniyor
v1.4.0	20.07.2026	Borç/alacaklarda kısmi ödeme takibi ve düzenleme, nisab 80 grama güncellendi, 22 ayar gram altın seçeneği, TL simgesi ikonu, ayarlar sayfası düzeni, mouse ile kaydırma düzeltmesi
v1.3.0	19.07.2026	Altın varlıklarda has karşılığı gösterimi, toplam has altın ve 85 g nisabla karşılaştırma
v1.2.0	19.07.2026	Borç/alacakta tüm altın çeşitleri ve gümüş, zekâtta ödenen/kalan takibi, Chrome sayfa uzaması düzeltmesi
v1.1.0	19.07.2026	Kamerî yıl (havl) takibi, ayarlı ziynet altınları (22/18/14), Ata altın, gizlilik modu, servet geçmişi grafiği, sürüm geçmişi
v1.0.0	19.07.2026	İlk sürüm: varlık takibi, zekât hesabı, borç/alacak takibi, kur çekme, JSON yedekleme

---