Pasif

Kantar ERP

Türk KOBİ'leri için çok kiracılı bulut ERP: satış, stok, satın alma, e-Fatura, pazaryeri, kasa-banka ve otomatik yevmiyeli muhasebe tek uygulamada. Bir kullanıcı (ör. mali müşavir) birden çok şirkete yeniden giriş yapmadan geçebiliyor.

Problem

Küçük bir işletme bugün satışı bir programda, e-Faturayı entegratörün panelinde, pazaryeri siparişlerini her kanalın kendi ekranında, muhasebeyi de mali müşavirin yazılımında tutuyor. Aynı fatura dört yere elle giriliyor. Büyük ERP'ler bu ölçek için fazla ağır; mali müşavir ise her müşterisi için ayrı bir sisteme girmek zorunda.

Çözüm

Satıştan muhasebe fişine kadar tüm zinciri tek bir bulut uygulamasında toplayan, çok kiracılı bir ERP. Bir belge bir kez girilir; stok, cari, e-Belge ve yevmiye kaydı ondan türetilir. Bir kullanıcı birden çok şirkete üye olabilir ve yeniden giriş yapmadan şirket değiştirebilir.

Durum: v0.2 MVP. Ana akışlar testli ve çalışıyor. Dış sistemler (e-Belge entegratörü, pazaryeri, kargo, kur, banka) demo sağlayıcılarla çalışıyor; gerçek sağlayıcılar aynı arayüzlerin arkasına bağlanacak. Çalışma adı: Kantar.

Demo: Giriş gerektirmez. Örnek verili bir şirket ("Ege Tekstil Ltd. Şti.") açılır: son altı haftaya yayılmış siparişler, faturalar, tahsilatlar, pazaryeri siparişleri ve banka hareketleri. Demo her gece yeniden kurulur.

Uçtan uca iş akışı

Sipariş → Sevk / e-İrsaliye → Fatura (e-Fatura / e-Arşiv) → Tahsilat
   │            │                     │                        └─ cari kapanır, yevmiye
   │            │                     └─ GİB numarası, profil otomatik, outbox ile entegratöre
   │            └─ kısmi sevk, kalanı kapatma; stoktan düşer
   └─ stok rezervasyonu, risk limiti kontrolü

Her adım muhasebeye kendiliğinden yevmiye kaydı olarak düşer. Pazaryeri siparişleri de aynı zincire girer.

Modüller

Kurulum: Kayıt olunca hesap planı, merkez depo ve merkez kasa otomatik kurulur. Excel/CSV'den cari, ürün ve açılış stoğu aktarımı: önce kontrol, sonra "hep ya da hiç". Kullanıcı daveti (7 gün geçerli, tek kullanımlık bağlantı), rol değiştirme, son sahibin silinmesine karşı koruma.

Satış: Sipariş ve stok rezervasyonu, risk limiti, kısmi sevk ve e-İrsaliye, e-Fatura / e-Arşiv (profil otomatik seçilir, tevkifat ve istisna kodu, dövizli fatura), satış iadesi.

Pazaryeri: Dört kanal bağlantısı, sipariş çekme, stok gönderme (güvenlik payıyla), faturayı kanala yükleme, kargo takip numarası. Ürün eşleme SKU ile.

e-Belge: Gönderim, durum izleme, yeniden gönderim, gelen kutusu, kabul/ret, gelen e-Faturayı alış faturasına dönüştürme.

Stok ve satın alma: Değiştirilemez hareket defteri, sayım, ortalama maliyet, satın alma siparişi ve mal kabul.

Finans: Kasa, banka, tahsilat, ödeme, çek; banka ekstresi içe aktarma ve cari önerisiyle eşleştirme; dövizli cari değerlemesi ve kur farkı.

Muhasebe: Otomatik yevmiye, manuel fiş, ters kayıt, alt hesaplar, mizan, cari ekstre, KDV özeti. Dönem kapanışı kontrol listesiyle yapılır; kapanan dönem tüm modüllerde kilitlenir ve yalnızca şirket sahibi açabilir.

