Ir para o conteúdo principal

Manual de Instalação — Sistema de Senhas

Guia completo para instalar o sistema de senhas em um servidor do cliente pela primeira vez.

O sistema é composto por:

  • Backend: pasta mvp-senhas (servidor Node.js com a API e o banco em arquivo JSON).
  • Frontend: pasta mvp-senhas-ui (interface moderna em React, que precisa ser "compilada" antes de ir pro servidor).

Quando o sistema é instalado, o frontend já vem embutido dentro da pasta mvp-senhas/public. O servidor entrega tudo na mesma porta.

Parte A — Preparar o pacote (na sua máquina)

Você só faz isso uma vez, antes de levar o sistema pro servidor do cliente.

A1. Pré-requisitos

Na sua máquina precisa estar instalado:

  • Node.js LTS (versão 20 ou superior): https://nodejs.org/

Confirme no prompt:

node -v
npm -v

A2. Instalar dependências do frontend

Abrir o prompt na pasta mvp-senhas-ui:

cd "Sistema de Senha Novo\mvp-senhas-ui"
npm install

Esse passo só precisa rodar uma vez (ou quando atualizar dependências).

A3. Gerar o build da interface

Ainda na pasta mvp-senhas-ui:

npm run build

Isso cria uma pasta dist/ com o frontend pronto pra produção (HTML, CSS e JS otimizados).

A4. Substituir o public do backend

  1. Apagar todo o conteúdo de Sistema de Senha Legado\mvp-senhas\public\.
  2. Copiar todo o conteúdo da pasta mvp-senhas-ui\dist\ pra dentro de mvp-senhas\public\.

Resultado: dentro de mvp-senhas\public\ deve ter index.html, uma pasta assets/ e demais arquivos do build.

A5. Compactar o pacote

Compactar a pasta mvp-senhas inteira em um .zip. Esse zip é o que vai pro servidor.

Parte B — Instalar no servidor do cliente

B1. Escolher o servidor

Use um computador que fique sempre ligado:

  • servidor Windows da empresa;
  • computador dedicado na recepção;
  • mini PC ligado na rede;
  • servidor virtual interno.

Evite notebook pessoal — se desligar, todos perdem acesso.

B2. Instalar Node.js no servidor

Baixar e instalar Node.js LTS (versão 20 ou superior):

https://nodejs.org/

Confirmar no Prompt de Comando do servidor:

node -v

B3. Copiar a pasta do sistema

Extrair o zip preparado na Parte A para um caminho fixo, por exemplo:

C:\Sistemas\mvp-senhas

B4. Criar o arquivo .env

Dentro de C:\Sistemas\mvp-senhas, criar um arquivo chamado .env (sem extensão .txt) com o conteúdo:

PORT=3030
APP_NAME=Atendimento
SESSION_SECRET=troque-por-um-texto-grande-e-aleatorio
COOKIE_SECURE=false
DATA_FILE=data/state.json
TRUST_PROXY=false

Atenção:

  • Troque o SESSION_SECRET por um texto longo e aleatório (qualquer combinação de letras e números, ex: kJ8m2nP9xR4tQ7vW1yU6).
  • COOKIE_SECURE=false é o correto pra rede interna sem HTTPS. Não mude para true a menos que esteja servindo via HTTPS.

B5. Primeiro teste

No Prompt de Comando, dentro da pasta:

cd C:\Sistemas\mvp-senhas
node server.js

Se aparecer mensagem indicando que o servidor está rodando na porta 3030, está correto.

Abrir no navegador do próprio servidor:

http://localhost:3030

Deve aparecer a tela de login.

B6. Primeiro acesso

Logar com o usuário administrador de suporte:

  • Usuário: admin
  • Senha: Adm1nC&bi14863

⚠️ NÃO trocar a senha do admin.

Esse usuário e senha são padrão de suporte da CEBI — é o que garante que a equipe de suporte consiga acessar o sistema em produção a qualquer momento (pra resolver problema, aplicar correção, ajudar o cliente).

Em vez de trocar a senha do admin, o procedimento correto é:

  1. Entrar uma vez com o admin (só pra criar usuários iniciais).
  2. Criar os administradores do cliente em Administração → Funcionários → Adicionar (ver passo B11).
  3. Daí em diante, o pessoal do cliente trabalha com os usuários próprios deles. O admin fica reservado pra suporte.

Se por qualquer motivo a senha do admin for trocada na produção, comunique a equipe de suporte imediatamente — caso contrário, perde-se o acesso de suporte naquele cliente.

B7. Liberar firewall

