Kimse sıfırdan başlamasın diye, çalışır durumdaki projelerimizi olduğu gibi, açık kaynak olarak, Apache 2.0 lisansıyla paylaşıyoruz. Bunlar ürüne dönüştürülmeyecek; temel, ilham ya da kıyas noktası olsun diye açık.
Açık kaynak, yazılımın kaynak kodunun herkesin görebileceği, denetleyebileceği ve değiştirebileceği şekilde yayınlanması demektir. Apache 2.0 size şu özgürlükleri verir:
Kullanma
Her amaçla kullanın: kendi işletmenizde ya da ticari bir üründe, ücretsiz ya da satarak. İzin almanız, ücret ödemeniz gerekmez.
İnceleme
Kaynak kodun tamamını okuyun, nasıl çalıştığını görün, güvenliğini ve doğruluğunu kendiniz denetleyin.
Değiştirme
İşinize göre düzenleyin, uyarlayın, geliştirin. Değişikliklerinizi paylaşmak zorunda değilsiniz, kendi eklediğiniz kod sizde kalabilir.
Yeniden yayınlama
Aslını ya da değiştirdiğiniz halini başkalarına dağıtın, kendi ürününüze katın.
Patent güvencesi
Kod katkısı verenler, katkılarındaki patent haklarını size de tanır.
Karşılığında istediğimiz
Lisans metnini ve telif bildirimlerini koruyun; kodu değiştirdiyseniz değiştirdiğinizi belirtin.
Yazılım olduğu gibi sunulur, garanti verilmez.
Lisans, ürün adlarını ve logoları kullanma hakkını vermez.
Bu özet bilgilendirme içindir, hukuki tavsiye değildir. Geçerli olan lisansın kendisidir: Apache License 2.0.
abarow
Projeler
Açık kaynak olarak paylaştığımız projeler. Her biri Apache 2.0 lisanslıdır.
Türkiye'deki perakende ve restoran için Linux üzerinde çalışan, açık kaynak bir satış noktası sistemi. Her katman kendi başına çalışabilecek şekilde tasarlandı.
Kasa
Satışı kaydeder. Kendi PostgreSQL'i ve NATS JetStream'i vardır; bağlantı kesilse de satmaya devam eder.
Mağaza sunucusu
Kasaların olaylarını toplar, merkeze iletir. Kendi PostgreSQL'i, NATS JetStream'i ve rapor ekranı vardır.
Merkez
Mağazalardan gelen satışları işler. NATS, ingest, PostgreSQL ve rapor ekranı çalışır.
Sayfalar soldaki menüden (telefonda Menü düğmesinden) ya da alttaki Önceki / Sonraki düğmelerinden gezilir. Ölçümler geliştirici bilgisayarında alınmıştır, mağaza donanımının değerini vermez ve garanti değildir.
Uygulama ekranları
Kasa, müşteri ekranı, restoran, mağaza sunucusu ve merkez ekranlarından örnekler. Büyük halini görmek için bir resme tıklayın.
Görüntüler 1920×1080 boyutunda, simülatör verisiyle alındı: ürün, satış ve kasiyer adları deneme verisidir. Kasa ekranlarındaki "SİMÜLATÖR MODU" şeridi bu yüzden görünür.
Kasa (market)
Kasiyer seçimiPIN ile girişVardiyayı açma: açılış nakdiSatış ekranı: barkod alanı ve hızlı tuşlarSepet: barkod, hızlı tuş ve tartılı ürünÖdeme: nakit ve para üstüSatış tamamlandıVardiya içi X raporu
Müşteri ekranı
Hoş geldinizSepet ve toplamTeşekkürler ve para üstü
Restoran
GirişMasalarResimli menü: çorbalarÜrün seçeneği: porsiyonResimli menü: ana yemeklerÜrün seçenekleri: pişirme, ek ve notResimli menü: içeceklerAdisyonMutfağa gönderilen siparişÖdeme
Mağaza sunucusu (operasyon)
Müdür girişiKasa durumu ve günlük raporÜrünlerMağaza fiyatlarıKasiyerlerStokGüncelleme
Merkez
GirişMağazalar ve satış özetiÜrünlerStokGüncellemeKullanıcılar
Üç 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.
Nasıl kurulur: hepsi bir makinede ya da ayrı ayrı
Kasa, mağaza sunucusu ve merkez üç ayrı roldür. Rol ile makine (bilgisayar) aynı şey değildir: roller tek makinede toplanabilir, ayrı makinelere dağıtılabilir ya da karışık kurulabilir. İşletmenizin büyüklüğüne göre seçersiniz.
Kasa satışı yapan bilgisayar
Mağaza sunucusu mağazadaki kasaları toplar
Merkez bütün mağazaları toplar
Aşağıdaki çizimlerde kesikli çerçeve bir makineyi gösterir. Kesikli çizgili rol isteğe bağlıdır.
1. Hepsi tek makinede
Tek kasalı, tek mağazalı küçük işletme.
Makine 1
KasaMağaza sunucusuMerkez (isteğe bağlı)
Tek kasada merkez şart değildir: kasanın X/Z ve gün sonu raporları yetebilir.
Merkez de isteniyorsa, tek mağazalı işletmede mağaza sunucusuyla aynı makinede çalışabilir.
Kasa ve mağaza sunucusu için bellek: en az 640 MB, önerilen 1280 MB; 2 ila 4 çekirdek.
Dikkat: makine durursa hepsi birlikte durur.
2. Kasalardan biri mağaza sunucusu da olsun
2–3 kasalı küçük mağaza; ayrı bir sunucu almak istemiyorsunuz.
Makine 1
KasaMağaza sunucusu
Makine 2
Kasa
Makine 3
Kasa
Ayrı bir sunucu gerekmez; o kasa mağaza sunucusunun container'larını da çalıştırır.
Dikkat: o kasa kritik hale gelir. Durursa diğer kasalar satmaya devam eder, olaylar kasalarda birikir; mağaza raporları durur.
3. Beş makine: dördü yalnız kasa, biri hepsi bir arada
5 kasalı mağaza. Beşinci makine hem kasa hem mağaza sunucusu olur; isterseniz merkez de orada çalışır.
Makine 1
Kasa
Makine 2
Kasa
Makine 3
Kasa
Makine 4
Kasa
Makine 5
KasaMağaza sunucusuMerkez (isteğe bağlı)
Yalnız kasa olan makine: en az 256 MB, önerilen 736 MB bellek.
Kasa ve mağaza sunucusu olan makine (5 kasa için): en az 704 MB, önerilen 1344 MB.
Beş makinenin toplamı: en az 1728 MB, önerilen 4288 MB bellek.
Merkez de aynı makineye konursa o makinenin ihtiyacı artar. Bu birleşim için ayrı ölçüm yoktur.
4. Her rol ayrı makinede
Çok kasalı mağaza ya da birden çok mağazalı işletme.
Merkez makinesi
Merkez
Mağaza 1
Mağaza sunucusu makinesi
Mağaza sunucusu
Kasa makineleri × 5
Kasa
Mağaza 2
Mağaza sunucusu makinesi
Mağaza sunucusu
Kasa makineleri × 5
Kasa
Ölçülen örnek: 1 merkez, 2 mağaza ve 10 kasa, toplam 13 makine.
Mağaza sunucusu makinesi: 5 kasa için en az 448 MB, önerilen 608 MB; 50 kasa için en az 1152 MB, önerilen 1312 MB ve 4 ila 8 çekirdek.
Merkez, işletmenin kendi sunucusunda ya da kiralık bir sunucuda (VPS) çalışır. Yeni mağaza açılınca kendi mağaza sunucusu ve kasalarıyla merkeze bağlanır.
Hangisi bana uygun?
Durum
Genelde uygun olan
Tek kasa
1. Hepsi tek makinede
2–3 kasa, ek sunucu istemiyorsunuz
2. Kasalardan biri mağaza sunucusu da olsun
Birkaç kasa, bir makine ağır işi taşıyabilir
3. Hepsi bir arada olan bir makine
Çok kasa ya da birden çok mağaza
4. Her rol ayrı makinede
Hangisini seçerseniz seçin aynı kalanlar
Her rol kendi container'larıyla, kendi veritabanı ve kendi NATS'ıyla çalışır; aynı makineyi paylaşsalar bile birbirinden ayrıdır.
Olayların yukarı, katalog ve makbuzların aşağı akışı ve bağlantı kesilince davranış değişmez.
Kasa eklenince ya da çıkarılınca kurulum betiği PostgreSQL ayarlarını yeniden hesaplar; sonradan büyütmek mümkündür.
Bellek sayıları abarow'un kendi servislerinindir. İşletim sistemi için yaklaşık 256 MB, kasada Chromium kiosk için yaklaşık 512 MB ayrıca gerekir. Ayrıntılı tablolar: docs/HARDWARE.md.
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
Bir satışın kasadan merkeze yolculuğunu adım adım izleyin.
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
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.