e eFicha · guia de campo

Instalação da máquina

Tudo é feito por você, sozinho, pelo painel no seu celular ou notebook.

A máquina não usa internet. Nem o wi-fi do bar, nem cabo. Ela funciona sozinha.

Quem precisa de internet é o seu celular ou notebook, para abrir o painel — o 4G do seu telefone serve.

Etapa 1 de 2

Antes de instalar

Etapa 2 de 2

Instalação

  1. Instalar

    Copie o .zip do pendrive para o PC da máquina, clique nele com o botão direito → Extrair tudo, e mande extrair para C:\eFicha. Abra essa pasta e rode MVP.eFicha.Validador_Console.exe.

    Extraia mesmo, não rode de dentro do zip. O Windows deixa abrir o programa com um duplo clique lá dentro, mas ele fica numa pasta temporária: o pareamento até funciona e some no primeiro reinício, e a máquina volta a recusar toda ficha sem motivo aparente.

    O Windows vai avisar que o programa é de origem desconhecida. É esperado: toque em Mais informações → Executar assim mesmo. Foi para isso que você conferiu o SHA-256 antes de sair.

    Se o antivírus apagar o arquivo ou impedir a execução, também é esperado — o programa não tem assinatura digital. Libere a pasta C:\eFicha nas exceções do antivírus e extraia de novo. Se o antivírus for de terceiro e você não tiver a senha dele, pare e ligue para o Jonas: instalar com o executável mutilado dá uma máquina que parece pronta e recusa cliente.

    Se for a primeira vez naquele PC, a tela mostra:

    [boot] MAQUINA NAO PAREADA. Nenhuma ficha sera aceita. [boot] Tecle P para entrar no modo pareamento.

    Está certo. A máquina ainda não sabe quem ela é.

  2. Parear

    Aqui a máquina aprende a identidade dela. Como ela não tem rede, a informação vai do seu celular para ela pelo leitor de QR code — o mesmo que lê a ficha do cliente.

    seu celular
    leitor QR code

    A informação atravessa por luz. É só isso que a máquina tem.

    1. No celular, abra a ordem e toque em Parear máquina.
    2. A tela mostra uma sequência de QR codes, passando sozinha em laço.
    3. Aumente o brilho do celular ao máximo.
    4. Segure a tela na frente do leitor, a uns 20–30 cm, e espere.

    Não precisa acertar a ordem dos quadros, e pode repetir quantas vezes quiser — a máquina vai juntando os pedaços conforme lê. No console aparece [pareamento] quadro 2/4, e assim por diante.

    Quando terminar:

    [pareamento] CONCLUIDO maquina=7 geracao=1 mesas=3 [pareamento] credencial ativa. Ja aceita fichas assinadas.

    O pareamento vale 15 minutos e serve uma vez só. Se demorar ou der errado, toque em Gerar novo pareamento — pode gerar quantos precisar.

  3. Autoteste

    Antes de teclar, deixe o Visual Pinball aberto e o som do Windows ligado. O autoteste conversa com o emulador e toca um aviso: com o Visual Pinball fechado, ele acusa falha em algo que na verdade está inteiro, e você perde a viagem procurando defeito onde não tem.

    Na máquina, tecle T.

    Ele testa cinco coisas. Em uma delas ele para e pede sua ajuda: precisa que o leitor leia um QR de teste. Você tem 90 segundos.

    No celular, na mesma ordem, toque em Ficha de teste e mostre o QR para o leitor — igual ao pareamento, brilho no máximo.

    Essa ficha não existe na carteira de ninguém e não abre partida. Serve só para a máquina provar que lê, e que a credencial dela está certa.

    No fim aparece o resultado e o código de conclusão:

    [ok] audio tocou [ok] mesas casaram com o catalogo [ok] emulador respondeu [ok] camera leu QR [ok] ficha assinada verificada A maquina esta pronta para receber cliente.
    K7QM‑3XAP‑9TVR também salvo em C:\ProgramData\eFicha\ultimo-codigo-conclusao.txt
  4. Fechar a ordem

    No celular: Fechar com código do autoteste. Digite o código e pronto.

    Pode digitar em minúscula, sem hífen, com espaço — o campo corrige. Se você vir O na tela e digitar zero, ele também entende.

