Bölüm 3 — Bridge uygulaması (donanım bağlantı köprüsü)

Satış Kasası tarayıcıda çalışır ve tarayıcı kart okuyucu, yazıcı, terazi ve müşteri ekranıyla doğrudan konuşamaz. Bridge uygulaması bu köprüdür: kasanın yanında çalışır ve bu cihazları kasaya bağlar.

Hepsi aynı işi yapan üç biçimi vardır (iOS sürümü deneyseldir):

• Tablet üzerinde Android uygulaması
• Bilgisayar üzerinde masaüstü uygulaması (Windows/Mac/Linux)
• iOS uygulaması (deneysel)

⚠️ Dil: Android uygulamasının arayüzü pratikte İngilizcedir. Yalnızca birkaç eski dizi Almancaya çevrilmiştir; operatörün gördüğü tüm pano (durumlar, Power Guard, Keep Bridge Awake, günlükler vb.) İngilizcedir.

💡 Bridge'i genellikle bir kez kurarsınız ve sonra arka planda çalışır. Bridge adresini Kasa ← Ayarlar ← Bridge içinde girersiniz (Kasa kılavuzu, Bölüm 9). Android uygulaması kalıcı bir ön plan servisi olarak çalışır: uygulamayı listeden kapatsanız da çalışmaya devam eder, güncellemeden sonra otomatik olarak yeniden başlar, ve bir izleyici her 30 saniyede bir gerekirse sunucuyu yeniden ayağa kaldırır.

3-1. Android uygulaması — durum ekranı

Üstte bir özet satırı ve birkaç durum kartı bulunan tam ekran (kiosk) bir sayfa. Çalışırken "Köprü hazırlanıyor, kart okuyucu ve müşteri ekranı bağlanıyor" mesajını görürsünüz.

• Genel özet, sayfanın üstünde, örneğin: "Köprü ödemeye hazır", "Kart okuyucu hazır, tarayıcı bekleniyor", "Tarayıcı bağlandı / kart okuyucu çevrimdışı", "Kart okuyucu bağlantısı kurtarılıyor", veya "İşlem sürüyor".
• Durum kartları (her biri renkli bir nokta ve bir durum kelimesi):
• WebSocket — kasanın bağlandığı yerel bağlantı noktası.
• Tarayıcı (Browser) — kasanın bağlanıp bağlanmadığı.
• Kart okuyucu (POS Terminal) — durumlar: kesildi / bağlanıyor / yeniden bağlanıyor / bağlı / işlem sırasında meşgul (Busy).
• Müşteri ekranı — ikinci ekranın durumu.
• Power Guard — boşta kalma sırasında kopmayı önlemek için pil/işlemci/Wi-Fi koruması.

Bridge adres kartı

