Poglavlje 3 — Aplikacija Bridge (most za povezivanje hardvera)

Prodajna blagajna radi u pregledniku, a preglednik ne može izravno komunicirati s čitačem kartica, pisačem, vagom i zaslonom za kupca. Aplikacija Bridge je taj most: radi uz blagajnu i povezuje te uređaje s blagajnom.

Dolazi u tri oblika koji svi rade isto (verzija za iOS je eksperimentalna):

• Android aplikacija na tabletu
• Aplikacija za stolno računalo na računalu (Windows/Mac/Linux)
• Aplikacija za iOS (eksperimentalna)

⚠️ Jezik: sučelje Android aplikacije je praktički engleski. Samo je nekoliko starih nizova prevedeno na njemački; cijela nadzorna ploča koju operater vidi (statusi, Power Guard, Keep Bridge Awake, zapisnici itd.) je na engleskom.

💡 Bridge obično postavite jednom i nakon toga radi u pozadini. Adresu Bridgea unosite u blagajni pod blagajna → postavke → Bridge (priručnik blagajne, poglavlje 9). Android aplikacija radi kao trajna usluga u prednjem planu: ostaje aktivna i kada aplikaciju zatvorite iz popisa, nakon ažuriranja se automatski ponovno pokreće, a nadzornik svakih 30 sekundi po potrebi ponovno podiže poslužitelj.

3-1. Android aplikacija — stranica statusa

Cjelozaslonska stranica (kiosk) s jednim sažetim retkom na vrhu i nekoliko statusnih kartica. Pri pokretanju vidite poruku „Most se priprema; povezuju se čitač kartica i zaslon za kupca".

• Ukupni sažetak na vrhu stranice, npr.: „Most spreman za plaćanje", „Čitač kartica spreman, čeka preglednik", „Preglednik povezan / čitač kartica izvan mreže", „Uspostavljanje veze s čitačem kartica" ili „Transakcija je u tijeku".
• Statusne kartice (svaka ima obojenu točku i statusnu riječ):
• WebSocket — lokalni port na koji se blagajna povezuje.
• Preglednik (Browser) — je li blagajna povezana.
• Čitač kartica (POS Terminal) — statusi: prekinuto / uspostavljanje veze / ponovno uspostavljanje veze / povezano / zauzeto (Busy) tijekom transakcije.
• Zaslon za kupca — status drugog zaslona.
• Power Guard — zaštita baterije/procesora/Wi-Fija radi sprječavanja prekida u mirovanju.

Kartica adrese Bridgea

• Prikazuje adresu (lokalno 127.0.0.1:PORT ili mrežnu adresu s IP-om uređaja) koju treba unijeti u blagajnu.
• Gumb načina povezivanja ima tri stanja i pri svakom pritisku kruži: lokalno → mreža → automatski (Auto). Automatski način koristi mrežu ako je dostupna lokalna mrežna adresa, inače lokalno.
• Držanje gumba načina povezivanja: izrada ili brisanje tokena za uparivanje — šesteroznamenkastog koda koji se dodaje adresi (?token=XXXXXX) tako da se može povezati samo ovlaštena blagajna. Taj token djeluje samo u mrežnom načinu (u lokalnom se načinu zanemaruje) i u adresi se prikazuje kao „Paired/Open".

Ostale kartice i pristup zapisnicima

• Power Guard → „održavanje mosta budnim" (Keep Bridge Awake): otvara Androidove postavke baterije kako se Bridge ne bi prekinuo u mirovanju.
• Zapisnici: uključuju/isključuju se gumbom Enable/Disable Logs, a View Logs otvara stranicu zapisnika; isključivanjem se spremljeni zapisnici brišu. Drugi je način za otvaranje zapisnika dugi pritisak (long-press) na traku na vrhu zaslona.
• Stranica zapisnika: samo za čitanje — tekst jednolične širine koji se svake sekunde osvježava i pomiče prema dolje; nema gumba za dijeljenje/izvoz (za slanje podršci morate ga ručno kopirati).
• Stranica zaslona za kupca: na drugom zaslonu prikazuje kupcu stavke i zbroj narudžbe pomoću web-predloška. Na Androidu se automatski prikvači na svaki povezani drugi zaslon (bez ručnog odabira; odspajanjem kabela se uklanja).

