abarow GitHub

Açık kaynak · Apache-2.0

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

≈95 MiBBir kasanın 9 servisinin yük altındaki belleği (boşta ≈68 MiB)
119 msBir satışın tamamı (5 çağrı), hafif yükte p50
0 hata682 satışta ve ≈113 bin okuma isteğinde
2 satışGerçekçi yükte merkezde bekleyen en uzun kuyruk (50 mağaza, 100 kasa)

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 çökerseNe olur
İnternetMağaza, raporlar dahil normal çalışır; olaylar mağaza sunucusunda birikir.
Mağaza sunucusuMarket kasaları satmaya devam eder, olaylar kasalarda birikir; mağaza raporları durur. Restoranda masa paylaşımı durur.
Bir kasaDiğer kasalar etkilenmez; o kasanın bekleyen olayları kasa açılınca gönderilir.

Olay neden kaybolmaz, neden iki kez sayılmaz

Servissatışı kaydeder
PostgreSQLsatış + outbox, tek işlem
Relayoutbox'ı sırayla yayınlar
Yerel JetStreamkimlikle tekrar ayıklar
Üst katman PostgreSQLaynı kimliği bir kez işler
Makbuz ↩üst katman işleyince UUIDv7 üretir ve aşağı gönderir
Saklamamakbuzu gelmiş olay da kasada en az 30, mağaza sunucusunda 90 gün durur
  1. Outbox: servis satışı ve yayınlayacağı olayı aynı veritabanı işleminde yazar. "Satış kaydedildi ama olay gitmedi" durumu oluşmaz.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Kurulum
Ölçü

  • Ç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ıVeriCPU (ort.)Bellek (en çok)Taze yığında (en çok)
Mağaza sunucusu, 1 kasa9.000 satış, 29 MB%274 MiB55,8 MiB
Mağaza sunucusu, 5 kasa45.000 satış, 102 MB%14149 MiB56,8 MiB
Merkez, 2 mağaza × 5 kasa90.000 satış, 229 MB%17249 MiB62,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
Kasa123 MiBkasa veritabanı ölçülmedi736 MB
Mağaza sunucusu, 5 kasa168 MiB≈260 MiB608 MB
1 mağaza + 1 kasa, tek makine200 MiB≈210 MiB1280 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.