Auditoria

Rascunho — ainda não verificado em hml

Escrito a partir do código, sem percorrer as telas em hml. Nomes de campo e ordem de passos podem divergir do que a interface mostra. Ao validar, corrija o que estiver diferente e remova este aviso.

Objetivo

Responder “quem alterou isso, e quando” sem depender da memória de ninguém.

Antes de começar

A auditoria fica em /<slug>/admin/audit e exige perfil de Administrador.

Ela registra ações feitas no sistema — criação, alteração e exclusão de registros, com o usuário, a data e hora, e o IP de origem. Não é um histórico de navegação: abrir uma tela para consultar não gera registro.

Cada linha traz:

Coluna	O que é
Data/Hora	quando a ação aconteceu
Usuário	quem fez
Ação	o tipo de operação
Entidade	sobre o que foi feito (cliente, usuário, processo, …)
ID	qual registro daquele tipo
Detalhes	o que mudou
IP	de onde partiu

Passos

Encontrar uma ação

1. Vá em /<slug>/admin/audit.
2. Ajuste Data Início e Data Fim. Comece estreito: um ou dois dias em volta do que você procura. A lista fica difícil de ler em períodos largos.
3. Refine com os filtros Usuário, Ação e Entidade — todos começam em Todos.
4. Leia a coluna Detalhes da linha encontrada: é onde está o que mudou.

Investigar “quem mexeu nisto?”

Filtre por Entidade no tipo do registro e procure o ID dele. Assim você vê a vida inteira daquele registro, em ordem, em vez de vasculhar por usuário.

Exportar

A tela permite exportar o resultado filtrado. Filtre antes de exportar — o relatório sai com o que está na tela.

Trate o arquivo como dado sensível: ele contém nome de usuário, IP e detalhe de operação sobre clientes.

Como saber que deu certo

Execute uma ação qualquer agora — edite um usuário, por exemplo — e localize-a na auditoria filtrando pelo dia de hoje e pelo seu próprio usuário. Se ela aparece, você sabe ler a tela.

Se der errado

A ação que procuro não aparece. Confira o intervalo de datas antes de tudo: o filtro padrão pode não alcançar a data que você quer. Vale lembrar também que consulta não gera registro — só alteração.

Vejo o registro mas não entendo o que mudou. A coluna Detalhes guarda o conteúdo da operação. Se ela não bastar, anote Data/Hora, Entidade e ID e leve isso ao suporte — com esses três campos o registro é localizável direto.