Dispositivos

O Jonot tem três tipos de dispositivo, cada um com um papel distinto no fluxo de trabalho da fila. Todos os dispositivos são associados a um estabelecimento (e opcionalmente a uma fila) usando um código de associação de curta duração, gerado no dispositivo e depois inserido no admin.

Tipos de dispositivo

Quiosque

O tablet colocado à entrada do estabelecimento. Os clientes interagem com o quiosque para entrar numa fila. Em produção, o Jonot normalmente executa o quiosque como uma aplicação nativa dedicada no tablet, onde disponível (hoje: Android). São também possíveis implementações de quiosque baseadas no navegador. No Android, o quiosque pode ligar-se a uma impressora ESC/POS para emitir recibos físicos de senha. O quiosque está associado a uma fila específica.

Superfície: aplicação de quiosque dedicada, onde disponível, ou https://kiosk.jonot.io

Visor

Uma televisão ou monitor na zona de espera que mostra o estado da fila em tempo real — que números de senha estão a ser chamados neste momento, em que balcão, quantos clientes estão em espera, uma pré-visualização dos próximos números a chamar e um histórico visual das chamadas recentes. São reproduzidos anúncios sonoros quando um novo número é chamado. Atualiza-se em tempo real via WebSocket.

Superfície: https://display.jonot.io

Balcão

A interface voltada para o pessoal usada para chamar o próximo cliente, concluir o atendimento ou marcar uma ausência. Pode correr como uma aplicação nativa dedicada num tablet fixo do balcão, onde disponível (hoje: Android), ou no navegador, num PC/tablet. O balcão está associado a uma fila específica. O pessoal não precisa de contas Jonot individuais — a própria sessão do balcão é a credencial.

Superfície: aplicação de balcão dedicada, onde disponível, ou https://desk.jonot.io

Modelo de associação

Os três tipos de dispositivo usam o mesmo processo de associação:

1. No dispositivo físico, abra o ecrã de associação no runtime relevante. Para o quiosque e o balcão, é normalmente a aplicação de dispositivo dedicada no tablet; as configurações baseadas no navegador podem, em alternativa, abrir https://kiosk.jonot.io/pair/ ou https://desk.jonot.io/pair/. Os visores usam atualmente https://display.jonot.io/pair/. O dispositivo solicita um código de associação de 7 carateres (por exemplo, K7M-4PQ) e apresenta-o no ecrã. O código é válido durante 10 minutos.
2. Um gestor da organização ou gestor do local abre o estabelecimento no admin, vai ao separador Dispositivos, clica em Associar dispositivo e insere o código apresentado no ecrã do dispositivo.
3. O servidor ativa o dispositivo, cria uma DeviceSession e emite um token de dispositivo de longa duração. O dispositivo deteta a ativação e abre o seu ecrã de funcionamento. Um quiosque Android recém-associado sem impressora configurada é redirecionado primeiro para a configuração da impressora.

Se o código expirar antes de ser inserido no admin, regresse ao ecrã de associação do dispositivo para solicitar um novo código. Em configurações baseadas no navegador, isso significa voltar ao URL /pair relevante. O código antigo é invalidado automaticamente.

Ciclo de vida da DeviceSession

Uma DeviceSession é criada no momento da associação e persiste até ser manualmente revogada no admin ou até a sessão expirar. Contém:

• Tipo de dispositivo (quiosque / visor / balcão)
• Atribuição de estabelecimento
• Atribuição de fila opcional (quiosque, balcão, visor)
• Atribuição de balcão opcional (visor — ver abaixo)
• Nome de apresentação opcional (ex.: “Balcão 1”, “Quiosque A”)
• Registo de data/hora da última atividade
• Estado online/offline

Para revogar uma sessão de dispositivo, aceda a admin → estabelecimento → Dispositivos, encontre o dispositivo e clique em Revogar. O dispositivo ficará bloqueado no seu próximo pedido.

Atribuição do visor

Um visor tem dois eixos de atribuição independentes — que filas mostra e, opcionalmente, um balcão em que se foca.

A atribuição de filas controla o esquema do painel:

• Fila única — uma fila atribuída; o visor usa o esquema de fila única, destacando o número em atendimento.
• Painel multifila — 2 a 5 filas atribuídas; o visor mostra-as lado a lado, cada coluna atualizada de forma independente.
• Vista do estabelecimento (todos os balcões) — nenhuma fila atribuída; o visor mostra todas as chamadas ativas em todo o estabelecimento.

A associação a um balcão é uma sobreposição opcional a qualquer uma das opções acima:

• Associado a um balcão — define assignedDeskSessionId para uma sessão de balcão específica. Enquanto esse balcão estiver online, o visor mostra apenas as senhas que ele chama, numa vista focada de senha única. Útil quando cada balcão tem o seu próprio ecrã.
• Sem associação — assignedDeskSessionId é null. O visor segue a sua atribuição de filas, conforme descrito acima.

Se um visor estiver associado a um balcão e esse balcão ficar offline durante mais de 2 minutos, o visor volta automaticamente à vista do estabelecimento. Regressa ao modo associado ao balcão quando este se reconectar.

Consulte Associar um Visor para o guia orientado ao operador e Personalizar o Visor para detalhes sobre o esquema do painel.

Comportamento offline

Os dispositivos mantêm uma ligação WebSocket à API do Jonot. O servidor regista lastSeenAt para cada sessão de dispositivo. Na lista de Dispositivos, o admin marca um dispositivo como Online enquanto estiver ligado; quando o registo da última atividade ultrapassa um limite, a coluna de estado mostra há quanto tempo foi visto pela última vez. Os dispositivos reconectam-se automaticamente quando a rede é restabelecida — não é necessária qualquer intervenção manual.

Credencial do balcão

O balcão autentica-se usando o token de dispositivo emitido no momento da associação, não uma conta de utilizador pessoal. Isto significa que qualquer membro do pessoal a usar esse dispositivo obtém acesso ao balcão sem iniciar sessão. Para restringir o acesso, revogue a sessão do dispositivo e volte a associar apenas com dispositivos autorizados.