Usuários - Auditoria e Logs de Atividade
O que é
A página de Auditoria é o registro centralizado de tudo que acontece no empresa: criação, alteração, exclusão e restauração de registros, além de eventos como login, logout, login falho, check-in, check-out e cancelamentos. Cada linha guarda quem fez, quando, em qual entidade, o IP de origem e - quando aplicável - o valor anterior e o valor novo de cada campo alterado.
O Proprietário ou Gerente normalmente chega aqui para investigar uma alteração suspeita (um valor que mudou sem aviso, um cadastro excluído), para auditar acessos em uma janela específica ou para gerar uma planilha em CSV exigida por um auditor externo. Por se tratar de dado sensível, a visualização é restrita à permissão de ver a auditoria.
Como usar
- Vá em Relatórios > Auditoria no menu lateral.
- Observe os três cartões no topo: Total de registros, Registros hoje e Tipos de entidade - dão uma noção do volume.
- Use a barra de filtros logo abaixo para encontrar o registro que precisa:
- Busca - texto livre sobre nome do usuário, tipo da entidade ou nome da ação.
- Tipo - entidade auditada (ex.: Cliente, Excursão, Pagamento, User, Role).
- Ação - Criado, Atualizado, Excluído ou Restaurado.
- Usuário - origem da ação: Admin, Cliente, Guia ou Sistema.
- Data início / Data fim - recorta por período.
- Os filtros aplicam automaticamente conforme você escolhe; o ícone "X" da barra limpa todos de uma vez.
- Para abrir o detalhamento de uma linha, clique em Ver detalhes
(botão azul à direita do item). O modal mostra:
- Data/hora completa e relativa ("há 3 horas");
- Tipo, ação colorida, usuário e tipo de usuário;
- Entidade e ID afetados, IP de origem;
- Tabela Alterações com colunas Campo / Antes / Depois quando há
diff calculado (campos que realmente mudaram entre
old_valuesenew_values); - Blocos Valores Anteriores e Valores Novos em JSON quando o diff não pode ser calculado;
- Metadados adicionais, URL da requisição e Dispositivo (User-Agent) quando disponíveis.
- Para extrair tudo que está visível com os filtros atuais, clique no botão verde de download (último ícone da barra de filtros) - gera um CSV com BOM UTF-8 (abre direto no Excel) com até 10.000 linhas.
Casos especiais
Ação "Sistema" sem usuário identificado
Quando o registro foi gerado por um cron, job ou observer (sem usuário
logado), o campo Usuário aparece como Sistema e o filtro Usuário >
Sistema isola só esse tipo. É o esperado em ações automáticas, como
sincronização noturna ou cancelamento automático por vencimento.
Login falho
A ação login_failed aparece em vermelho na lista. Use o filtro Ação
(seleciona Criado/Atualizado/Excluído/Restaurado) combinado com a busca
livre por login_failed para investigar tentativas suspeitas. O campo IP
do detalhamento ajuda a identificar a origem.
Registro sem diff (apenas valores brutos)
Em ações antigas ou em criações/exclusões, pode não existir diff calculado entre antes/depois. Nesse caso o modal exibe blocos Valores Anteriores e Valores Novos em JSON puro, para inspeção manual.
Exportação acima de 10.000 linhas
A exportação CSV é limitada a 10.000 registros por arquivo. Para janelas maiores, restrinja o período (Data início / Data fim) e gere o relatório em lotes - cada chamada respeita os filtros ativos no momento do clique.
Filtros vindos por URL
Links externos (incluindo da Vivi) podem pré-aplicar filtros via query
string, ex.: /admin/auditoria?tipo=Cliente&acao=updated. A barra exibe
os filtros já preenchidos e o "limpar" volta para a listagem completa.
Erros comuns e como resolver
- "Esta página requer permissão (403)" - Causa: o usuário não tem permissão de ver a auditoria. Solução: peça ao Proprietário para conceder a permissão em Configurações > Papéis e Permissões.
- "Nenhum registro encontrado" (estado vazio da lista) - Causa: combinação de filtros muito restritiva, especialmente período sem movimentação. Solução: limpe os filtros pelo botão "X" e refaça a busca ampliando a janela de datas.
- "CSV abre com caracteres estranhos" - Causa: o Excel ignorou o BOM
UTF-8 (raro). Solução: importe pelo Excel via Dados > De Texto/CSV
escolhendo "Unicode (UTF-8)" como codificação; o separador é
;.
Onde encontrar
- URL:
/admin/auditoria - Caminho no menu: Relatórios > Auditoria
- Permissão necessária: ver a auditoria
- Módulo necessário: nenhum
Veja também
Gestão de Usuários do SistemaGerenciar Papéis e PermissõesEditar e Desativar UsuáriosCadastrar Novo Usuário