Dispositivi

Jonot dispone di tre tipi di dispositivi, ciascuno con un ruolo distinto nel flusso di lavoro della coda. Tutti i dispositivi vengono abbinati a una sede (e facoltativamente a una coda) tramite un codice di abbinamento di breve durata, generato sul dispositivo e poi inserito in Admin.

Tipi di dispositivo

Chiosco

Il tablet posizionato all’ingresso della sede. I clienti interagiscono con il chiosco per mettersi in coda. In produzione, Jonot esegue solitamente il chiosco come app nativa dedicata sul tablet, dove disponibile (oggi: Android). Sono possibili anche configurazioni chiosco basate su browser. Su Android, il chiosco può collegarsi a una stampante ESC/POS per emettere scontrini fisici dei biglietti. Il chiosco è abbinato a una coda specifica.

Superficie: app chiosco dedicata dove disponibile, oppure https://kiosk.jonot.io

Display

Una TV o un monitor nell’area d’attesa che mostra lo stato della coda in tempo reale — quali numeri di biglietto vengono chiamati in quel momento, presso quale sportello, quanti clienti sono in attesa, un’anteprima dei prossimi numeri da chiamare e una cronologia visiva delle chiamate recenti. Vengono riprodotti annunci audio quando viene chiamato un nuovo numero. Si aggiorna in tempo reale via WebSocket.

Superficie: https://display.jonot.io

Sportello

L’interfaccia rivolta al personale usata per chiamare il cliente successivo, completare il servizio o saltare un assente. Può funzionare come app nativa dedicata su un tablet fisso al banco, dove disponibile (oggi: Android), oppure nel browser su PC/tablet. Lo sportello è abbinato a una coda specifica. Il personale non ha bisogno di account Jonot individuali — la sessione dello sportello stessa funge da credenziale.

Superficie: app sportello dedicata dove disponibile, oppure https://desk.jonot.io

Modello di abbinamento

Tutti e tre i tipi di dispositivo usano la stessa procedura di abbinamento:

1. Sul dispositivo fisico, apri la schermata di abbinamento nel runtime pertinente. Per chiosco e sportello, si tratta solitamente dell’app dispositivo dedicata sul tablet; le configurazioni basate su browser possono invece aprire https://kiosk.jonot.io/pair/ o https://desk.jonot.io/pair/. I display usano attualmente https://display.jonot.io/pair/. Il dispositivo richiede un codice di abbinamento di 7 caratteri (ad esempio K7M-4PQ) e lo mostra sullo schermo. Il codice è valido per 10 minuti.
2. Un amministratore dell’organizzazione o un responsabile di sede apre la sede in Admin, va nella scheda Dispositivi, fa clic su Abbina dispositivo e inserisce il codice mostrato sullo schermo del dispositivo.
3. Il server attiva il dispositivo, crea una DeviceSession ed emette un token dispositivo di lunga durata. Il dispositivo rileva l’attivazione e apre la sua schermata operativa. Un chiosco Android appena abbinato senza stampante configurata viene prima reindirizzato alla configurazione della stampante.

Se il codice scade prima di essere inserito in Admin, torna alla schermata di abbinamento del dispositivo per richiederne uno nuovo. Nelle configurazioni basate su browser, questo significa tornare all’URL /pair pertinente. Il vecchio codice viene invalidato automaticamente.

Ciclo di vita della DeviceSession

Una DeviceSession viene creata al momento dell’abbinamento e persiste finché non viene revocata manualmente in Admin o la sessione scade. Contiene:

• Tipo di dispositivo (chiosco / display / sportello)
• Assegnazione della sede
• Assegnazione facoltativa della coda (chiosco, sportello, display)
• Assegnazione facoltativa dello sportello (display — vedi sotto)
• Nome visualizzato facoltativo (es. “Sportello 1”, “Chiosco A”)
• Timestamp dell’ultimo contatto
• Stato online/offline

Per revocare una sessione dispositivo, vai in Admin → sede → Dispositivi, trova il dispositivo e fai clic su Revoca. Il dispositivo verrà bloccato alla sua prossima richiesta.

Assegnazione del display

Un display ha due assi di assegnazione indipendenti — quali code mostra e (facoltativamente) su quale sportello concentrarsi.

L’assegnazione della coda controlla il layout del pannello:

• Coda singola — una coda assegnata; il display usa il layout a coda singola, in primo piano il biglietto attualmente in servizio.
• Pannello multi-coda — 2–5 code assegnate; il display le mostra affiancate, con ogni colonna aggiornata in modo indipendente.
• Vista della sede (tutti gli sportelli) — nessuna coda assegnata; il display mostra tutte le chiamate attive dell’intera sede.

Il collegamento allo sportello è una sovrapposizione facoltativa a qualsiasi delle opzioni precedenti:

• Collegato a uno sportello — assignedDeskSessionId viene impostato su una sessione sportello specifica. Finché quello sportello è online, il display mostra solo i biglietti da esso chiamati in una vista a biglietto singolo concentrata. Utile quando ogni sportello ha un proprio schermo.
• Non collegato — assignedDeskSessionId è null. Il display segue la sua assegnazione di coda come descritto sopra.

Se un display è collegato a uno sportello e quello sportello va offline per più di 2 minuti, il display torna automaticamente alla vista sede. Ritorna alla modalità collegata allo sportello quando lo sportello si riconnette.

Consulta Abbinare un display per la procedura guidata rivolta all’operatore e Personalizzare il display per i dettagli sul layout del pannello.

Comportamento offline

I dispositivi mantengono una connessione WebSocket con l’API di Jonot. Il server tiene traccia di lastSeenAt per ogni sessione dispositivo. Nell’elenco Dispositivi, Admin contrassegna un dispositivo come Online mentre è connesso; una volta che il suo timestamp dell’ultimo contatto supera una soglia, la colonna di stato mostra invece da quanto tempo è stato visto l’ultima volta. I dispositivi si riconnettono automaticamente al ripristino della rete — non è necessario alcun intervento manuale.

Credenziale dello sportello

Lo sportello si autentica usando il token dispositivo emesso al momento dell’abbinamento, non un account utente personale. Questo significa che qualsiasi membro del personale che usa quel dispositivo ottiene l’accesso allo sportello senza effettuare il login. Per limitare l’accesso, revoca la sessione dispositivo e riabbina solo dispositivi autorizzati.