Mali müşavir: Mali müşavir rolüyle davet ve tüm müşteri şirketlerini tek ekranda gösteren çoklu mükellef paneli.

Platform: Patron paneli, denetim izi, tam veri dışa aktarımı (ZIP, tablo başına CSV), Türkçe duyarsız arama ("sik insaat" → "Şık İnşaat").

Dış entegrasyonlar

Her dış sistem sunucuda bir arayüzün arkasında. Gerçek sağlayıcı bağlamak, o arayüzü uygulayan yeni bir sınıf yazıp ayardan seçmek demek; uygulamanın geri kalanı değişmiyor.

Entegrasyon Bugün Hedef
e-Belge entegratörü Demo sağlayıcı Özel entegratör
Pazaryeri Demo, 4 kanal Trendyol, Hepsiburada, N11, Amazon
Kargo Demo Yurtiçi, Aras, MNG, HepsiJet
Döviz kuru Demo TCMB
Banka ekstresi Gerçek CSV ayrıştırıcı MT940, camt.053
Online tahsilat Demo iyzico, PayTR, Param

Entegratör ve pazaryeri çağrıları veritabanı işleminin içinde yapılmıyor. Fatura kesildiğinde aynı işlemde bir iş kaydı yazılıyor (transactional outbox). Arka plan işçisi commit'ten sonra çağrıyı yapıyor, hata olursa artan aralıklarla yeniden deniyor. Dış sistem çökse de fatura kaybolmuyor. İş kuyruğu kiracılar arasında adil: kiracı başına turda 5 iş, takılan iş 10 dakika sonra kuyruğa dönüyor.

Mimari

Öne çıkan teknik kararlar

  • İki katmanlı kiracı izolasyonu: Uygulamada Hibernate @TenantId her sorguya kiracı filtresi ekliyor. Veritabanında PostgreSQL Row Level Security (FORCE ROW LEVEL SECURITY) var. Uygulama tablo sahibi olmayan bir rolle bağlanıyor, RLS'i atlayamıyor; kiracı ayarlanmamışsa sorgu hiç satır döndürmüyor. Her yeni kiracı tablosunun bu kurallara uyduğunu bir test doğruluyor.
  • Kiracı token'da değil: Token yalnızca kullanıcıyı taşıyor. Şirket her istekte başlıkla seçiliyor ve kullanıcının o şirkete aktif üyeliği her istekte doğrulanıyor. Mali müşavir gibi çok şirketli kullanıcılar bu sayede yeniden giriş yapmadan şirket değiştiriyor.
  • Ayrı veritabanı rolleri: Migration'lar, uygulama ve kimlik servisi üç ayrı rolle bağlanıyor. Kimlik servisi yalnızca kendi şemasını görüyor.
  • Modül sınırları build'de korunuyor: Modüller birbirine yalnızca public API ve olaylar üzerinden erişiyor. İhlal olursa Spring Modulith testi build'i kırıyor.
  • Kendi kimlik servisi: Spring Authorization Server ile OAuth2 / OIDC; imza anahtarı kalıcı.
  • Gizli bilgiler şifreli: Pazaryeri API anahtarları AES-256-GCM ile şifreleniyor.

Teknolojiler

Katman Teknoloji
Backend Java 25, Spring Boot 4.1, Spring Modulith, Spring Security, JPA / Hibernate
Kimlik Spring Authorization Server (OAuth2 / OIDC)
Veritabanı PostgreSQL 17, Flyway, Row Level Security
Web React, TypeScript, Vite, TanStack Router / Query, AG Grid, Tailwind CSS
Test JUnit 5, Testcontainers, Spring Modulith test, Playwright
Demo altyapısı AWS EC2 (Terraform), Docker Compose, Caddy
Build Gradle, pnpm