3-2. Aplikacija za stolno računalo — „LonioBridge — Host"

Mali upravljački prozor za pokretanje Bridgea na računalu:

• Obrazac za postavljanje:
• Port WebSocketa (zadano 8088)
• Adresa vezivanja (Bind): samo ovo računalo ili cijela mreža (zadano 0.0.0.0).
• Zaslon za kupca: ručni odabir monitora koji će služiti kao zaslon za kupca (ili nijedan).
• Pokreni/Zaustavi za pokretanje mosta; postavke se čuvaju u datoteci ~/.loniobridge/host.properties između pokretanja.
• Automatsko pokretanje (Autostart): parametrom --autostart (instalacijski program na Windowsu ga postavlja skriptama za aktivaciju/deaktivaciju tako da se podigne pri pokretanju sustava).
• Način bez prozora (Console): s --console može se pokrenuti bez grafičkog sučelja.
• Ploča statusa: stanje poslužitelja (zaustavljeno / pokretanje / osluškivanje na portu / nevaljan port / pogreška), broj povezanih blagajni, status čitača kartica i pokazatelj zauzeto/u mirovanju (tijekom transakcije).
• Izvještaj o aktivnosti: vremenski označen zapisnik događaja; opcija Verbose za bilježenje neobrađenih okvira čitača kartica (samo za otklanjanje pogrešaka).

⚠️ U prozoru za stolno računalo nema odabira pisača ni vage; samo port, adresa vezivanja i zaslon za kupca. Pisač i vaga konfiguriraju se sa strane blagajne, a Bridge ih postavlja prema poruci blagajne.

3-3. Koji se uređaji povezuju

• Čitač kartica: postoje dva upravljačka programa koji se biraju u profilu terminala:
• ZVT (zadano) — putem mreže/TCP-a, s automatskim ponovnim povezivanjem (backoff) i statusima uspostavljanje veze/oporavak/povezano.
• GP Tom (SoftPOS) — upravljački program tvrtke Global Payments koji na istom Android tabletu komunicira s GP aplikacijom čitača kartica (prodaja/poništenje/povrat; dnevni obračun putem ovog App2App puta još nije podržan).
• Zaslon za kupca: web-predložak (stavke i zbroj narudžbe) koji blagajna šalje na njega; na Androidu se automatski prikvači, na stolnom računalu ručnim odabirom monitora.
• Pisač:
• ⚠️ Na Androidu se ispis trenutačno samo prihvaća, ali stvarno izvršavanje ispisa nije provedeno; stvarni ispis radi na stolnom računalu.
• Stolno računalo ima tri načina: serijski, sistemski pisač (Windows) i mreža/TCP (zadano, port 9100); uključujući rezanje papira i otvaranje ladice za novac.
• Vaga: samo na stolnom računalu — serijski ili USB-HID, s prepoznavanjem jedinice (kg/g/lb/oz) i stabilnim/nestabilnim načinom. Android nema vagu.

3-4. Konfiguracija koju osoba koja postavlja mora znati

• Port (zadano 8088) i adresa vezivanja (lokalno naspram mreže).
• Razlika između 127.0.0.1 (lokalno) i mrežnog IP-a: ako je blagajna na istom uređaju, dovoljno je lokalno; ako je na drugom uređaju, potreban je mrežni način + IP, a oba moraju biti na istoj mreži.
• Token za uparivanje (?token=…) samo u mrežnom načinu.
• Androidove postavke baterije (Keep Bridge Awake) za sprječavanje prekida.

3-5. Brzo otklanjanje pogrešaka