No Windows Firewall do servidor, liberar entrada TCP na porta 3030:

  1. Abrir "Windows Defender Firewall com Segurança Avançada".
  2. Regras de Entrada → Nova Regra → Porta → TCP → 3030 → Permitir conexão.
  3. Aplicar a todos os perfis (Domínio, Particular, Público — ou conforme política do cliente).
  4. Nomear a regra (ex: "Sistema de Senhas").

Sem isso, o sistema funciona no próprio servidor mas não abre nos outros computadores da rede.

B8. Acessar de outras máquinas

Em outros computadores da rede:

http://IP_DO_SERVIDOR:3030

Exemplos:

http://192.168.0.50:3030
http://SERVIDOR-SENHAS:3030

Pra descobrir o IP do servidor, no próprio servidor:

ipconfig

E procurar "IPv4" na seção da placa de rede ativa.

B9. Rodar automaticamente ao ligar o servidor

Em produção, o sistema precisa subir sozinho quando o servidor reinicia.

Opção simples — Agendador de Tarefas do Windows

  1. Abrir "Agendador de Tarefas".
  2. Criar tarefa (não criar tarefa básica).
  3. Geral: marcar "Executar com privilégios mais altos".
  4. Disparadores: novo → "Ao iniciar o computador".
  5. Ações: nova → Programa: node — Argumentos: server.js — Iniciar em: C:\Sistemas\mvp-senhas.
  6. Configurações: desmarcar "Parar a tarefa se executar por mais de...".
  7. Salvar e testar reiniciando o servidor.

Opção mais robusta — NSSM (recomendada)

Permite rodar como serviço Windows de verdade, com restart automático em caso de queda.

  1. Baixar NSSM: https://nssm.cc/
  2. Abrir prompt como admin e executar nssm install SistemaSenhas.
  3. Application Path: C:\Program Files\nodejs\node.exe
  4. Startup directory: C:\Sistemas\mvp-senhas
  5. Arguments: server.js
  6. Salvar e iniciar: nssm start SistemaSenhas.

B10. Backup obrigatório

O sistema guarda os dados do cliente em dois lugares distintos:

O que Contém
C:\Sistemas\mvp-senhas\data\state.json Usuários, guichês, salas, configurações, prioridades, motivos, senhas emitidas, histórico, auditoria
C:\Sistemas\mvp-senhas\public\logo.png Logo do cliente (enviado pelo Admin)
C:\Sistemas\mvp-senhas\.env Configuração local (porta, segredo de sessão)

Configurar backup diário automático dos três itens acima. Sugestões:

  • Robocopy + Task Scheduler agendado pra rodar diariamente;
  • Cópia pra outro disco / drive de rede;
  • Backup corporativo (Veeam, etc) incluindo essas pastas/arquivos.

Manter pelo menos 7 cópias (uma por dia da última semana). Recomendado também 1 cópia mensal pra arquivamento.

Exemplo de comando de backup (Robocopy)

robocopy C:\Sistemas\mvp-senhas\data C:\Backup-Senhas\%DATE:~6,4%-%DATE:~3,2%-%DATE:~0,2%\data /E
copy C:\Sistemas\mvp-senhas\public\logo.png C:\Backup-Senhas\%DATE:~6,4%-%DATE:~3,2%-%DATE:~0,2%\logo.png
copy C:\Sistemas\mvp-senhas\.env C:\Backup-Senhas\%DATE:~6,4%-%DATE:~3,2%-%DATE:~0,2%\.env

Cria uma pasta com data do dia e copia os três artefatos.

B11. Configuração inicial dentro do sistema

Já logado como admin, configurar:

Funcionários

Administração → Funcionários:

  • Não mexer no usuário admin — ele é reservado pra suporte da CEBI. Não trocar senha nem desativar.
  • Cadastrar pelo menos um administrador do cliente (com login próprio, ex: nome do responsável pelo sistema na empresa). É esse usuário que o cliente vai usar pra gerenciar o sistema no dia a dia.
  • Cadastrar os atendentes (perfil atendente).
  • Cada usuário recebe login próprio e senha inicial (pelo menos 6 caracteres).
  • Vincular cada atendente a um guichê e sala padrão (opcional, mas recomendado).
  • Combinar com o cliente que o dia a dia deve ser feito com os usuários dele — o admin só é usado por suporte em casos excepcionais.

Guichês

Administração → Guichês:

  • Cadastrar os guichês físicos (ex: "Guichê 1", "Guichê 2").
  • Ativar/desativar conforme necessário.

Salas

