Fiş Takip

Para & Defter

Fişin fotoğrafını çek. Mağaza, tarih, ürünler ve tutar kendiliğinden yerine otursun.

Uygulamayı aç ↗⬇ APK indir GitHub ↗

Fişin fotoğrafını çek. Mağaza, tarih, ürünler ve tutar kendiliğinden yerine otursun.

Tek bir HTML dosyası. Kurulum yok, sunucu yok, hesap yok.

Canlı dene · Başla · Okuma motorları · Bütçe & fiyat · Gizlilik

Ne yapar

Türk market ve mağaza fişlerini okuyup harcamanı defterler. Fişi tarar, içindekileri çıkarır, kategorisini bulur, aylık ve yıllık dökümünü tutar.


📷 Fiş okuma	Dört ayrı motor. Biri cihazda çalışır, fiş verisi dışarı çıkmaz.
🏬 Mağaza birleştirme	"LC WAIKIKI" ile "LC Waikiki" tek mağaza sayılır. 40+ Türk markası tanınır.
🗂 Otomatik kategori	Gıda, Ev & Yaşam, Kıyafet, Yakıt, Eczane ve 4 kategori daha. Yapay zekâ listede olmayan bir kategori uydurursa en yakınına eşlenir.
📒 Defterler	Kategoriden bağımsız ikinci ayrım: İşyeri, Ev ya da kendi koyduğun isim.
✂️ Satır ayıklama	Sana ait olmayan ürünü fişten çıkar; tutarı toplamdan düşülür, geri alınabilir.
💳 Ödeme takibi	Kredi kartı / nakit ayrımı, dağılımıyla birlikte.
📊 Aylık seyir	6 aylık grafik, geçen aya kıyas, mağaza ve kategori dökümü.
🎯 Kategori bütçesi	Aylık üst sınır koy; %80'de uyarır, aşınca fiş kaydederken haber verir.
📈 Ürün fiyat takibi	Aynı ürünün birim fiyatı zaman içinde nasıl değişti — geçmişi ve eğrisiyle.
🔍 Arama	Mağaza, ürün adı, kategori, defter ve ödeme şeklinde filtreleme. Türkçe karakterden bağımsız — `bim` yazınca BİM bulunur.
📗 Excel çıktısı	7 sayfalı `.xlsx` — fişler, defter, kategori, mağaza, ödeme, aylık özet, ürün fiyatları. Fiş toplamı ve çıkarılan tutar ayrı sütunlarda.
💾 Yedekleme	JSON al-ver. Cihaz değiştirince veri taşınır.
📴 Çevrimdışı açılış	Web sürümü bir kez açıldıktan sonra internet yokken de son kopyadan açılır.
🌙 Karanlık mod	Telefonun ayarına göre kendiliğinden.

Fiş okunamazsa elle de girebilirsin; yanlış okunan alanı kaydetmeden Düzelt ile, kaydettikten sonra fişe dokunup Düzenle ile değiştirirsin. Yanlış fotoğraf seçtiysen Başka fotoğraf seç ile baştan alırsın.

Kullanmaya başla

kamilsaim.github.io/Fistakip adresini aç. Kurulum, hesap, izin yok.

iPhone'da Paylaş → Ana Ekrana Ekle, Android'de menü → Uygulamayı yükle dersen ana ekrana fiş logosuyla iner ve adres çubuğu olmadan açılır.

Okuma motorları

Ayarlar ⚙️ menüsünden seçilir. Anahtarlar kodun içine değil, cihazın yerel hafızasına yazılır — depo herkese açık kalabilir.

Motor	Doğruluk	Ücret	Kota	Anahtar
Yerel OCR	Orta	Ücretsiz	Sınırsız	Gerekmez
Gemini ⭐	Yüksek	Ücretsiz	~1.500/gün	AI Studio
Claude	Yüksek	~$0,003/fiş	—	Console
OCR.space	Orta-yüksek	Ücretsiz	25.000/ay	ocr.space

Gemini önerilir — ücretsiz katmanı var, kredi kartı istemez, fişi yalnız okumakla kalmaz anlar da.

Gemini'de model erişimi hesaba göre değişir. Uygulama 404 alırsa anahtarının erişebildiği modelleri kendisi listeler, uygun olanı seçer ve kaydeder. Ayarlardan elle de seçebilirsin.