• Kasaya girilmesi gereken adresi gösterir (yerel 127.0.0.1:PORT veya cihazın IP'siyle ağ adresi).
• Bağlantı modu düğmesi üç durumludur ve her basışta döner: yerel ← ağ ← otomatik (Auto). Otomatik mod, yerel ağ adresi mevcutsa ağa, aksi takdirde yerele geçer.
• Bağlantı modu düğmesini basılı tutmak: bir eşleştirme belirteci oluşturur veya siler — yalnızca yetkili kasanın bağlanabilmesi için adrese eklenen 6 karakterli bir kod (?token=XXXXXX). Bu belirteç yalnızca ağ modunda uygulanır (yerel modda göz ardı edilir) ve adreste "Paired/Open" olarak gösterilir.

Diğer kartlar ve günlüğe erişim

• Power Guard → "Köprüyü uyanık tut" (Keep Bridge Awake): Bridge'in boşta kalırken kopmaması için Android pil ayarlarını açar.
• Günlükler: Enable/Disable Logs düğmesiyle açılır/kapanır ve View Logs günlük sayfasını açar; kapatmak kayıtlı günlükleri siler. Günlüğü açmanın ikinci yolu, sayfanın üst çubuğuna uzun basmaktır (long-press).
• Günlük sayfası: salt okunurdur — her saniye yenilenen ve aşağı kayan tek aralıklı (monospace) metin; paylaşım/dışa aktarma düğmesi yoktur (destek ekibine göndermek için elle kopyalamanız gerekir).
• Müşteri ekranı sayfası: ikinci ekranda, sipariş kalemlerini ve toplamını bir web şablonuyla müşteriye gösterir. Android'de otomatik olarak bağlı her ikinci ekrana yapışır (manuel seçim olmadan; kablo çıkarıldığında kaldırılır).

3-2. Masaüstü uygulaması — "LonioBridge — Host"

Bridge'i bilgisayarda çalıştırmak için küçük bir kontrol penceresi:

• Kurulum formu:
• WebSocket bağlantı noktası (varsayılan 8088)
• Bağlanma adresi (Bind): yalnızca bu bilgisayar veya tüm ağ (varsayılan 0.0.0.0).
• Müşteri ekranı: müşteri ekranı olacak monitörü manuel seçme (veya hiçbiri).
• Köprüyü çalıştırmak için başlat/durdur; ayarlar çalıştırmalar arasında ~/.loniobridge/host.properties dosyasında korunur.
• Otomatik başlatma (Autostart): --autostart parametresiyle (Windows'ta yükleyici, sistem açıldığında başlaması için bunu etkinleştir/devre dışı bırak betikleriyle ayarlar).
• Penceresiz mod (Console): --console ile grafik arayüz olmadan çalıştırılabilir.
• Durum paneli: sunucu durumu (durduruldu / başlatılıyor / bağlantı noktasında dinleniyor / geçersiz bağlantı noktası / hata), bağlı kasa sayısı, kart okuyucu durumu, ve (işlem sırasında) meşgul/boşta göstergesi.
• Etkinlik günlüğü: olayların zaman damgalı günlüğü; ham kart okuyucu çerçevelerini kaydetmek için Verbose seçeneği (yalnızca sorun giderme için).

⚠️ Masaüstü penceresinde yazıcı veya terazi seçimi yoktur; yalnızca bağlantı noktası, bağlanma adresi ve müşteri ekranı. Yazıcı ve terazi kasa tarafından yapılandırılır ve Bridge onları kasanın mesajına göre başlatır.

3-3. Hangi cihazlar bağlanır

• Kart okuyucu: terminal profilinde seçilen iki sürücü vardır:
• ZVT (varsayılan) — ağ/TCP üzerinden, otomatik yeniden bağlanma (backoff) ve bağlanıyor/kurtarılıyor/bağlı durumlarıyla.
• GP Tom (SoftPOS) — aynı Android tablette GP kart okuyucu uygulamasıyla konuşan Global Payments sürücüsü (satış/iptal/iade; bu App2App yolundan günlük kapanış henüz desteklenmiyor).
• Müşteri ekranı: kasanın gönderdiği web şablonu (sipariş kalemleri ve toplamı); Android otomatik yapışır, masaüstünde monitör manuel seçilir.
• Yazıcı:
• ⚠️ Android'de yazdırma şu anda yalnızca kabul edilir ancak gerçek yazdırma işlemi uygulanmamıştır; gerçek yazdırma masaüstünde çalışır.
• Masaüstünün üç yolu vardır: seri, sistem yazıcısı (Windows), ve ağ/TCP (varsayılan, bağlantı noktası 9100); kağıt kesme ve para çekmecesini açma dahil.
• Terazi: yalnızca masaüstünde — seri veya USB-HID, birim tanıma (kg/g/lb/oz) ve kararlı/kararsız moduyla. Android'de terazi yoktur.

3-4. Kurulumu yapanın bilmesi gereken yapılandırma

• Bağlantı noktası (varsayılan 8088) ve bağlanma adresi (yerele karşı ağ).
• 127.0.0.1 (yerel) ile ağ IP'si farkı: kasa bu cihazdaysa yerel yeterlidir; başka bir cihazdaysa ağ modu + IP gerekir ve ikisi de aynı ağda olmalıdır.
• Eşleştirme belirteci (?token=…) yalnızca ağ modunda.
• Android pil ayarları (Keep Bridge Awake) kopmayı önlemek için.

3-5. Hızlı sorun giderme