Instalar o Kiosk NFC num tablet

O Kiosk NFC é o ecrã de check-in à porta da academia. O aluno encosta a pulseira ou cartão NFC ao leitor e a presença fica registada - sem login, sem app, em segundos. Aparece logo na vista ao vivo de quem está no tatame.

Não confundir com o Balcão: o kiosk é o terminal automático de entrada (toca-e-entra); o balcão é o posto de atendimento onde um operador cobra, vende e inscreve. Este guia é do kiosk.

Para a lista de compras com links, ver Hardware recomendado.

Como funciona, em resumo

A Orira corre numa página web de kiosk no teu domínio.
Essa página é ativada uma vez com um token de kiosk que tu, admin, crias no painel.
Quando alguém passa o cartão, o leitor NFC lê o número de série (UID) do cartão e "escreve-o" no ecrã como se fosse teclado - a página apanha-o e faz o check-in.
O ecrã responde por cores: verde (em dia, presença registada), amarelo (pode treinar mas tem pagamento em atraso) e vermelho (bloqueado por atraso de pagamento ou sem inscrição válida).

O detalhe técnico que mais importa: o leitor tem de funcionar em modo emulação de teclado (USB HID) - ou seja, ao ler um cartão digita o UID seguido de Enter, como se fosse um teclado. A maioria dos leitores USB baratos faz exatamente isto e é plug-and-play no Android, sem driver. Os leitores do tipo PC/SC (ex.: ACR122U) não servem para este modo simples. Como confirmar: secção "Ativar o tablet" mais abaixo.

Alternativa sem leitor USB: no Chrome em Android, a página de kiosk também consegue ler pelo NFC do próprio tablet (Web NFC). Funciona, mas é menos cómodo (o aluno tem de encostar à traseira do tablet) e exige um tablet com NFC. O leitor USB externo é a montagem recomendada.

Material necessário

Tablet (ex.: Samsung Galaxy Tab A9) - mostra o ecrã do kiosk.
Leitor NFC USB em emulação de teclado (HID) - lê o cartão e digita o UID.
Adaptador OTG com carga (USB-C) - liga o leitor e carrega o tablet ao mesmo tempo.
Tags NFC (pulseiras ou cartões) - uma por aluno.
Suporte de tablet (opcional) - para fixar o tablet à parede ou balcão.

Modelos concretos e links em Hardware recomendado.

Atenção à frequência: o leitor lê uma frequência (tipicamente 13,56 MHz / NFC, alguns também 125 kHz). As tags têm de ser da mesma frequência do leitor, senão não são lidas. Quase tudo o que é "NFC moderno" é 13,56 MHz (NTAG213/215/216, MIFARE).

Montagem física

Liga o adaptador OTG-com-carga à porta USB-C do tablet.
Liga o carregador à entrada de carga do adaptador (um kiosk fica ligado o dia todo, por isso deve estar sempre na corrente).
Liga o leitor NFC USB à porta USB-A do adaptador.
Coloca o tablet no suporte, virado para quem entra, com o leitor ao alcance da mão.

Preparar o tablet Android (uma vez)

Liga o tablet ao Wi-Fi da academia - estável, porque o kiosk precisa de internet.
Define brilho confortável e bloqueia a rotação (portrait ou landscape, conforme o suporte).

Modo quiosque com Fully Kiosk Browser (recomendado)

O Fully Kiosk Browser é a forma mais robusta de fixar o tablet na página da Orira - impede que alguém saia por engano, mantém o ecrã sempre ligado e reinicia automaticamente ao ligar a corrente.

Instala o Fully Kiosk Browser a partir da Play Store (gratuito; versão PLUS opcional mas não necessária para a Orira).
Abre o Fully Kiosk e, na primeira janela, define a URL de arranque: cola o URL da página de kiosk do teu domínio (o mesmo que abriste no Chrome para inserir o token).
Em Definições → Modo Quiosque, ativa "Ativar Modo Quiosque" - o ecrã fica fixo na URL definida; a barra de navegação e o botão de saída desaparecem.
Em Definições → Modo Quiosque, ativa também "Manter ecrã ligado"

enquanto o tablet estiver na corrente o ecrã nunca apaga.