Administração → Salas:

  • Cadastrar as salas de atendimento.
  • Vincular os atendentes que podem trabalhar em cada sala.

Configurações gerais

Administração → Configurações:

  • Nome da empresa/órgão (aparece no painel e no topo da interface).
  • Lógica de prioridade (FIFO / alternância configurável).
  • Reset automático do dia (se quiser que zere automaticamente após X horas sem movimento).
  • Outras opções (som, tempo de chamada, etc).

Logo do cliente

Administração → Configurações → Logo:

  1. Clicar em "Carregar logo" (ou área equivalente).
  2. Selecionar o arquivo de imagem do cliente (PNG recomendado, com fundo transparente).
  3. Confirmar o upload.

O logo aparece automaticamente em:

  • Topo da interface (todas as telas);
  • Tela do Painel (TV);
  • Tela do Totem/Recepção.

Importante saber pra atualizações futuras:

  • O logo do cliente é gravado diretamente como C:\Sistemas\mvp-senhas\public\logo.png no servidor.
  • Quando você for atualizar o sistema (substituir a pasta public\), o logo do cliente precisa ser preservado — caso contrário ele será sobrescrito pelo logo padrão que vem no pacote. Ver o Manual de Atualização pra o procedimento correto.
  • Backup recomendado: incluir public\logo.png na rotina de backup junto com o data\state.json.

B12. Telas do sistema

Cada terminal abre a tela conforme a função:

Tela URL/Caminho Uso
Recepção http://IP:3030 → Recepção Emitir senhas (totem ou recepcionista)
Atendimento http://IP:3030 → Atendimento Atendente chama/finaliza senhas
Painel (TV) http://IP:3030 → Painel TV grande mostrando senhas chamadas (com som)
Histórico http://IP:3030 → Histórico Consulta histórico do dia
Administração http://IP:3030 → Administração Só pra usuários admin

Painel na TV

  1. Abrir o navegador na TV.
  2. Acessar http://IP_DO_SERVIDOR:3030.
  3. Fazer login (pode criar um usuário específico tipo "painel" com permissão apenas de visualização).
  4. Entrar em Painel.
  5. Clicar uma vez na tela pra ativar o som (browsers bloqueiam áudio sem interação do usuário).
  6. Pressionar F11 pra tela cheia.

B13. Validação final

Antes de entregar pro cliente, testar:

  • Emitir uma senha comum na Recepção.
  • Chamar a senha em Atendimento de outro computador.
  • Ver a senha sendo anunciada no Painel (com som).
  • Finalizar a senha.
  • Conferir o registro em Histórico.
  • Reiniciar o servidor e confirmar que o sistema sobe sozinho.
  • Confirmar backup do data\state.json.

Resumo dos caminhos importantes

Arquivo/pasta Para que serve
C:\Sistemas\mvp-senhas\server.js Inicia o servidor
C:\Sistemas\mvp-senhas\.env Configuração de porta, sessão, etc
C:\Sistemas\mvp-senhas\data\state.json Banco de dados (fazer backup diário)
C:\Sistemas\mvp-senhas\public\ Interface (HTML/JS/CSS gerados do React)
C:\Sistemas\mvp-senhas\src\ Código do backend Node.js

Problemas comuns

"Funciona no servidor mas não abre nos outros computadores"

  • Firewall não liberado (passo B7).
  • IP do servidor mudou (servidor sem IP fixo). Considere reservar IP no DHCP.

"Login não funciona depois de algumas horas"

  • O sistema mantém sessão por 8 horas absolutas. Após esse tempo o usuário precisa fazer login de novo.
  • Se o servidor reinicia, todas as sessões caem (comportamento esperado).

"O servidor não sobe ao reiniciar"

  • Verificar se a tarefa do Agendador / serviço NSSM está configurada (passo B9).
  • Conferir se o node.exe está no PATH ou se o caminho completo foi usado na configuração do serviço.

"Som do painel não funciona"

  • Clicar uma vez na tela depois de abrir o Painel — é uma restrição dos navegadores.
  • Conferir o volume do sistema operacional.

Limitações desta versão

Esta versão é adequada para um cliente/unidade em rede interna.

Não é ideal para:

  • vários clientes diferentes no mesmo portal (multi-tenancy);
  • exposição pública na internet sem HTTPS/proxy reverso;
  • alto volume (centenas de atendentes simultâneos);
  • integração com banco corporativo (Oracle/SQL Server);
  • controle avançado de infraestrutura.

Para esses casos, planejar evolução pra arquitetura corporativa.

Nenhum comentário
Voltar ao topo