🔌 Donanım Ajanı ve Cloud Yük Devretme¶
Cloud işletiminde kasa {name}.next.dikas.de adresinde çalışır — ancak gerçek donanım (kart
terminali, fiş yazıcısı) mağazada bulunur. Donanım Ajanı bu köprüyü kurar: mağaza ağında
çalışan, ödemeleri ve baskıları yerel olarak yürüten ve Cloud'a giden bir bağlantı üzerinden
kontrol edilen ince bir program. Böylece kasa artık yerel değil de Cloud'da çalışsa bile donanım
işlevini sürdürür.
Buna kimin ihtiyacı var?
Kasalarını (geçici veya kalıcı olarak) Cloud'da işleten, ancak yerel cihazlar kullanan işletmeler. Tamamen yerel işletilen kasalar donanımlarını doğrudan adresler ve ajana ihtiyaç duymaz. Ayrıca bkz. Cloud ve yerel makine.
Kim Ajan olabilir?¶
Donanım Ajanı zaten DiKAS cihaz uygulamalarının içindedir — ekstra bir şey kurulması gerekmez:
| Ana bilgisayar | Platform | Rol |
|---|---|---|
| DikasArch cihazı | Mini PC (Arch Linux, Electron kiosk) | Kasa ve Donanım Ajanı bir arada |
| DiKAS Mobile | Android (MAUI uygulaması) | Ajan işlevli mobil kasa |
| DiKAS Cihaz Ajanı | Android tablet | salt donanım ajanı (kasa arayüzü olmadan) |
Mağaza ağındaki her cihaz ajan olabilir. Birden fazlası bağlıysa, biri görevi üstlenir; biri devre dışı kalırsa diğerleri hizmete devam eder.
Ajan Üzerinden Ne Çalışır?¶
| İşlev | Ajan üzerinden |
|---|---|
| Kart ödemesi (ZVT) | ✓ Ödeme, iptal, iade, kasa kesimi — ağ terminalinde |
| Fiş/belge baskısı (ESC/POS) | ✓ ağ fiş yazıcısına veya yerel bağlı USB/seri yazıcılara |
| Ağda cihaz arama | ✓ mağaza ağındaki terminalleri ve yazıcıları bulma |
| A4 belge baskısı (CUPS) | ✓ cihazın yerel yazıcı köprüsü üzerinden |
| TSE imzası | ✗ — TSE yerel kasaya bağlı kalır (veya Cloud-TSE olarak çalışır), bkz. TSE |
Doğrudan mı, Ajan mı — otomatik
Sunucu cihaza ağda doğrudan ulaşabiliyorsa (yerel işletim), DiKAS onu doğrudan adresler. Kasa Cloud'da ve bir ajan bağlıysa, işlem otomatik olarak ajan üzerinden yürür — kullanımda herhangi bir geçiş yapılmaz.
Eşleştirme (Pairing)¶
Ajan, Cloud'a kendiliğinden bağlanır (giden yönde, NAT dostu — port yönlendirmesi gerekmez). Kimlik doğrulama, lisanstan türetilen bir gizli anahtar (secret) ile işletme başına yapılır.
- DikasArch cihazı: otomatik olarak eşleşir — işletmesini lisanstan tanır ve Cloud adresini
(
{name}.next.dikas.de) ile eşleştirme gizli anahtarını kendisi türetir. - Tablet/Mobil: Admin alanından QR kod ile eşleştirme (Cloud adresi + gizli anahtar).
Bağlantı durumunu (bağlı cihazlar) Admin alanı Ayarlar → Donanım → Donanım Ajanı altında gösterir.
Cloud Yük Devretme: Yerel Sunucu Devre Dışı Kalırsa¶
Yerel kasa sunucusu çevrimdışı olursa (elektrik kesintisi, ağ, arıza), işletmenin çalışmaya devam etmesi gerekir. DiKAS bu arızayı algılar ve Cloud'a geçişi önerir:
- Kasa, yerel sunucunun erişilebilir olup olmadığını düzenli olarak kontrol eder.
- Sunucu devre dışı kalır ve Cloud erişilebilir durumdaysa, altta bir uyarı görünür: „Lokaler Server nicht erreichbar — auf Cloud wechseln?" (Yerel sunucuya ulaşılamıyor — Cloud'a geçilsin mi?)
- Onaydan sonra kasa
{name}.next.dikas.deCloud adresini yükler. Yerel ayarlar (çalışma yeri, yazıcı/terminal eşlemesi) devralınır, kullanıcı adı önceden doldurulmuştur — yalnızca yeniden giriş yapmanız gerekir. - Donanım çalışmaya devam eder: Kart ödemesi ve fiş baskısı artık kasa sunucusundan bağımsız olarak çalışmaya devam eden Donanım Ajanı üzerinden yürür. A4 baskıları yerel yazıcı köprüsü üzerinden çalışır.
- Yerel sunucu geri gelirse, kasa geri geçişi önerir.
Ajan arızayı neden atlatır
DikasArch cihazında Donanım Ajanı, kasa sunucusundan ayrı kendi hizmeti olarak çalışır. Kasa sunucusu çökerse ajan bağlı kalır — cihazlar Cloud modunda kullanılmaya devam edilebilir.
Yük devretmede anlık iletim (Relay)
Relay iletimi, çalışan bir yerel sunucu gerektirir ve bu nedenle yük devretmede kullanılamaz. Cloud modunda yerel baskı ve kart ödemesi Donanım Ajanı üzerinden yürür (A4 için yazıcı köprüsü üzerinden).
Manuel Olarak Çevrimiçine Geçme¶
Bir arıza olmadan da yerel işletimden Cloud'a geçilebilir — ör. yoldayken çalışmaya devam etmek için. Kasanın ana menüsünde (bir Cloud adresi bilindiği anda cihazda ve mobilde) bunun için „Online wechseln" (Çevrimiçine geç) girdisi görünür. Bu, yük devretmedeki ile aynı geçişi gerçekleştirir.
Sık Sorulan Sorular¶
Cihaza bir şey kurmam gerekir mi? Hayır. Ajan, DikasArch yazılımının bir parçasıdır ve lisans üzerinden otomatik olarak eşleşir.
Yerel sunucu kapalıyken kart ödemesi ve baskı gerçekten çalışır mı? Evet — mağaza ağında bir cihaz bağlıysa Donanım Ajanı üzerinden. Cloud'un cihazları (terminal/yazıcı adreslerini) bilmesi gerekir; bunlar cihaz araması ile bulunur ve kaydedilir.
Bağlı ajan yoksa ne olur? Cloud modunda kasa o zaman net bir hata mesajı verir („bağlı donanım ajanı yok") — kart ödemesi/baskı, ancak bir cihaz bağlandığında yeniden mümkün olur.
Yük devretmede belgeler çift mi tahsil edilir? Hayır. Bir ödemenin sonucu kaybolursa, kasa otomatik olarak tekrarlamak yerine bir hata bildirir — böylece çift tahsilat önlenir.