Em Definições → Outras Definições, ativa "Iniciar ao ligar" - o Fully Kiosk abre sozinho se o tablet reiniciar.
Para sair do modo quiosque (para manutenção): faz um toque longo no ecrã durante 3 segundos → aparece uma janela a pedir o PIN de administrador (defines tu em Definições → Modo Quiosque → PIN).

O leitor NFC (USB HID) funciona exatamente da mesma forma dentro do Fully Kiosk: ao passar o cartão, "digita" o UID no campo da página - não é preciso nenhuma configuração adicional.

Alternativa simples: fixar o ecrã (Android nativo)

Se não quiseres instalar nenhuma app, o Android tem fixação de ecrã integrada:

Abre o Chrome com a página do kiosk já ativa.
Vai a Definições → Segurança → Fixar ecrã (ou Afixar ecrã - o nome varia por fabricante) e ativa a opção.
Abre o seletor de apps recentes e carrega no ícone do Chrome → Afixar.
Para sair: mantém premidos os botões Recentes + Voltar em simultâneo.

É menos robusto que o Fully Kiosk (não reinicia sozinho, não mantém o ecrã ligado) mas serve para uma montagem simples.

Alternativa: iPad

O leitor NFC USB HID também funciona num iPad com porta USB-C através de um adaptador USB-C para USB-A (o mesmo OTG + carga que usas no Android serve, desde que seja compatível com iPadOS).

Modo quiosque no iPad - Acesso Guiado:

O iPadOS tem o Acesso Guiado incorporado, que bloqueia o dispositivo numa só app sem precisar de nenhuma app externa.

Vai a Definições → Acessibilidade → Acesso Guiado e ativa-o.
Define um Código (é o PIN que usas para sair do modo quiosque).
Abre o Safari ou Chrome com a página de kiosk do teu domínio e insere o token (igual ao Android).
Faz triplo clique no botão lateral (ou no botão Home, nos iPads mais antigos) para iniciar o Acesso Guiado → carrega em Iniciar.
O iPad fica bloqueado nessa app. Para sair: triplo clique → introduz o código → Terminar.

Ecrã sempre ligado no iPad:

Vai a Definições → Ecrã e Brilho → Bloqueio automático e define para Nunca (só fica disponível se o iPad estiver a carregar; caso contrário o iOS não permite "Nunca").

Nota: o Web NFC (leitura NFC pelo browser sem leitor externo) não é suportado no Safari nem no Chrome para iOS. O leitor USB HID externo é a única opção no iPad.

Criar o kiosk no painel (admin)

No teu PC, entra como admin e vai a Configuração, secção Kiosk NFC.
No separador de kiosks, carrega no botão para criar um kiosk:

Nome (ex.: "Entrada", "Tatame Principal").
Modalidade (opcional) - se preencheres, este kiosk só aceita check-ins dessa modalidade; deixa vazio para aceitar qualquer aula a decorrer.
Minutos antes / depois - janela em que o check-in é aceite à volta da hora da aula (por omissão 30 antes e 60 depois).

Guarda. Vais ver um token (uma string longa). Copia-o - é a chave que liga o tablet a este kiosk.

Se o token "fugir" (alguém o copiou), usa Regenerar token nesse kiosk: o antigo deixa de funcionar de imediato e tens de reintroduzir o novo no tablet.

Ativar o tablet (uma vez)

No tablet, abre o Chrome na página de kiosk do teu domínio.
Aparece um ecrã de configuração a pedir o token. Cola o token que copiaste e confirma. O token fica guardado no próprio tablet, por isso só fazes isto uma vez por tablet.
Testa o leitor (verificar se é emulação de teclado): abre uma app de notas, toca num campo de texto e encosta um cartão ao leitor.

Se aparecerem números/letras no campo, o leitor é do tipo certo (HID).
Se não aparecer nada, o leitor é provavelmente PC/SC (precisa de app): usa o modo Web NFC do Chrome Android ou troca de leitor.

Volta à página de kiosk e passa um cartão já atribuído a um aluno (ver secção seguinte). Deve aparecer o ecrã verde com o nome.

