Cenaly Hardware Bridge — müəssisənin avadanlığı

Brauzer özü POS-printerdə qəbz çap edə, pul qutusunu aça və ya tərəzidən çəki oxuya bilmir. Bu vəzifəni Cenaly Hardware Bridge həll edir — kassa kompüterinə quraşdırılan, fonda işləyən və admin paneli/kassa səhifəsini müəssisənin lokal avadanlığı ilə əlaqələndirən kiçik pulsuz tətbiq.

Açmaq üçün: Admin panel → Avadanlıq (admin.cenaly.com).

Nə qoşulur#

Çap növbəsi#

Körpü vasitəsilə çap — «göndərdim və ümid et» deyil. Körpünün təkrar cəhdlərlə iş növbəsi var ki, yenidən başlatmaya davam gətirir: printer söndürülübsə və ya kağız bitibsə, tapşırıq itmir və cihaz işə düşəndə çap olunacaq.

Buna görə çapın beş fərqli nəticəsi var, «alındı/alınmadı» deyil: çap olunub, növbəyə qəbul edilib (hələ kağız yoxdur!), brauzerlə çap olunub, fiskal kassa çap edir (aşağıya bax) və çap olunmayıb. Kassa başlığında gözləyən tapşırıqların sayını göstərən növbə indikatoru görünür.

Tapşırıqlar idempotentdir: eyni sənədin təkrar göndərilməsi ikinci kağız vermir.

Fiskal kassa aparatı — ehtiyat qəbz printeri deyil. Filialda ayrı qəbz printeri yoxdursa, körpü bizim qəbzi fiskal kassa vasitəsilə çap etməyəcək: fiskal qəbzi o özü çap edir, bizim sənəd isə başqa kağızdır. Kassa belə vəziyyətdə bunu deyir: «qəbzi fiskal kassa aparatı özü çap edir». Registrator vasitəsilə yalnız test çapı və ön qəbz icazəlidir — və onlarda bunun fiskal sənəd olmadığı barədə qeyd çap olunur.

Təfərrüatlar, printerlərin stansiyalara bağlanması və kiril və gürcü dili üçün kod səhifələri — Mətbəxdə və zalda çap.

Körpünün quraşdırılması#

Bu kompüterdə körpü tapılmazsa, səhifə onu quraşdırmağı təklif edəcək:

1. Əməliyyat sisteminizə uyğun versiyanı yükləyin — Windows, Linux (x64) və ya Linux (ARM64) (macOS — planlardadır). Yoxlama üçün SHA-256 göstərilib.
2. Tətbiqi işə salın. Windows — iki dəfə klikləyin: körpü arxa plana keçir (tray ikonası) və vəziyyət səhifəsini açır. Linux — dərhal fon xidməti kimi «Avadanlıq» səhifəsindən bir sətirliklə quraşdırmaq daha etibarlıdır (curl … | sudo … bash): o, kompüter açılanda işə düşür və özü yenidən başlayır. Yüklənmiş faylı əl ilə işə salmaq (chmod +x və işə salma) da işləyir, amma körpü yalnız terminal açıq olduqca yaşayır və yenidən yükləmədən sonra qayıtmır; Linux-da vəziyyət səhifəsini özünüz açın — http://127.0.0.1:9100.
3. Vəziyyət səhifəsində körpünün işə düşdüyünə əmin olun. Admin panelini elə bu kompüterdə açın, lazımi filialı və «Avadanlıq» bölməsini seçin: brauzer avtomatik qoşulur.
4. Admin panelinə qayıdın və «Yenidən axtar» düyməsini basın — kassa bu kompüterdəki körpünü özü tapıb qoşulacaq.

Windows yükləmə/işə salma zamanı xəbərdarlıq göstərirsə — bu gözləniləndir: «Saxla» seçin, işə salarkən isə «Ətraflı» → «Hər halda işə sal». Linux üçün fon xidməti kimi bir sətirlik quraşdırma var.

Körpünü kompüterdən necə silmək olar (Linux). Yenə «Avadanlıq» səhifəsindən həmin bir sətirliklə, yalnız alt əmrlə — səhifədə o, «Linux — körpünü dayandır və ya sil» altında gizlədilib:

