Registro de Auditoria¶
O Registro de Auditoria exibe todas as ações registradas no sistema, permitindo
acompanhar quem fez o quê e quando. Essa tela é exclusiva para proprietários
(permissão owner).
Acesso
O Registro de Auditoria é acessado pelo menu Administração na barra de menus, ou pelo botão 📋 na barra lateral. Tanto o item de menu quanto o botão da barra lateral ficam ocultos para usuários sem a permissão de proprietário. Ele abre como uma tela independente (desktop), fora das abas de loja.
Layout da tela¶
A tela é dividida em quatro áreas:
- Barra de ferramentas — título da tela e botão para expandir/recolher o painel de filtros.
- Painel de filtros (recolhível) — tipo de evento, tabela, texto de busca, intervalo de datas e filtro de eventos sinalizados.
- Tabela de registros — lista paginada dos eventos de auditoria.
- Painel de detalhes — exibido abaixo da tabela ao clicar em um registro; mostra informações completas do evento selecionado.
Proprietários também veem uma barra de estatísticas entre os filtros e a tabela, com um resumo dos últimos 7 dias: total de eventos, eventos sinalizados e usuários ativos.
Filtros disponíveis¶
| Filtro | Descrição |
|---|---|
| Tipo de evento | Filtra por um tipo específico (ver tabela abaixo) ou todos. |
| Tabela | Filtra por tabela do sistema (ex.: expenses, usrs, ordr). A lista é populada automaticamente com as tabelas que possuem registros de auditoria. |
| Somente sinalizados | Quando ativado, exibe apenas eventos que foram marcados automaticamente como suspeitos pelo sistema. |
| Data inicial / Data final | Intervalo de datas para a busca. O padrão são os últimos 30 dias. |
| Texto de busca | Pesquisa no campo de resumo do evento. |
Após ajustar os filtros, clique em Buscar para atualizar os resultados.
Tipos de evento¶
| Tipo | Significado |
|---|---|
| LOGIN | Usuário fez login no sistema. |
| LOGOUT | Usuário encerrou a sessão. |
| CREATE | Um novo registro foi criado (ex.: nova despesa, novo usuário). |
| UPDATE | Um registro existente foi alterado. |
| DELETE | Um registro foi removido. |
| SYNC_PUSH | Dados foram sincronizados do aplicativo local para o servidor. |
Cada tipo é exibido com uma cor diferente na tabela para facilitar a identificação.
Eventos sinalizados¶
O sistema avalia automaticamente cada evento no momento em que ele é registrado e pode sinalizá-lo como potencialmente suspeito. Os critérios de sinalização incluem:
- Alteração grande de valor — quando um campo monetário (preço, valor de despesa) muda mais de 25%.
- Operações em massa — mais de 20 operações do mesmo usuário em 5 minutos.
- Atividade fora do horário — operações realizadas entre 22h e 6h (UTC).
- Exclusão de tabela sensível — remoção de registros em tabelas críticas (pedidos, usuários, despesas).
- Edições rápidas — 5 ou mais alterações no mesmo registro em 10 minutos.
Eventos sinalizados são indicados por um ponto vermelho na coluna correspondente da tabela. Ao selecionar um evento sinalizado, o painel de detalhes exibe o motivo da sinalização.
Painel de detalhes¶
Ao clicar em uma linha da tabela, o painel de detalhes se abre na parte inferior da tela e exibe:
- Data e hora do evento
- Tipo de evento e tabela afetada
- Usuário que realizou a ação
- Resumo do evento
- Motivo da sinalização (se aplicável)
- Detalhes técnicos (valores anteriores e posteriores em caso de alteração)
Para fechar o painel, clique no botão de fechar no canto superior direito.
Paginação¶
Os resultados são exibidos em páginas de 50 registros. Utilize os botões de navegação na parte inferior da tabela para avançar ou voltar entre as páginas.
Tarefas comuns¶
Verificar quem alterou um registro¶
- No filtro Tipo de evento, selecione UPDATE.
- No filtro Tabela, selecione a tabela desejada (ex.:
expenses). - Ajuste o intervalo de datas se necessário.
- Clique em Buscar.
- Clique em um resultado para ver os detalhes da alteração no painel inferior.
Revisar eventos sinalizados¶
- Ative o filtro Somente sinalizados.
- Clique em Buscar.
- Analise cada evento sinalizado clicando na linha para ver o motivo.
Verificar logins de um período¶
- No filtro Tipo de evento, selecione LOGIN.
- Defina as datas inicial e final.
- Clique em Buscar.
Ver também¶
- Usuários — gestão de usuários e permissões