Perakende Satış & Cari Takip/● Yayında / Pilot

BizimVeresiye

Küçük Esnaf İçin İnternetsiz Çalışan Veresiye Defteri ve Barkodlu Satış

Ürün Sitesine Gitbizimveresiye.com.tr
Platform
Windows 10/11
Çevrimdışı Veritabanı
SQLite
Pilot Sürüm
58
Ücretsiz Deneme (Gün)
30
01 // CONTEXT & PROBLEM

Operasyonel 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.

02 // TOPOLOGY & ARCHITECTURE

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.

SYSTEM_DATA_FLOW_MAP
┌───────────────────────────────────────────────────────────────────────────┐
│ 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           │
└───────────────────────────────────┘   └───────────────────────────────────┘
Masaüstü (WPF)01

Klavye odaklı satış ve yönetim ekranları; ViewModel'ler yalnızca uygulama servisleriyle konuşur, DbContext'e hiç dokunmaz

WPFMVVM.NET 8
Uygulama ve Alan Katmanı02

Satış tamamlama, veresiye limiti, tahsilat, iade dağıtımı, kasa vardiyası ve stok sayımı kuralları; arayüz ve veritabanı olmadan test edilebilir

C#xUnit
Yerel Veri Katmanı03

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

EF Core 8SQLitePBKDF2
Bulut ve Dağıtım04

Outbox'tan beslenen, PostgreSQL üzerinde isteğe bağlı senkron API'si; bulut yedek, lisans aktivasyonu ve doğrulamalı otomatik güncelleme

ASP.NET CorePostgreSQLInno Setupnginx
03 // TRADEOFF ANALYSIS

Mühendislik Kararları

Önce İnternetsiz, Bulut Ek Modül

Rationale

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.

Değerlendirilen Ödünleşimler (Trade-offs)

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

Rationale

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.

Değerlendirilen Ödünleşimler (Trade-offs)

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ı

Rationale

Yoğun tezgâhta çift tıklama, donan ekran ve tekrar deneme olağandır.

Değerlendirilen Ödünleşimler (Trade-offs)

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.

04 // COMPLEXITY RESOLUTION

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.

↳ Engineered Solution

İ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.

↳ Engineered Solution

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.

05 // CODE & STACK

Teknoloji Yığını

Masaüstü
  • • WPF
  • • MVVM
  • • .NET 8
Veri
  • • EF Core 8
  • • SQLite
  • • PostgreSQL
Bulut
  • • ASP.NET Core
  • • JWT
  • • nginx
  • • Ubuntu
Dağıtım
  • • Inno Setup
  • • OTA Updater
  • • GitHub Releases
Test
  • • 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ı
06 // PRODUCTION UI & SCREENSHOT EVIDENCE

Ürün Ekran Görüntüleri & Canlı Saha Arayüzü

Sistemin canlı üretim ortamındaki arayüzü, telemetri göstergeleri ve operasyon panelleri.

https://bizimveresiye.com.tr
SYSTEM TOPOLOGY // OFFLINE-FIRST POS
BizimVeresiye: İnternetsiz Satış Akışı ve Bulut Modülü
Click to inspect full resolution

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.

FIGURE 01
07 // VERIFICATION & RESULTS

Sonuçlar ve Mevcut Durum

Yayında (1.0.0 pilot)

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ı.

↳ Otomatik güncelleyiciyle dağıtılan 58 pilot sürüm
↳ Alan, uygulama ve entegrasyon katmanlarında 600+ otomatik xUnit testi
↳ Tamamen internetsiz çalışır; internet yalnızca güncelleme ve isteğe bağlı bulut modülü için

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.