• … | sudo bash -s -- stop — xidməti dayandırır və avtomatik işə salmadan çıxarır; fayllar və parametrlər yerində qalır, geri qoşmaq üçün — start;
• … | sudo bash -s -- uninstall — xidməti çıxarır və proqramın özünü silir. Parametrlər və kassanın bağlanması qalır, skript onların harada olduğunu çap edir;
• … | sudo bash -s -- uninstall --purge — eyni, üstəgəl parametrlər: avadanlıq siyahısı və filiala bağlanma. Bundan sonra kassanı yenidən bağlamaq lazım gələcək;
• … | sudo bash -s -- status — körpünün işləyib-işləmədiyi və hansı ünvanda (əgər 9100 məşğuldursa, körpü növbəti boş olanı götürür, 9109-a qədər).

Windows-da bunun üçün adi «Proqramların quraşdırılması və silinməsi» var («Cenaly Bridge» qeydi) — deinstalyator avtomatik işə salmanı da silir.

Admin panelin açılmadığı kompüterdə körpü (arxa otaqdakı server, printerlərin yanındakı ayrı kompüter) avtomatik axtarışla bağlana bilməz — avtomatik bağlama yalnız körpü ilə eyni kompüterdəki kassa səhifəsi arasında işləyir. Belə halda sahib admin panelində birdəfəlik bağlama kodu yaradır (15 dəqiqə yaşayır) və onu körpünün vəziyyət səhifəsində daxil edir.

Körpü brendinizə bağlıdır: başqa brendinq domenindən yüklənən körpü sizin admin panelinizə xidmət etməyəcək, əgər körpü artıq həmin sahibin başqa filialına bağlanıbsa, səhifə bunu göstərəcək və bir düymə ilə onu buraya yenidən bağlamağı təklif edəcək.

Üç qoşulma üsulu#

«Cihazlar» bölməsindən əməkdaşın giriş kodu — ayrı mexanizmdir. Əgər PIN və ya kodun vaxtı keçibsə, uyğun düymə ilə yenisini yaradın.

İdarəetmə və yoxlamalar#

Körpü qoşulduqda səhifədə görünür:

• Cihazlar — hər birinin vəziyyəti ilə siyahı (qoşulub / diqqət / xəta / tapılmadı);
• Avadanlığın yoxlanması — çap, skan, çəki üçün sürətli test;
• Avadanlıq parametrləri;
• Fəaliyyət — real vaxtda hadisələr lenti (skan, çəki, çap);
• Yeniləmə — körpünün yeni versiyası çıxıbsa, onu elə buradan quraşdırmaq olar.

Printer əlavə edərkən onun təyinatını seçin: çek, mətbəx və ya etiket üçün. Rol cihazın kartında görünür. O, körpünün daxilində təyinatı müəyyən edir; avadanlığın ayrı-ayrı iş yerləri arasında bölüşdürülməsi — başqa səviyyəli parametrdir. Parametrlərin oxunması alınmasa, ustad təkrarı təklif edəcək və mövcud siyahını saxlayacaq.

Tapılan avadanlığı söndürmək və ya silmək olar. «Söndür» cihazı bütün parametrləri ilə siyahıda saxlayır, amma drayver qalxmır: COM portu boşdur, sorğu yoxdur, rol başqa cihaza keçir — bir düymə ilə geri qoşulur. «Sil» (təsdiqdən sonra) cihazı tamamilə silir və tanış avadanlığın avtomatik tutulması körpünün növbəti işə salınmasında onu artıq qaytarmır. Əvvəllər quraşdırılmış, amma hazırda axtarışın görmədiyi avadanlıq ayrı qrupda göstərilir — əks halda onu idarə etmək mümkün olmazdı.

Hesabda bir neçə körpü ola bilər və hər birinə rol təyin edilir: universal, avadanlıq, kameralar və ya telefoniya. Filialın körpüləri ayrı siyahıda göstərilir — onları adını dəyişmək və standart körpü təyin etmək olar.

Bütün hesabın avadanlığı və buluddan işləmə#

“Bu kompüterin” körpüsündən başqa, səhifədə hesabın avadanlıq reyestri var — şəbəkənin bütün filialları üzrə bütün körpülərin, cihazların və kameraların vahid cədvəli: nəyin harada olduğu, körpünün onlayn olub-olmadığı, hansı filiallara avadanlıq xidməti göstərdiyi görünür. Körpü həmin anda onlayndırsa, cihazı başqa filiala köçürmək olar; oflayn körpüdə reyestr yalnız göstərir, amma dəyişmir.