Adiciona a página de kiosk ao ecrã inicial do tablet para abrir com um toque.

Comprar as tags NFC

Há duas formas de ter tags. A recomendada é encomendá-las à Orira.

Opção A (recomendada): encomendar tags personalizadas à Orira

No Orira Hub existe uma página própria para isto, em Encomendas.

Personalizas a tag (texto e cores, com pré-visualização 3D).
Escolhes o pack (20, 50 ou 100 - packs maiores trazem unidades bónus).
Confirmas a morada de entrega e o email de fatura (já vêm preenchidos com os dados da academia).
A Orira valida, produz, expede e fatura à academia.

Esta é a via mais simples: recebes tags já com a imagem da tua academia, prontas a atribuir. A partir da secção Kiosk NFC da Configuração há também um atalho que te leva direto a esta página.

Opção B (alternativa): comprar tags genéricas

Se preferires, podes comprar um lote de tags NFC em branco de 13,56 MHz (NTAG215/216 ou MIFARE) em qualquer loja. Não há nada a "gravar": a Orira usa o número de série de fábrica de cada tag. Detalhes em Hardware recomendado.

Atribuir uma tag a um aluno

Independentemente de onde compraste as tags, atribuis cada uma a um aluno no painel:

Entra como admin em Configuração, secção Kiosk NFC, separador de atletas (ou, no Balcão, na ação Tags NFC).
Procura o aluno por nome ou email.
No campo NFC, encosta a tag ao leitor (ou escreve o UID) e guarda.
Se a tag já estiver atribuída a outra pessoa, a app avisa (conflito) e pergunta se queres reatribuir - útil quando um aluno perde a pulseira e lhe dás outra.

Privacidade: o UID nunca é guardado em texto simples - a Orira guarda um hash com um segredo do servidor. Mesmo que a base de dados fosse comprometida, ninguém consegue clonar cartões a partir dela. Por isso, na lista, só vês os últimos dígitos como "impressão digital".

Quando o aluno pede uma 2ª via (pulseira nova)

O aluno vai ao seu Perfil, cartão Tag NFC, e carrega no botão para pedir 2ª via.
Escolhe método de pagamento (MB WAY, IBAN ou numerário) e anexa comprovativo (ou nota de entrega, se numerário).
É criado um pagamento do tipo taxa de tag NFC (valor configurável em Configuração) a aguardar validação, e tu recebes email.
Validas o pagamento e atribuis uma nova tag ao aluno.

O valor da taxa e os dados de pagamento (IBAN/MB WAY do chefe da academia) configuram-se na Configuração da academia.

Operação no dia-a-dia

Logs: na secção Kiosk NFC da Configuração, o separador de logs mostra cada passagem de cartão (entradas, avisos de pagamento, bloqueios, "cartão não reconhecido"). Atualiza sozinho enquanto vês o dia de hoje.
Vista ao vivo: abre a vista do tatame noutro ecrã ou TV para ver quem está presente em tempo real (avatar, graduação, peso, idade).
Vários kiosks: podes ter mais do que um (ex.: um por sala), cada um com o seu token e, se quiseres, fixado a uma modalidade.

Resolução de problemas

O ecrã pede token outra vez - a cache foi limpa ou o token foi regenerado. Volta a colar o token na página de kiosk.
Passo o cartão e não acontece nada - o leitor não é HID (é PC/SC) ou o cabo/adaptador está mal ligado. Testa numa app de notas; troca de adaptador ou leitor.
"Cartão não reconhecido" - a tag não está atribuída a ninguém. Atribui na secção Kiosk NFC da Configuração, separador de atletas.
Cartão lido mas dá vermelho - sem inscrição ativa, atraso de pagamento, ou fora da janela de horário. Verifica inscrição, pagamentos e a hora da aula.
O tablet desliga o ecrã - poupança de energia. Mantém o ecrã ligado ao carregar e o tempo limite no máximo.
O tablet "sai" da página - falta o modo quiosque. Instala o Fully Kiosk Browser ou ativa a fixação de ecrã nativa do Android (ver secção "Preparar o tablet Android").
A tag nova não é lida - frequência diferente do leitor. Usa tags de 13,56 MHz (NFC).