Instalação do leitor de digital
Com o leitor, o cliente encosta o dedo e a comanda dele abre sozinha no Bar. O leitor é opcional: sem ele, o Víbora funciona normalmente.
O Víbora funciona com o leitor biométrico USB iDBio, da Control iD. Outras marcas e modelos de leitor não são compatíveis com este programa.
O que você precisa
- Um leitor iDBio (Control iD), ligado em uma porta USB do computador do balcão.
- Um computador com Windows (10 ou 11 recomendado) no balcão do bar.
- O navegador Google Chrome ou Microsoft Edge para abrir o painel do Víbora.
Passo a passo
- Baixe o programa pelo botão acima e descompacte a pasta em um lugar fixo, por exemplo
C:\vibora-agente-digital. - Plugue o leitor na USB. No Windows 10 ou 11 o driver instala sozinho. Para conferir, abra o Gerenciador de Dispositivos e procure em Portas (COM e LPT): deve aparecer
iDBio (COMx). - Instale o Python em python.org/downloads. Na primeira tela do instalador, marque “Add Python to PATH”. Esse passo é obrigatório.
- Na pasta que você descompactou, dê dois cliques em
iniciar.bat. Abre uma janela preta com a mensagemAgente do leitor ativo. Deixe a janela aberta (pode minimizar). - Abra o painel do Víbora no Chrome ou Edge e entre na tela do Bar. Deve aparecer “Leitor conectado: encoste o dedo para abrir a comanda”.
Para abrir sozinho quando ligar o computador: aperte Win + R, digite shell:startup e coloque nessa pasta um atalho para o iniciar.bat.
Como usar
- Cadastrar a digital: ao abrir uma Nova comanda, marque “Cadastrar a digital do cliente agora”, ou use o botão Cadastrar digital dentro da comanda. Marque a autorização do cliente e clique em Ler digital no leitor.
- Conferência e 3 leituras: o primeiro toque confere se o dedo já está cadastrado (uma digital só pode ser de uma pessoa). Depois o cliente encosta o mesmo dedo 3 vezes. Por fim, clique em Salvar digital.
- Atender: na tela do Bar, é só o cliente encostar o dedo. A comanda dele abre. Se o dedo não for encontrado, aparece o aviso para tentar de novo.
Problemas comuns
“Leitor não detectado neste computador”
O iniciar.bat precisa estar aberto, com a janela preta ativa. Confira também se o painel está aberto no Chrome ou Edge, no mesmo computador do leitor. A tela confere sozinha a cada 3 segundos.
“O Python não foi encontrado”
O Python foi instalado sem marcar “Add Python to PATH”. Reinstale marcando essa opção.
O Windows não acha o leitor sozinho
No Gerenciador de Dispositivos, veja o número da porta (por exemplo COM3). Abra o iniciar.bat no Bloco de Notas e troque python agente.py por python agente.py --com COM3.
“Preparando o leitor…” demora
Feche as outras abas do Bar ou das Comandas abertas no navegador (só uma deve ficar aberta), feche a janela preta e abra o iniciar.bat de novo.
“Leitura fraca”
Encoste o dedo inteiro no vidro do leitor, sem apertar demais, e segure por um instante. Dedos muito secos ou molhados leem pior.
Privacidade (LGPD)
O Víbora guarda apenas um código da digital, nunca a imagem. As digitais ficam gravadas no próprio leitor. O cliente precisa autorizar o uso da digital, e o sistema registra essa autorização.
Fale com o suporte pelos botões no rodapé da página inicial. Se aparecer algum erro na janela preta, tire uma foto e envie.
