Auditoria: quem alterou o quê

Toda ação administrativa fica registrada — veja quem excluiu uma unidade, alterou um cadastro ou mudou uma permissão, com o antes e o depois.

O que é

A área Auditoria registra todas as ações administrativas feitas no painel: quem excluiu uma unidade, alterou o e-mail de um usuário, mudou uma permissão, editou um fornecedor ou reconfigurou a cobrança — com data, hora, autor e, para as mudanças mais sensíveis, o valor antes e depois de cada campo.

É a resposta para a pergunta "quem mexeu nisso?" — importante tanto para a operação do dia a dia quanto como registro em caso de disputa.

Quem tem acesso

O mesmo corte de Minha Equipe: administradores da conta (TENANT_ADMIN). Registros de folha de pagamento (funcionários CLT, que carregam salário) só aparecem para quem também tem acesso ao módulo de folha — para os demais, esses registros nem são retornados.

Como usar

Abra Auditoria no menu lateral.
Filtre por período, ação (ex.: unit.delete) ou tipo de entidade.
Clique no ícone de olho para ver o detalhe: o diff campo a campo mostra em vermelho o valor antigo e em verde o novo.
Exportar CSV baixa o recorte filtrado — útil para anexar a um processo ou repassar ao jurídico.

O que é registrado

Toda mutação (criar, editar, excluir) feita por um usuário autenticado vira um registro básico: ação, autor, alvo, IP e identificador da requisição.
Entidades sensíveis (usuários, unidades, blocos, funcionários, documentos, papéis, integrações bancárias, configurações de cobrança, fornecedores, cancelamento de reservas por staff, quebra de acordos) ganham também o antes/depois dos campos alterados.

Segredos nunca entram na trilha: senhas, chaves de API e credenciais bancárias aparecem apenas como "configurado/não configurado" — o valor em si não é registrado em lugar nenhum.

Retenção e imutabilidade

Os registros são mantidos por 90 dias e removidos automaticamente depois disso (a tela mostra a janela vigente).
A trilha é imutável: nenhum usuário — nem o administrador — consegue editar ou apagar um registro. A única remoção é a limpeza automática por idade.

Perguntas frequentes

Por que uma ação aparece sem antes/depois? Ações fora da lista de entidades sensíveis geram o registro básico (quem, o quê, quando), sem o corpo da mudança — suficiente para rastrear a autoria.

O acesso de leitura também é registrado? Não — a trilha cobre alterações (criar/editar/excluir), não visualizações.