Claude'da Haiku 4.5 (varsayılan, fiş için yeterli) ya da Sonnet 5.5 seçilir. Gemini ve Claude'a fotoğraf ~3,5 MB JPEG'e küçültülerek gider; sunucu yoğunsa (503/529) uygulama birkaç kez kendiliğinden tekrar dener.

Yerel OCR nasıl çalışıyor?

Tesseract.js tarayıcıda çalışır — fotoğraf hiçbir sunucuya gitmez. Öncesinde görüntü işlenir: gri tonlama, histogram gerdirme, yumuşak eşikleme ve 2,5× büyütme. Ardından çıkan metin Türk fişlerine göre yazılmış bir ayrıştırıcıdan geçer:

1.250,00 → 1250.00 (Türk sayı biçimi)
TOPKDV ile TOPLAM ayrımı
Ticari unvan temizliği (LTD, ŞTİ, SAN., TİC.)
Adres, VD/VN, POS no, onay kodu, EKÜ satırlarının elenmesi
Ürün satırlarının tutar sütununa göre çıkarılması

İlk taramada Türkçe dil paketi (~2 MB) iner, sonra önbellekte kalır.

Bütçe ve fiyat takibi

İkisi de Özet sekmesinde, ayrıca bir şey açmadan.

Aylık bütçe. Düzenle'ye dokun, takip etmek istediğin kategoriye üst sınır gir — boş bıraktığın kategori izlenmez. Kategorilerin üstünde ayrıca tüm harcama için ortak bir sınır konabilir. Satır limitin %80'ine gelince turuncuya, aşılınca mali kırmızıya döner ve AŞILDI damgası alır. Fişi kaydettiğin an ilgili limit aşıldıysa uygulama haber verir. Limitler yedeğe dahildir.

Fiyat seyri. Aynı ürünü ikinci kez alınca listede çıkar. Karşılaştırma birim fiyat üzerinden yapılır (satır tutarı ÷ adet), yani 4'lü aldığın sütle tek aldığın süt aynı ölçekte. Satırda kaç kez alındığı, en düşük–en yüksek aralık, ilk alıştan bugüne değişim ve minik fiyat eğrisi durur; dokununca hangi tarihte hangi mağazada kaça aldığın ve önceki alışa göre kaç lira fark ettiği açılır.

Ürün adları eşleştirilirken gramaj ve adet ekleri temizlenir — SÜT 1 LT, Süt 1lt ve süt 1 LT tek üründür. Bu yüzden farklı gramajlar da aynı sayılabilir; ayrıştırıcı ürün satırı çıkarmayan bir fişte (ör. akaryakıt) fiyat takibi olmaz.

Defterler

Kategori ne aldığını söyler, defter hangi bütçeden çıktığını. Aynı market fişi kategori olarak Gıda kalır ama İşyeri ya da Ev defterine gider; ikisi birbirine karışmaz.

Kutudan iki defter çıkar — İşyeri ve Ev. Ayarlar → Defterler'den adını, simgesini ve rengini değiştirebilir, yenisini ekleyebilirsin (Araba, Yazlık, Ortak kasa…). Bir defterin adını değiştirince o defterdeki fişler de taşınır; sildiğinde fişler silinmez, Ayrılmamış olur.

Fişi tararken kaydetmeden önce defterini seçersin; en son kullandığın defter bir sonraki fişte hazır gelir. Sonradan değiştirmek için fişe dokunup alttaki defter çiplerinden birini seç. Fişler sekmesinde deftere göre süzer, seçili defterin fiş sayısını ve toplamını başlıkta görürsün; Özet'te defterlerin ayrı ayrı dağılımı, Excel'de ayrı bir Defter Özeti sayfası çıkar.

Satır ayıklama

Bir fişteki her ürün sana ait olmayabilir — arkadaşına aldığın, iade ettiğin ya da işyerine yazılması gereken satırlar. Ürün satırının sağındaki ✕ ile satırı çıkarırsın: satır Çıkarılanlar'a düşer ve tutarı fişin toplamından düşülür, yani harcamana yazılmaz.