Referência

O que cada resultado significa

ItemSe falhar
câmera leu QR
ficha assinada verificada
Os dois vêm juntos: ou o leitor não enxergou, ou a credencial está errada. Confira luz, distância e foco; se insistir, pareie de novo. Sem eles a máquina não lê ficha de cliente nenhum.
áudio tocou A máquina funciona muda. Confira a caixa de som e o volume do Windows.
mesas casaram Alguma mesa do painel não tem arquivo .vpx correspondente no PC. A ficha continua valendo; o que falta é a máquina saber qual arquivo abrir.
emulador respondeu O comando de crédito não chegou no Visual Pinball. Confira se ele está aberto.

Os dois primeiros impedem a máquina de operar. Os outros três atrapalham, mas não travam nada — e nenhum deles impede fechar a ordem. O código registra o que passou e o que não passou; quem lê depois decide o que fazer.

Referência

Quando algo não funciona

O que você vêO que fazer
MAQUINA NAO PAREADANunca foi pareada, ou o Windows foi reinstalado. Tecle P e pareie.
pacote EXPIRADOPassou dos 15 minutos. Gere outro no celular.
pacote EXPIRADO
logo depois de gerar
O relógio do PC está errado. Acerte a data e a hora do Windows e tente de novo.
este pacote ja foi usadoPareamento serve uma vez só. Gere um novo.
leitura corrompidaO leitor leu errado. Ele recomeça sozinho — mostre os quadros de novo.
nao foi possivel gravar
a credencial
Falta permissão ou disco. Rode como administrador.
Codigo nao confere
no painel
Digitação, ou você pareou de novo depois do autoteste. Confira os caracteres; se insistir, rode o autoteste outra vez.
A máquina recusa toda fichaNão pareada, ou credencial de outro PC. Tecle S para ver o estado.

Se o autoteste não roda de jeito nenhum e você precisa ir embora: use Fechar sem autoteste no painel e descreva o que verificou à mão. A ordem fica marcada assim, o que é honesto — melhor do que ficar aberta para sempre.

Referência

Teclas da máquina

TeclaO quê
Pliga e desliga o modo pareamento
Troda o autoteste
Xexporta a lista de fichas usadas para um arquivo
Smostra o estado: máquina, mesas, sessão aberta
Eencerra a sessão de mesa aberta
Qfecha o programa

O X serve para quando um cliente reclama que a ficha não entrou: gera um arquivo em C:\ProgramData\eFicha\ com tudo que a máquina registrou.

O que a máquina fala com o cliente

VozQuando
Ficha aceita. Boa partida!primeira ficha — abre a mesa
Crédito adicionado.mais uma ficha da mesma mesa
Esta ficha já foi usada.ficha repetida
Gere uma ficha desta mesa
ou aperte sair.
ficha de outra mesa, com sessão aberta
Esta ficha não é desta máquina.ficha de outra máquina
Ficha inválida. Procure o gerente.QR falso ou danificado
Máquina não configurada.
Procure o gerente.
não pareada

Importante

Duas coisas para nunca fazer

Não apague o eficha.db

Em C:\ProgramData\eFicha\. É a lista das fichas já usadas. Como a máquina não tem internet, essa é a única cópia que existe — apagar faz toda ficha antiga voltar a valer.

Não copie a pasta de uma máquina para outra

A identidade é de um PC só, e o arquivo nem abre em outro. Cada máquina se pareia sozinha.

Trocar o PC de uma máquina

  1. Abra uma ordem nova para aquela máquina.
  2. Instale no PC novo e pareie normalmente.
  3. As fichas que os clientes já compraram continuam funcionando.

Se der para ligar o PC velho antes de trocar, tecle X e guarde o arquivo — é o histórico daquela máquina.