Açık kaynak · Apache-2.0
abarow
github.com/abarow/kasadan-merkeze-sistem-abarow
Türkiye'deki perakende ve restoran için Linux üzerinde çalışan, açık kaynak bir satış noktası sistemi. Kasa, mağaza sunucusu ve merkez olmak üzere üç katmanda; her katman kendi başına çalışabilecek şekilde tasarlandı.
Geliştirici bilgisayarında (Docker Desktop, 16 mantıksal CPU) ölçüldü. Mağaza donanımının değerini vermez, garanti değildir. Kaynak kullanımının ayrıntısı.
Üç katman, tek olay akışı
Her katmanda kendi PostgreSQL'i ve NATS JetStream'i çalışır. Satış olayları kasadan mağaza sunucusuna, oradan merkeze akar. Katalog ve fiyat merkezden kasalara iner. Üst katman olayı veritabanına işleyince makbuz geri gelir.
- Satış olayı (yukarı)
- Katalog ve fiyat (aşağı)
- Teslim makbuzu (aşağı)
Gösterim hızlandırılmıştır: kasa başına yaklaşık 2 saniyede bir satış. Ölçümlerde kasa başına 20 saniyede 1 satış kullanıldı.
- Her katmanın kendi PostgreSQL'i ve kendi NATS'ı vardır; bir katman üstünü beklemeden çalışır.
- Olaylar yukarı akar. Katalog, fiyat ve makbuz aşağı iner.
- Bağlantılar NATS leaf bağlantısıdır: TLS ve NKey ile korunur, bölüm "Güvenli iletişim"de.
Bağlantı kesilince
Aynı çizim, bu kez bağlantıları siz kesiyorsunuz. Kasalar satmaya devam eder, olaylar bir alt katmanda birikir; bağlantı gelince sırayla akar.
Ne çökerse ne olur
| Ne çökerse | Ne olur |
|---|---|
| İnternet | Mağaza, raporlar dahil normal çalışır; olaylar mağaza sunucusunda birikir. |
| Mağaza sunucusu | Market kasaları satmaya devam eder, olaylar kasalarda birikir; mağaza raporları durur. Restoranda masa paylaşımı durur. |
| Bir kasa | Diğer kasalar etkilenmez; o kasanın bekleyen olayları kasa açılınca gönderilir. |
Olay neden kaybolmaz, neden iki kez sayılmaz
- Outbox: servis satışı ve yayınlayacağı olayı aynı veritabanı işleminde yazar. "Satış kaydedildi ama olay gitmedi" durumu oluşmaz.
- Relay: ayrı bir döngü outbox'ı yazılış sırasıyla yerel JetStream'e yayınlar (500 ms aralıkla). NATS yoksa olay outbox'ta bekler.
- Tekrar ayıklama: her olayın benzersiz kimliği vardır. JetStream kimliği 10 dakikalık pencerede, alıcılar veritabanında ayıklar; aynı olay iki kez gelse bir kez işlenir.
- Teslim makbuzu: üst katman olayı kendi PostgreSQL'ine işleyince makbuz üretir ve aşağı gönderir. Alt katman, makbuzu gelmemiş olayı silmez. NATS'ın kendi onayı yalnız "alan akış yazdı" der; veritabanına işlendiğini makbuz kanıtlar.
- Saklama: makbuzu gelmiş olay da en az kasada 30, mağaza sunucusunda 90 gün durur.
Kaynak kullanımı: iki örnek kurulum
Container başına CPU ve bellek, boşta ve gerçekçi satış yükü altında (her kasada 20 saniyede 1 satış). Bir kurulum seçin.
- Çubuk: yük altında (ortalama)
- Çizgi: boşta
Bütün sayılar (tablo)
Veri büyüyünce
Yukarıdaki yığınlar tazedir, veritabanları boştur. Veritabanı belleği veriyle büyür. Aynı yükte, 30 günlük satışla dolu veritabanları:
| Veritabanı | Veri | CPU (ort.) | Bellek (en çok) | Taze yığında (en çok) |
|---|---|---|---|---|
| Mağaza sunucusu, 1 kasa | 9.000 satış, 29 MB | %2 | 74 MiB | 55,8 MiB |
| Mağaza sunucusu, 5 kasa | 45.000 satış, 102 MB | %14 | 149 MiB | 56,8 MiB |
| Merkez, 2 mağaza × 5 kasa | 90.000 satış, 229 MB | %17 | 249 MiB | 62,1 MiB |
Bu CPU değerleri yığındakinden yüksektir: 30 günlük veride aylık ve ürün raporları ağır sorgulardır ve rapor ekranı açıktır.
Ayrılan tavan ve kullanılan
Her container'ın bir bellek tavanı vardır. Tavanların toplamı ("optimum") makinenin ayırması gereken bellektir; ölçülen kullanım bunun küçük bir kısmı.
| Makine | Ölçülen en çok (taze) | 30 günlük veriyle (hesaplanan) | Optimum tavan |
|---|---|---|---|
| Kasa | 123 MiB | kasa veritabanı ölçülmedi | 736 MB |
| Mağaza sunucusu, 5 kasa | 168 MiB | ≈260 MiB | 608 MB |
| 1 mağaza + 1 kasa, tek makine | 200 MiB | ≈210 MiB | 1280 MB |
Geliştirici bilgisayarında (Docker Desktop, WSL2, 16 mantıksal CPU) tek çalıştırmada, 2 dakikalık yükle ölçüldü; mağaza donanımının değerini vermez, garanti değildir. CPU, tek çekirdeğin yüzdesidir. İşletim sistemi ve kasadaki Chromium dahil değildir (≈256 MB ve ≈512 MB tahmin). Boşta CPU'nun bir kısmı Docker Desktop ve WSL2'nin sanallaştırma yüküdür; gerçek Linux ve Podman'da ölçülmedi.