Ayıklama hem tarama sonucunda (kaydetmeden önce) hem de kayıtlı bir fişe dokununca açılan detay penceresinde çalışır. Çıkarılan satırın yanındaki ↺ ile geri alırsın; hepsini geri alırsan fiş ilk haline döner.

Fişin kendi toplamı kaybolmaz: altta Fiş toplamı ₺300,00 · 2 satır çıkarıldı −₺200,00 · kalan ₺100,00 satırı durur, Excel'de de Fiş Toplamı ve Çıkarılan ayrı sütunlardır. Özet, bütçe ve fiyat takibi kalan tutarla çalışır.

Gizlilik

Fişler cihazdan çıkmaz. Hepsi tarayıcının localStorage'ında durur. Sunucu yok, hesap yok, analitik yok.
Yerel OCR'da hiçbir veri ağa çıkmaz.
Yapay zeka motorlarında fotoğraf yalnız senin seçtiğin sağlayıcıya gider. Gemini'nin ücretsiz katmanında Google, gönderilen veriyi model eğitiminde kullanabilir — hassas fişler için ücretli katmana geç ya da yerel OCR kullan.
API anahtarları cihazda kalır, depoya asla yazılmaz.

[!WARNING] Veriler tarayıcı hafızasında olduğu için iOS Safari, uzun süre açılmayan sitelerin verisini silebilir. Ayarlar → Yedek al ile ara sıra JSON yedeği çıkar.

Nasıl çalışır

Tek bir index.html. Derleme aracı, paket yöneticisi, node_modules yok. Kütüphaneler yalnız gerektiğinde CDN'den çekilir:

Kütüphane	Ne zaman iner	Ne için
Tesseract.js	Yerel OCR ilk kullanımda	Cihazda metin okuma
SheetJS	Excel çıktısı alınırken	`.xlsx` üretimi

Uygulama açılırken hiçbiri inmez.

Yanında duran diğer dosyalar: ana ekran ikonu (icon-512.png), manifest.webmanifest, logo varyantları ve sw.js — web sürümünü çevrimdışı açan küçük bir service worker (ağ önce çalışır, güncellemeyi geciktirmez; API çağrılarını önbelleğe almaz, APK'da devre dışı). Uygulama mantığının tamamı index.html içinde.

Tasarım

Tasarım dili konunun kendisinden alındı: termal fiş kağıdı.

Zemin krem değil, fiş kağıdının soğuk gri-yeşili. Mürekkep saf siyah değil, termal yazıcının isli karası. Kartların altı yırtık, tutarlar monospace sütunda hizalı.

Tek vurgu rengi mali damga kırmızısı ve anlam taşıyor: logodaki kırmızı satır fişin toplamı.

Rol	Hex
Termal is	`#1A2320`
Mali kırmızı	`#BD2731`
Termal kağıt	`#E7EAE8`
Fiş beyazı	`#FBFCFB`
Çizgi grisi	`#C9D2CE`
Karbon (koyu tema)	`#0F1211`

Yazı tipleri — Bricolage Grotesque (başlık), Archivo (metin), DM Mono (rakam ve etiket).

Logo ailesi ve kullanım kuralları: logo-kilavuz.html

Yol haritası

Ürün fiyat takibi — aynı ürünün zaman içindeki fiyat değişimi (v1.2.0)
Kategori bazlı aylık bütçe ve limit uyarısı (v1.2.0)
Defterler — iş / ev gibi ikinci bir ayrım (v1.3.0)
Fişten ürün satırı çıkarma — tutarı toplamdan düşerek (v1.4.0)
Kayıtlı fişi düzenleme, çevrimdışı açılış (v1.4.1)
Taksitli alışveriş takibi
Fiş fotoğrafının kayda iliştirilmesi
Çoklu cihaz eşitleme (isteğe bağlı, kendi sunucunla)

Katkı

Sorun bildirimi ve öneri için issue aç.

Tanınmayan bir mağaza varsa STORE_ALIASES dizisine, kaçırılan bir kategori varsa CATS dizisine eklemek yeterli — ikisi de index.html içinde.

Telif

Bu depoda açık kaynak lisansı yoktur. Kod herkese açık olarak görüntülenebilir; kopyalamak, değiştirmek, dağıtmak veya kendi ürününde kullanmak için yazılı izin gerekir.