GSMPass — Instalação, Configuração e Operação

O GSMPass é instalado por fora da Play Store, direto pelo arquivo APK.

1. Copie o arquivo `app-release.apk` para o tablet ou celular (por Quick Share, cabo USB, ou qualquer outro meio).

2. Se estiver **atualizando** uma instalação já existente, desinstale a versão antiga primeiro (Configurações do Android > Apps > GSMPass > Desinstalar). Instalar por cima às vezes trava com "App não instalado".

3. Toque no arquivo APK para instalar. Se o Android bloquear e pedir permissão para "instalar de fontes desconhecidas", autorize e tente novamente.

4. Abra o app depois de instalado.

Repita essa instalação em **todos os aparelhos** que vão rodar o GSMPass: o Totem (onde o cliente tira a senha) e o Painel (onde a senha é chamada).

No primeiro aparelho, é preciso criar a conta da empresa antes de logar.

1. Na tela inicial do app, toque em **"Não tem uma conta? Cadastre-se"**.

2. Preencha:

   - **Email** — vai ser o login usado em todos os aparelhos da empresa.

   - **CNPJ da empresa** — identifica a empresa (usado futuramente num painel de monitoramento).

   - **Senha** e **Confirmar senha** — as duas precisam ser iguais.

3. Toque em **Cadastrar**.

Depois de cadastrada, a conta já pode ser usada para logar nos outros aparelhos.

O Totem e o Painel se sincronizam automaticamente por estarem logados na **mesma conta** (mesmo email e senha) — não existe pareamento manual entre os dois aparelhos.

1. Em cada aparelho, abra o GSMPass.

2. Informe o **email** e a **senha** cadastrados no Passo 2.

3. Toque em **Entrar**.

A partir daí, uma senha emitida no Totem já aparece automaticamente disponível para chamada no Painel.

Depois do login, o app pergunta qual função aquele aparelho vai exercer:

- **Totem** — a tela onde o cliente toca para tirar a senha (Normal ou Preferencial).

- **Painel** — a tela que fica exibindo e chamando a senha atual (geralmente montada na parede, à vista de todos).

Escolha a opção correspondente ao uso daquele aparelho específico. Essa escolha pode ser trocada depois, sem precisar deslogar (veja o Passo 5).

Tanto o Totem quanto o Painel rodam em tela cheia, sem menus visíveis — isso evita que clientes ou o público mexam onde não devem.

Para acessar as opções administrativas:

1. Toque **5 vezes seguidas**, em até 3 segundos, no **canto superior esquerdo** da tela (não tem nenhum ícone ali, é uma área invisível de propósito).

2. Um menu abre na parte de baixo da tela, com as opções:

   - **Silenciar avisos / Reativar avisos** (só no Painel — liga ou desliga o som/voz de chamada).

   - **Configurações** — abre a tela de configurações (Passos 6, 7, 8 e 9).

   - **Trocar função do aparelho** — volta pra tela de escolha Totem/Painel.

   - **Sair da conta** — desloga esse aparelho.

Define como o Painel avisa que uma nova senha foi chamada.

1. Abra **Configurações** (Passo 5).

2. Em **Chamada de senha**, escolha uma das opções: apenas voz, apenas campainha, ou os dois juntos.

3. Se escolher uma opção com campainha, uma lista de sons aparece logo abaixo — toque no ícone de play ao lado de cada som para ouvir antes de escolher.

Ajusta como o número da senha aparece no Totem (na hora da emissão) e no Painel (na chamada).

1. Em **Tamanho**, escolha entre Pequeno, Médio, Grande ou **Extra grande** — a opção Extra grande preenche a maior parte da tela, recomendada quando o aparelho fica alto ou longe de quem precisa ler.

2. Em **Cor**, toque numa das bolinhas de cor disponíveis para escolher a cor do número da senha.

Adiciona informações da empresa no cupom impresso.

1. Em **Nome da empresa**, digite o nome que deve aparecer no topo do cupom (ex.: "Açougue do Zé").

2. Em **Mensagem de boas-vindas**, digite uma mensagem curta (ex.: "Sejam bem-vindos!").

Esses dois campos aparecem impressos antes do número da senha, junto com o rodapé "Desenvolvido por R&Cia Sistemas".

O GSMPass imprime em impressoras térmicas **de rede** (protocolo ESC/POS via IP), não em impressoras compartilhadas do Windows.

1. Em **IP da impressora**, informe o IP dela na rede (ex.: `192.168.1.50`).

2. Em **Porta**, mantenha `9100` — é o padrão da maioria das térmicas, só mude se o fabricante indicar outra.

3. Ative **"Imprimir automaticamente ao emitir senha"** se quiser que toda senha tirada no Totem já saia impressa sozinha.

4. Toque em **Testar impressora**, no rodapé da tela, para conferir se a conexão está funcionando antes de liberar o Totem para uso.

> Se a impressora só aparece como compartilhamento ligado a um computador Windows (sem IP próprio), não é possível imprimir nela direto pelo Android — é necessária uma impressora de rede de verdade (com placa Wi-Fi/Ethernet e IP próprio).

No dia a dia, o cliente interage sozinho com o Totem:

1. O cliente toca em **Normal** ou **Preferencial**, de acordo com o seu caso.

2. A senha é gerada e exibida em tela cheia por alguns segundos (com cor diferente para Preferencial), além de ser impressa automaticamente, se configurado.

3. Enquanto a senha está sendo exibida, tocar na tela não faz nada — ela some sozinha depois do tempo configurado, evitando que o cliente feche a exibição sem ver o número.

O Painel foi pensado para ficar montado na parede, fora do alcance físico de qualquer pessoa, e ser controlado por um **mouse Bluetooth** à distância:

- **Clique esquerdo** em qualquer lugar da tela: chama a próxima senha. A chamada intercala entre Preferencial e Normal (uma de cada vez); se não tiver ninguém esperando no tipo da vez, chama o outro tipo automaticamente.

- **Clique direito**: rechama a senha atual (útil quando o cliente não percebeu a chamada).

A tela mostra o tipo (Normal/Preferencial) e o número da senha atual, que pulsa continuamente para chamar atenção, além da quantidade de pessoas aguardando em cada fila. O cursor do mouse fica escondido, para não poluir a exibição.

Caso precise reaproveitar um aparelho para outra função (por exemplo, transformar um Painel em Totem), ou trocar a conta logada:

1. Abra o menu administrativo (Passo 5).

2. Toque em **Trocar função do aparelho** para voltar à tela de escolha Totem/Painel, sem perder o login.

3. Toque em **Sair da conta** para deslogar completamente — na próxima abertura, o app pede login e escolha de função novamente.