HandyCafe Docs
owner

Logs

A pagina de Logs fornece um rastro de auditoria abrangente de todos os eventos do sistema no HandyCafe. Cada acao significativa -- desde inicio de sessoes ate logins de operadores -- e registrada aqui para responsabilidade, solucao de problemas e conformidade.

Desempenho

O visualizador de logs usa renderizacao de lista virtual para manter desempenho suave mesmo exibindo milhares de entradas. Isso significa que apenas as linhas visiveis sao renderizadas no DOM a qualquer momento, permitindo que o sistema gerencie mais de 1.000 registros de log sem degradacao da interface.

Campos da Entrada de Log

Cada entrada de log contem os seguintes campos:

Campo Descricao
Data/Hora Data e hora em que o evento ocorreu
Origem O componente do sistema que gerou o evento
Categoria Classificacao do evento (veja categorias abaixo)
Acao Tipo especifico de acao (veja acoes comuns abaixo)
PC O PC cliente ou console envolvido, se aplicavel
IP Endereco IP associado ao evento
Membro O membro envolvido, se aplicavel
Operador O operador que acionou ou estava de plantao durante o evento
Mensagem Descricao legivel do que aconteceu

Categorias de Log

Os eventos sao classificados em 8 categorias:

  1. Servidor -- Inicializacao, encerramento, alteracoes de configuracao e eventos do sistema.
  2. Cliente -- Conexoes, desconexoes e mudancas de estado de clientes.
  3. Operador -- Login, logout e acoes administrativas do operador.
  4. Membro -- Registro, atualizacoes de perfil e alteracoes de conta de membros.
  5. Sessao -- Eventos do ciclo de vida da sessao (inicio, encerramento, pausa, retomada).
  6. Console -- Eventos relacionados a consoles (adicoes, remocoes, atribuicoes de sessao).
  7. Pedido -- Criacao, modificacao e fechamento de pedidos.
  8. Pagamento -- Processamento de pagamentos, reembolsos e transacoes financeiras.

Acoes Comuns Registradas

As seguintes acoes aparecem frequentemente no log:

  • startSession -- Uma nova sessao foi iniciada em um cliente ou console.
  • stopSession -- Uma sessao ativa foi encerrada.
  • pauseSession -- Uma sessao em execucao foi pausada.
  • resumeSession -- Uma sessao pausada foi retomada.
  • consoleAdded -- Um novo console de jogos foi registrado no sistema.
  • newMemberAdded -- Uma nova conta de membro foi criada.
  • orderCreated -- Um novo pedido de produto foi realizado.
  • orderClosed -- Um pedido foi concluido e fechado.
  • cashierLogin -- Um operador fez login no sistema.
  • cashierLogout -- Um operador fez logout.
  • serverStarted -- O aplicativo HandyCafe Server foi iniciado.
  • clientConnected -- Um PC cliente estabeleceu conexao com o servidor.
  • clientDisconnected -- Um PC cliente desconectou do servidor.

Filtragem e Busca

Filtro por Categoria

Selecione uma ou mais categorias para restringir a exibicao de logs. Por exemplo, mostre apenas eventos de Sessao e Pagamento para auditar atividade financeira.

Filtro por Acao

Filtre por tipos de acao especificos para encontrar eventos particulares rapidamente.

Filtro por Periodo

Restrinja a visualizacao de logs a um periodo especifico. Combinado com outros filtros, facilita a investigacao de incidentes ocorridos durante uma janela de tempo conhecida.

Opcoes de Ordenacao

Ordene entradas de log por qualquer campo em ordem crescente ou decrescente. Ordenar por data/hora (mais recente primeiro) e o padrao.

Busca por Texto

Uma caixa de busca de texto livre que compara com todos os campos, permitindo buscar por um hostname especifico, endereco IP, nome de membro ou qualquer palavra-chave nas mensagens de log.

Permissoes

O acesso a pagina de Logs e controlado pelas seguintes permissoes:

Permissao Descricao
LOG_VIEW Necessaria para acessar a pagina de Logs
LOG_DISPLAY_FULL Permite visualizar o historico completo de logs
LOG_DISPLAY_TODAY Restringe a visualizacao apenas as entradas de hoje
LOG_DELETE Permite excluir entradas de log

Um operador com LOG_VIEW e LOG_DISPLAY_TODAY pode revisar os eventos de hoje, mas nao pode acessar dados historicos. Apenas usuarios com LOG_DISPLAY_FULL podem navegar pelo arquivo completo de logs.

Atualizacoes em Tempo Real

Novos eventos de log aparecem automaticamente no visualizador conforme ocorrem. O sistema escuta eventos de log via conexao TCP para que nao seja necessario atualizar a pagina manualmente. Um cache de logs melhora o desempenho reduzindo consultas repetidas ao banco de dados ao rolar por entradas recentes.