Reyestrdəki hər maşın üçün “PC detalları” kartı açılır: kompüterin adı, IP və MAC, sistem, model, prosessor, slotlar üzrə yaddaş, boş yeri və vəziyyəti ilə yaddaş qurğuları, bütün qoşulmuş avadanlıq və bütün COM portları — hansı portun kim tərəfindən tutulduğu, hansının boş olduğu qeydi ilə. “Printer var idi, indi görünmür” və ya kassa PC-də yer qurtaranda ilk baxılacaq yer elə burasıdır. Məlumatları körpünün özü toplayır; körpünün köhnə versiyasında avadanlıq siyahısı boş ola bilər — o zaman körpünü yeniləmək kifayətdir.

Lokal kanaldan (brauzer ↔ bu PC-dəki körpü) başqa bulud kanalı da var: əmr körpüyə server vasitəsilə gedir, ona görə qəbz çap etmək və ya printeri yoxlamaq başqa cihazdan mümkündür — məsələn, ofisiant öz telefonundan bardakı kassa printerinə çap edir. Səhifədə bu, körpüdə “bulud bağlantısı” və ayrıca bulud sınaq çapı düyməsi kimi görünür.

Qonşu kompüterin printerinə çap. Printer fiziki olaraq başqa PC-yə qoşulubsa, onu şəbəkədə “paylaşmaq” və ya kabel çəkmək mütləq deyil. Reyestrdəki “Başqa PC-dən çap et” əməliyyatı bu maşında başqa printerə istinad yaradır: sahib kompüter, filial və ad seçilir, sonra sətir “bulud vasitəsilə → sahib PC” kimi işarələnir və tapşırıqlar həmin kompüterin növbəsi ilə çap olunur. Ümumi qovluq, VPN və maşınların birbaşa görünməsi lazım deyil — kifayətdir ki, hər iki körpü eyni filiala xidmət etsin.

Kassanın uzaq ekranı. Həmin səhifədən (və iş çatından gələn dəvətlə) kassa kompüterinin ekranına baxmaq olar — məsələn, kassanın orada nə göstərdiyini öz gözü ilə görmək üçün. Qərarı həmişə qarşı tərəf verir: onun sahibi özündə uzaq girişi işə salmayana qədər qoşulma düyməsi yoxdur və hər seans onun ayrıca razılığını tələb edir — “bir daha soruşma” qəsdən yoxdur. Baxış və idarəetmə — iki fərqli icazədir, pəncərənin bağlanması isə seansı zəmanətlə bitirir.

Əlaqəli bölmələr#

• Kassa (POS) — qəbz çapı və pul qutusunun istifadə olunduğu yer
• Qəbzlər və qaytarmalar — qəbzlərin çapı və təkrarı
• Fiskallaşdırma — fiskal printerlər və onlayn kassalar
• Mətbəxdə və zalda çap — stansiyalar, stikerlər, növbə və kod səhifələri
• Çəkili mal və etiketlər — tərəzi ilə iş, ölçü vahidləri və rəf etiketləri
• Avadanlıq: nə qoşulur — dəmir siniflərinə ümumi baxış və formatlar üzrə minimal dəstlər
• Telefoniya: öz ATS-iniz — telefonlar və şlüzlər avadanlıq körpüsü tələb etmir və öz konturunda işləyir
• İtkilərə nəzarət — körpünün kamerasından təhlükəli əməliyyatların video klipləri

Tez-tez verilən suallar#

Bağlamaq üçün kod daxil etmək lazımdır?#

Adətən yox: körpü kassanın açıldığı həmin PC-də işə salınır və kassa “Yenidən axtar” düyməsi ilə onu özü tapır. Kod yalnız admin panelin açılmadığı kompüterdəki körpü üçün lazımdır — o zaman sahib birdəfəlik kod yazır və onu körpünün səhifəsində daxil edir.

Körpü hansı ƏS-lərdə işləyir?#

Windows və Linux (x64 və ARM64). macOS versiyası planlardadır.

Avadanlıq görünmür — nəyi yoxlamaq lazımdır?#

Körpünün işə salındığına əmin olun (vəziyyət səhifəsi) və “Yenidən axtar” düyməsini basın. Hər cihazın vəziyyəti və sürətli yoxlamalar “Avadanlıq” səhifəsində mövcuddur. Cihaz görünməyibsə, avadanlıq reyestrində bu maşının “PC detalları” kartını açın: orada kompüterin özünün gördüyü bütün dəmir və portu kimin tutduğu qeydi ilə bütün COM portları görünür — bu, adətən problemin kabeldə, portda, yoxsa portu tutan başqa proqramda olduğunu anlamaq üçün kifayət edir.