BizimVeresiye
Küçük Esnaf İçin İnternetsiz Çalışan Veresiye Defteri ve Barkodlu Satış
Ürün Sitesine Gitbizimveresiye.com.trOperasyonel Problem
Bağlam ve Sektörel Dinamikler
Türkiye'de bakkal, market, büfe ve iletişim mağazaları gibi küçük işletmeler düzenli müşterilerine hâlâ veresiye verir ve bunu kâğıt deftere yazar. Mevcut programlar ya iki kişilik bir dükkân için fazla ağır ERP paketleri ya da dükkânın interneti gidince çalışmayan bulut abonelikleri. Bu dükkânların çoğunun eski masaüstü programlarında yıllardır biriken ve kaybetmeyi göze alamayacağı bakiyeleri de var.
Genel Bakış
Veresiye defteri paradır. Stoğu düşürüp kasaya yansımayan bir satış, satışı iki kez kaydeden bir çift tıklama ya da aslında borcu olan müşteriye nakit iade eden bir iade, gerçek müşterilerle gerçek anlaşmazlıklara dönüşür. Üstelik hepsinin tezgâh arkasındaki sıradan bir Windows bilgisayarda, internet olsa da olmasa da, bilgisayarla arası iyi olmayan kişiler tarafından kullanılarak çalışması gerekir.
Sistem Mimarisi
BizimVeresiye internetsiz öncelikli tasarlandı: ürünün tamamı yerel SQLite veritabanı üzerinde çalışır ve hiçbir işlem ağı beklemez. Her iş işlemi (satış, veresiye satış, tahsilat, iade, stok sayımı, kasa hareketi) belgeyi, stok, kasa ve cari hareketlerini, denetim kaydını ve bir SyncOutbox olayını birlikte yazan tek bir EF Core işlemidir. Parasal kayıtlar asla silinmez; iptal ve iadeler ters hareket yazar. İsteğe bağlı bulut modülü outbox'tan beslenerek verileri dükkândaki bilgisayarlar arasında paylaştırır ve raporları telefonda gösterir.
┌───────────────────────────────────────────────────────────────────────────┐
│ WPF MASAÜSTÜ (.NET 8 · MVVM · klavye odaklı satış ekranı) │
│ barkod kuyruğu · cari · stok · kasa vardiyası · raporlar │
└─────────────────────────────────────┬─────────────────────────────────────┘
│ Uygulama servisleri (OperationResult)
▼
┌─────────────────────────────────────┴─────────────────────────────────────┐
│ HER İŞLEM TEK EF CORE TRANSACTION (SQLite, yerel) │
│ Satış + Kalemler · Ödeme · Stok Hareketi · Kasa Hareketi │
│ Cari Hareket · Denetim Kaydı · SyncOutbox (Bekliyor) │
│ LocalTransactionId tekil indeks → tekrar deneme satışı çoğaltmaz │
└─────────────────┬───────────────────────────────────────┬─────────────────┘
│ günlük │ HTTPS, internet varsa
▼ ▼
┌─────────────────┴─────────────────┐ ┌─────────────────┴─────────────────┐
│ YEREL YEDEK │ │ BULUT MODÜLÜ (isteğe bağlı) │
│ .bksbackup · SHA-256 · bütünlük │ │ ASP.NET Core API · PostgreSQL │
│ USB / OneDrive klasörü │ │ ortak veri · telefondan rapor │
│ RestoreTool ile atomik geri yükle │ │ Türkiye'de barındırılır │
└───────────────────────────────────┘ └───────────────────────────────────┘Klavye odaklı satış ve yönetim ekranları; ViewModel'ler yalnızca uygulama servisleriyle konuşur, DbContext'e hiç dokunmaz
Satış tamamlama, veresiye limiti, tahsilat, iade dağıtımı, kasa vardiyası ve stok sayımı kuralları; arayüz ve veritabanı olmadan test edilebilir
Migration tabanlı SQLite veritabanı; işletme, şube, kasa ve cihaz kavramları ilk günden yerleşik; yedekleme, geri yükleme ve sağlık kontrolleri
Outbox'tan beslenen, PostgreSQL üzerinde isteğe bağlı senkron API'si; bulut yedek, lisans aktivasyonu ve doğrulamalı otomatik güncelleme
Mühendislik Kararları
Önce İnternetsiz, Bulut Ek Modül
Modem yeniden başladı diye dükkân satışı durduramaz; birçok esnaf da müşterilerinin borç bilgisinin başkasının sunucusunda durmasını istemez.
Birden fazla bilgisayar için bulut modülü ve ortak canlı veritabanı yerine outbox tabanlı senkron gerekir; buna karşılık temel ürün ilk gün yalnızca bir Windows bilgisayarla çalışır.
Silinmeyen Para Kayıtları, Hareketlerden Hesaplanan Bakiye
Esnaf anlaşmazlığı müşterinin geçmişini satır satır okuyarak çözer; düzenlenmiş ya da silinmiş tek bir satır bu güveni bitirir.
Satış, ödeme ve cari satırları asla silinmez; iptal ve iadeler ters hareket yazar. Müşteri bakiyesi her zaman hareketlerinin toplamına eşit olmalıdır; bütünlük kontrolü 0,01 TL üstündeki her sapmayı sessizce düzeltmek yerine raporlar.
Her Yazma İşleminde Tekrar Koruması
Yoğun tezgâhta çift tıklama, donan ekran ve tekrar deneme olağandır.
Her satış, tahsilat, iade ve stok hareketi tekil indeksli bir LocalTransactionId taşır; aynı işlem tekrar denendiğinde ikinci kez kaydedilmez, ilk sonucu döner. Bedeli tablo başına bir kolon ve bir indeks.
Teknik Zorluklar ve Çözümler
Veresiye Satışlarda İade
Müşteri bir kısmını veresiye, bir kısmını nakit ödeyerek alışveriş yapar, sonra ürünlerin bir kısmını iade eder. Önce nakit iade etmek, dükkâna hâlâ borcu olan birine para vermek demektir.
İade dağıtım servisi iadeyi önce veresiye kısmına, sonra nakde, en son karta uygular ve önceki iadeleri düşer. Kısmi iadelerde satır indirimi oransal bölünür; kalan miktarın tamamı iade edilirken kalan net tutar doğrudan kullanılır, böylece yuvarlama yüzünden cari hesapta kuruş farkı kalmaz.
Kimsenin Bakmadığı Dükkân Bilgisayarlarını Güncellemek
Bazı güncellemeler, kilitli kalan bir DLL yüzünden yarım uygulanıyordu ve esnafın kurulumu elle onarması beklenemez.
Güncelleyici her güncellemeden önce yedek alır, kurulum dosyasının SHA-256 değerini ve boyutunu HTTPS manifestinden doğrular, uygulama kapandıktan sonra kurulumu çalıştırır. Kurulum, kilitli dosya tutan süreçleri Windows Restart Manager ile kapatır; güncelleyici de kurulumdan önce hedef dosyaların gerçekten serbest olduğunu kontrol eder.
Teknoloji Yığını
- • WPF
- • MVVM
- • .NET 8
- • EF Core 8
- • SQLite
- • PostgreSQL
- • ASP.NET Core
- • JWT
- • nginx
- • Ubuntu
- • Inno Setup
- • OTA Updater
- • GitHub Releases
- • xUnit
- • Entegrasyon testleri
Kritik Uygulama Detayları
- Barkod okutmaları semaforlu bir kuyruktan geçer; art arda hızlı okutmalar kaybolmaz
- Fiyat ve stok satış işleminin içinde yeniden okunur; eski kalmış bir ekran eski fiyattan satış yapamaz
- Müşteri limitini aşacak satışlarda onay adımı olan veresiye limitleri
- Yedekler manifest, SHA-256 ve SQLite bütünlük kontrolü içeren zip paketleridir; geri yükleme veritabanını atomik olarak değiştiren ayrı bir araçla yapılır
- Eski programlardaki müşteri bakiyelerini müşteri müşteri doğrulayarak aktaran içe aktarma araçları
Ürün Ekran Görüntüleri & Canlı Saha Arayüzü
Sistemin canlı üretim ortamındaki arayüzü, telemetri göstergeleri ve operasyon panelleri.
BizimVeresiye: İnternetsiz Satış Akışı ve Bulut Modülü
Her satış, ödeme, stok değişimi, kasa hareketi ve veresiye kaydı tek bir yerel SQLite işleminde yazılır. Bulut isteğe bağlıdır ve yalnızca outbox üzerinden beslenir.
Sonuçlar ve Mevcut Durum
BizimVeresiye, bizimveresiye.com.tr adresinde 30 gün tam özellikli deneme ve bilgisayar başına tek seferlik lisansla satışta. Pilot dükkânlar güncellemeleri otomatik alıyor; şu ana kadar 58 pilot sürüm yayınlandı.
Kazanılan Mimari Deneyimler
- 01.Veresiye ürününde asıl özellik veri bütünlüğüdür: tekrar koruması ve silinmeyen para kayıtları her ekrandan daha önemlidir.
- 02.İnternetsiz öncelikli tasarım, senkron öncelikli tasarımdan daha kolay güven kazanır; bulut çalışan bir ürüne eklenmeli, onu ayakta tutan şey olmamalı.
- 03.Kimsenin bakmadığı dükkân bilgisayarlarında güncelleyici de ürünün parçasıdır: sık sürüm çıkarmayı güvenli kılan, yedek adımı ve doğrulanmış kurulum dosyalarıdır.