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
@TenantIdher 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 |