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.

Abas

A página é dividida em abas. Cada uma cobre um conjunto de registros diferente.

Aba	Conteúdo
Logs do sistema	O registro geral de eventos descrito nesta página
Transações	Movimentações de dinheiro registradas nos turnos dos operadores
Lixeira	Registros excluídos em outras páginas, mantidos para recuperação
Auditoria	Registros à prova de adulteração de alterações sensíveis
Logs de IP	Registros de acesso mantidos em arquivos diários para retenção legal. Veja Logs de IP e Registros de Acesso
Eventos de adulteração	Detecções de anticheat reportadas pelos clientes
Lista de bloqueio HWID	IDs de hardware impedidos de abrir uma sessão
Steam VAC	Verificações de banimento do Steam nas contas dos membros

As abas podem ser desligadas individualmente em Configurações, depois Visualização. Quando todas as abas estão desligadas, a entrada Logs desaparece do menu de navegação. Veja Configurações de Visualização.

A Aba de Auditoria

A aba Auditoria registra as alterações que importam para a prestação de contas: mudanças de permissão e de função, ajustes financeiros, alterações de produtos, alterações de configurações, exclusões de dados e operações de console.

Os registros de auditoria não podem ser modificados. Cada um é protegido por uma assinatura de integridade encadeada ao registro anterior. A aba mostra um resultado de verificação no topo. Se algum registro tiver sido alterado, o painel indica o primeiro registro em que a cadeia se rompe.

Os registros de auditoria podem ser filtrados por categoria ou por ação. A busca de texto livre cobre autor e alvo.

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 porém não consegue 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.