Logs

A página de Logs fornece um rastro de auditoria abrangente de todos os eventos do sistema no HandyCafe. Cada ação significativa -- desde início de sessões até logins de operadores -- é registrada aqui para responsabilidade, solução de problemas e conformidade.

Desempenho

O visualizador de logs usa renderização de lista virtual para manter desempenho suave mesmo exibindo milhares de entradas. Isso significa que apenas as linhas visíveis são renderizadas no DOM a qualquer momento, permitindo que o sistema gerencie mais de 1.000 registros de log sem degradação da interface.

Campos da Entrada de Log

Cada entrada de log contém os seguintes campos:

Campo	Descrição
Data/Hora	Data e hora em que o evento ocorreu
Origem	O componente do sistema que gerou o evento
Categoria	Classificação do evento (veja categorias abaixo)
Ação	Tipo específico de ação (veja ações comuns abaixo)
PC	O PC cliente ou console envolvido, se aplicável
IP	Endereço IP associado ao evento
Membro	O membro envolvido, se aplicável
Operador	O operador que acionou ou estava de plantão durante o evento
Mensagem	Descrição legível do que aconteceu

Categorias de Log

Os eventos são classificados em 8 categorias:

Servidor -- Inicialização, encerramento, alterações de configuração e eventos do sistema.
Cliente -- Conexões, desconexões e mudanças de estado de clientes.
Operador -- Login, logout e ações administrativas do operador.
Membro -- Registro, atualizações de perfil e alterações de conta de membros.
Sessão -- Eventos do ciclo de vida da sessão (início, encerramento, pausa, retomada).
Console -- Eventos relacionados a consoles (adições, remoções, atribuições de sessão).
Pedido -- Criação, modificação e fechamento de pedidos.
Pagamento -- Processamento de pagamentos, reembolsos e transações financeiras.

Ações Comuns Registradas

As seguintes ações aparecem frequentemente no log:

startSession -- Uma nova sessão foi iniciada em um cliente ou console.
stopSession -- Uma sessão ativa foi encerrada.
pauseSession -- Uma sessão em execução foi pausada.
resumeSession -- Uma sessão 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 concluído 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 conexão com o servidor.
clientDisconnected -- Um PC cliente desconectou do servidor.

Filtragem e Busca

Filtro por Categoria

Selecione uma ou mais categorias para restringir a exibição de logs. Por exemplo, mostre apenas eventos de Sessão e Pagamento para auditar atividade financeira.

Filtro por Ação

Filtre por tipos de ação específicos para encontrar eventos particulares rapidamente.

Filtro por Período

Restrinja a visualização de logs a um período específico. Combinado com outros filtros, facilita a investigação de incidentes ocorridos durante uma janela de tempo conhecida.

Opções de Ordenação

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

Busca por Texto

Uma caixa de busca de texto livre que compara com todos os campos, permitindo buscar por um hostname específico, endereço IP, nome de membro ou qualquer palavra-chave nas mensagens de log.

Permissões

O acesso à página de Logs é controlado pelas seguintes permissões:

Permissão	Descrição
`LOG_VIEW`	Necessária para acessar a página de Logs
`LOG_DISPLAY_FULL`	Permite visualizar o histórico completo de logs
`LOG_DISPLAY_TODAY`	Restringe a visualização apenas às 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 não pode acessar dados históricos. Apenas usuários com LOG_DISPLAY_FULL podem navegar pelo arquivo completo de logs.

Atualizações em Tempo Real

Novos eventos de log aparecem automaticamente no visualizador conforme ocorrem. O sistema escuta eventos de log via conexão TCP para que não seja necessário atualizar a página manualmente. Um cache de logs melhora o desempenho reduzindo consultas repetidas ao banco de dados ao rolar por entradas recentes.