Documentação e Tutoriais

Guia completo para operadores, gestores e administradores

📱 Módulo de Coleta de Dados

Instruções básicas para uso do terminal de coleta (ESP32 com display e teclado).

✅ Como iniciar um ciclo

  • No menu principal, selecione a opção correspondente ao início do processo
  • Digite o código do produto ou material (conforme tabela disponível no local)
  • Confirme o produto exibido no display
  • Digite a quantidade em gramas (ex: 15000 = 15kg)
  • Digite o lote de produção
  • Confirme com [#] e realize o login do operador

🔐 Login do Operador

  • Digite o código de operador (ex: 50)
  • Se solicitado, digite a senha de 4 dígitos
  • Aguarde a mensagem de confirmação

⌨️ Teclas de Atalho

# Confirmar
* Cancelar / Voltar
C Apagar (Backspace)
B Menu Principal

📦 Registro de Consumo de Materiais

  • Acesse o menu de movimentação de materiais
  • Operador que autoriza: digite código e senha
  • Digite o código do material
  • Digite a quantidade em gramas
  • Operador que solicita: digite código e senha
  • Confirme a retirada

📊 Dashboard Web

Acesse o dashboard em tempo real pelo navegador:

http://[endereco-do-servidor]:5000/dashboard.html

Funcionalidades:

  • 📈 KPIs em tempo real (produtividade, eficiência)
  • 📋 Processos em andamento
  • 🎨 Estoque de materiais com alertas
  • 📦 Últimas movimentações
  • 🚨 Alertas automáticos

📈 Relatórios e Consultas

# Acessar menu de consultas python3 consultas_avancadas.py
  • Consumo por operador
  • Consumo por material
  • Evolução do consumo
  • Ranking de produtividade
  • Relatório executivo diário

⚙️ Gerenciamento do Sistema

Gerenciar Operadores

python3 gerenciar_operadores.py
  • Cadastrar novo operador (código + nome + função + senha)
  • Editar dados do operador
  • Desativar operador (mantém histórico)
  • Listar todos os operadores

Gerenciar Materiais

python3 gerenciar_materiais.py
  • Cadastrar novo material
  • Editar informações
  • Ajustar estoque manualmente
  • Listar movimentações

Backup e Manutenção

# Backup automático python3 backup_diario.py # Verificar logs tail -f logs/api.log

❓ Perguntas Frequentes

❓ Não consigo fazer login no terminal

Verifique se o código de operador está correto. Se tiver senha, digite os 4 dígitos (não aparecem na tela por segurança).

❓ O sistema não registrou minha operação

Confirme a mensagem "✅ SUCESSO" após o registro. Se houver erro, verifique a conexão de rede do terminal.

❓ Como corrigir um lançamento errado?

Entre em contato com o administrador para ajustar o saldo via gerenciador, mantendo o histórico de auditoria.

❓ O dashboard não atualiza

Verifique se o servidor Flask está rodando (python3 servidor_api.py) e se não há firewall bloqueando a porta 5000.