Problem
Yapı malzemesi satışında fiyatlar sık değişir, aynı ürün farklı müşterilere farklı iskonto ve vadeyle satılır, sipariş tek seferde değil şantiyenin ilerleyişine göre parça parça sevk edilir. Kum tonla alınıp metreküple satılır, çimento paletle gelip çuvalla çıkar. Genel amaçlı CRM'ler bu dinamikleri karşılamıyor; büyük ERP'ler ise küçük ve orta ölçekli bir bayi için fazla ağır ve pahalı.
Çözüm
Bir bayinin günlük işini (talep, teklif, sipariş, sevkiyat, faturalama, tahsilat, stok ve cari hesap) tek bir uygulamada toplayan, yerel ağda çok kullanıcılı çalışan bir masaüstü uygulaması. Ön muhasebe ve e-Belge de dahil.
Durum: v1.0 tamamlandı; teklif → sipariş → fatura → tahsilat zinciri uçtan uca çalışıyor. Sırada e-Fatura gönderimi için entegratör bağlantısı ve e-İrsaliye var.
Uçtan uca iş akışı
Talep → Teklif → Sipariş → İrsaliye → Fatura → Tahsilat
│ │ │ │ └─ fatura kendiliğinden "Kısmi ödendi / Ödendi"
│ │ │ └─ "Kesildi" → cari hesaba borç
│ │ └─ "Sevk edildi" → stoktan düşer
│ └─ onay: eşik üstü iskonto / risk limiti aşımı
└─ revizyon zinciri, süresi dolunca otomatik kapanır
- Her dönüşüm kısmi olabilir; sistem her satırın ne kadarının sevk edildiğini ve faturalandığını izler.
- Taslak belge numara almaz, stoğa ve cariye dokunmaz. Numaralı belgeler silinmez, ters kayıtla iptal edilir.
- Sipariş sevk durumu elle seçilmez, irsaliyelerden türetilir.
Roller
| Rol | Kapsam |
|---|---|
| Yönetici | Her şey; kullanıcılar, ayarlar, yedek, maliyet/kârlılık, onay kararları, denetim kaydı |
| Muhasebe | Fatura, alış faturası, tahsilat, cari hesap ve risk limiti, raporlar |
| Satış Temsilcisi | Yalnızca kendi carileri, teklifleri ve siparişleri |
| Üretim | Sipariş durumu, irsaliye, stok hareketi ve sayım |
| Görüntüleyici | Salt okuma |
Yetkisi olmayan ekranlar menüde hiç görünmez.
Modüller
Satış: talepler (telefon, şantiye ziyareti, e-posta, tezgâh kaynaklı; kartı olmayan kişi aday olarak kaydedilir), teklifler (Excel'den satır yapıştırma, PDF ve e-posta), siparişler (liste ve durum panosu), irsaliyeler (plaka, şoför bilgisi, fiyatsız çıktı), faturalar ve iadeler (siparişten, irsaliyeden ya da birden çok irsaliyeden toplu).
Alış: alış faturaları ve iadeleri. Maliyet hareketli ağırlıklı ortalamayla güncellenir, aynı tedarikçi faturası iki kez girilemez, gelen e-Faturadan taslak alış faturası açılır.
Finans: tahsilat ve ödeme (havale/EFT, nakit, kart, çek, senet, mahsup; "en eskiden dağıt"), çek/senet portföyü (tahsil, ciro, karşılıksız, iade), MT940 / CAMT.053 banka ekstresi içe aktarma ve otomatik cari önerisi, mutabakat mektupları.
Kayıtlar: cariler (VKN/TCKN sağlama kontrolü, çoklu adres ve ilgili kişi, Türkçe/İngilizce belge dili, varsayılan iskonto, risk limiti, KVKK silme), ürünler (ikincil birim ve dönüşüm katsayısı, kritik stok), stok (rezerve ve kullanılabilir miktar, değiştirilemez hareket defteri, sayım, depo bazında görünüm).
Araçlar: onaylar, raporlar, 5 adımlı Excel içe aktarma sihirbazı (eşleme profili, prova doğrulama, geri alma), her listeden dışa aktarma, denetim kaydı.
Sektöre özgü detaylar
- Birim dönüşümü: kum M³ ↔ TON, çimento PALET ↔ ÇUVAL, Ø12 demir BOY ↔ KG. Satırların altındaki sevkiyat özeti araç planlamasını kolaylaştırır.
- Nakliye ayrı kalem; iskontoya girmez, kendi KDV oranıyla hesaplanır.
- Renk / ton kodu gerektiren ürünlerde (ör. boya) kod girilmeden satır kaydedilmez.
- İskonto: satır ve belge düzeyinde, müşteriye özel varsayılan oranla. Eşik üstü iskonto yönetici onayına düşer.
- Kur: TRY dışındaki belgelerde TCMB kuru önerilir ve belge anında dondurulur.
- Risk limiti: bakiye, tahsil edilmemiş çek/senet ve yeni belge tutarı birlikte hesaplanır. Limit aşımında uyar, onay iste veya engelle seçeneklerinden biri uygulanır.
- Vade: "ay sonu + 15 gün" gibi ödeme koşulları, vade farkı raporu ve vade farkı faturası.
- Mevzuat: irsaliyeden sonra 7 gün içinde fatura kesilmesi uyarısı, önerilen fatura türü (e-Fatura / e-Arşiv / kâğıt).
Onay akışı ve mobil
Eşik üstü iskonto veya risk limiti aşımında kullanıcı gerekçe yazıp onay ister. Yönetici masaüstünden ya da telefonundan karar verir. Telefon, QR kodla eşleştirilip tarayıcı üzerinden bağlanır; ofis dışından erişim Cloudflare tüneli ile sağlanır. Onay, onaylanan tutara bağlıdır ve yalnızca bir kez kullanılabilir.
Raporlar
Ay, müşteri, ürün, kategori ve temsilci kırılımlı satış raporları; satış hunisi ve "neden kaybettik?" analizi; malzeme, müşteri ve temsilci bazında kârlılık; alacak yaşlandırma (1-30 / 31-60 / 61-90 / 90+ gün); KDV özeti; vade farkı. Tümü Excel'e aktarılabilir. Panelde vadesi geçmiş alacak, fatura süresi dolan irsaliye, vadesi gelen çek ve kritik stok uyarıları kapatılamayan bantlar olarak gösterilir.
e-Belge
GİB biçiminde UBL-TR e-Fatura XML'i üretilir ve doğrulanır. Entegratör bağlandığında gönderim kuyruğu 6 kademeli yeniden deneme ile çalışır, GİB yanıtları 15 dakikada bir sorgulanır, kabul/ret takip edilir. Gelen e-Faturalar gelen kutusuna düşer.
Mimari
Öne çıkan teknik kararlar
- Uygulamayla gelen PostgreSQL: Veritabanını uygulama kendisi kurar, açar ve kapatır; kullanıcı ayrıca bir şey kurmaz. ICU tr-TR collation ile Türkçe büyük/küçük harf araması ve sıralama doğru çalışır; her sorgu 60 saniye ile sınırlıdır.
- Para ve KDV hesap çekirdeği: Tüm tutar ve vergi hesapları, ondalık hassasiyetli (decimal.js) tek bir paylaşılan pakette. Hesaplama istemcide değil sunucuda yapılır.
- Değiştirilemez kayıtlar: Stok hareket defteri ve denetim kaydı yalnızca eklemeyle büyür; numaralı belgeler ters kayıtla iptal edilir. Denetim kaydında kişisel veriler maskelenir.
- Güvenlik: kaynak.eylem biçiminde izin kodlarıyla RBAC, Argon2 parola hash'i, cihaz onayı, hesap kilitleme, Electron'da contextBridge ile izole IPC.
- Yedekleme: Günlük, şifreli ve alındığı anda doğrulanan yedek. Dosyalar openssl uyumlu; uygulama açılmasa bile elle çözülebilir. Güncelleme öncesinde otomatik yedek alınır.
- Dağıtım: electron-builder ile kurulum paketi, arka planda otomatik güncelleme, lisans anahtarı.
- Çok dillilik: Arayüz Türkçe ve İngilizce. Koda sabit metin yazılmasını engelleyen özel bir lint kuralı var.
Teknolojiler
| Katman | Teknoloji |
|---|---|
| Masaüstü | Electron, React 19, Tailwind CSS 4, TanStack Query, Zustand |
| API | Node.js, Fastify, Zod, JWT, Argon2 |
| Veritabanı | PostgreSQL 18, Drizzle ORM |
| Belgeler | UBL-TR e-Belge, PDF (Handlebars), Excel (ExcelJS) |
| Altyapı | AWS CDK (S3, KMS), Cloudflare Tunnel, electron-updater |
| Test | Vitest, Testing Library, Playwright |
| Monorepo | TypeScript, Turborepo, Vite |