Auditoria Global
A Auditoria registra tudo o que é feito no sistema: cada criação, alteração, exclusão ou restauração de registro, com quem fez, quando, de qual IP e o que mudou (valores anteriores × novos). É a trilha imutável para responder "o que aconteceu com esse registro?" e "quem fez essa alteração?".
Os guias desta seção:
- Eventos de Localização — o histórico de cada ação dos técnicos com a posição capturada no momento (Super Administrador e Prestadora).
Esta página cobre a Auditoria Global: o que ela registra, como ler os eventos e os filtros disponíveis (Super Administrador).
Para quem é
A Auditoria Global é exclusiva do Super Administrador. A Prestadora tem acesso apenas aos Eventos de Localização (e somente dos próprios técnicos). O técnico não acessa esta seção.
Resumo rápido
- O que fica registrado? Criação, atualização, exclusão e restauração de registros em 33 áreas do sistema (usuários, ordens de serviço, clientes, estoque, prestadoras, técnicos, veículos, solicitações, configurações etc.).
- Quem registra? O sistema automaticamente — não existe botão "registrar". Toda ação de um usuário na plataforma vira um evento de auditoria.
- O que NÃO aparece? Senhas e chaves de integração são mascaradas (nunca gravadas), e o conteúdo de arquivos (fotos/assinaturas) é omitido do histórico.
O que a auditoria registra
Cada evento de auditoria guarda:
| Campo | O que significa |
|---|---|
| Quando | Data e horário exatos da ação |
| Quem | O usuário que executou a ação (ou "sistema" em ações automáticas) |
| Ação | Criou, Atualizou, Excluiu ou Restaurou |
| Módulo | A área do sistema (Usuários, Ordens de Serviço, Estoque, Prestadores, Configurações etc.) |
| Registro | A entidade e o identificador (ex.: Ordem de Serviço OS-20260812-0001) |
| O que mudou | A lista de campos alterados com antes × depois |
| De onde | IP e navegador usados na ação |
Trilha imutável
Os registros de auditoria não podem ser editados nem apagados — nem pelo Super Administrador. Se um dia for preciso limpar o histórico, isso é feito por uma remoção em lote por política, nunca editando um evento.
Como ler a tela
Auditoria Global: indicadores no topo, filtros e a lista de eventos.
Indicadores (cards no topo)
A tela abre com um resumo da atividade:
- Eventos (7 dias) — total de ações registradas na última semana;
- Criados / Atualizados / Excluídos / Restaurados — o total de cada tipo de ação no período, para ver o ritmo da operação.
A lista de eventos
Cada linha é um evento com:
- Data/hora da ação;
- Usuário que executou (nome/email);
- Ação com badge colorido (Criou / Atualizou / Excluiu / Restaurou);
- Módulo e registro (entidade + resumo, ex.: Atualizou (Cliente) Maria Souza);
- Campos alterados — expansível para ver o antes × depois de cada campo (os valores sensíveis aparecem como
***).
Detalhe expansível de um evento: a lista de campos com valores anteriores e novos.
Filtros
| Filtro | O que faz |
|---|---|
| Busca | Procura pelo texto do registro (ex.: protocolo da OS, nome do cliente) |
| Ação | Filtra por Criou / Atualizou / Excluiu / Restaurou |
| Módulo | Filtra por área (Usuários, Ordens de Serviço, Estoque, Configurações…) |
| Usuário | Filtra por quem executou |
| Período | Limita pela data da ação (hoje, 7 dias, personalizado) |
Os filtros ficam persistidos ao sair e voltar à tela — só são limpos ao clicar em "Limpar filtros".
Lista rápida mesmo com muitos eventos
A lista carrega uma página de cada vez (como todas as listagens do LuariX OS) — a tela continua leve mesmo com milhares de eventos acumulados.
Como os eventos são gerados
A auditoria é automática e invisível: o sistema registra cada alteração nas entidades monitoradas assim que ela acontece (na mesma operação, sem interferir nela). Isso inclui as ações feitas pela interface web, pelo bot do Telegram e pelos Mini Apps.
- 33 áreas monitoradas — usuários, ordens de serviço (e histórico/anexos), clientes, produtos, estoque, prestadoras, técnicos, SLAs, cidades/bairros, veículos, solicitações, relatórios, notificações, dispositivos, configurações e integrações.
- Ações registradas: criar, atualizar, excluir e restaurar.
- O que é mascarado: senhas e chaves de integração (Telegram, notificações, e-mail, busca de endereço) →
***; conteúdo de arquivos (fotos/assinaturas) é omitido do histórico. - Sem ruído: atualizações sem mudança real e preenchimentos automáticos do sistema não geram eventos.
- Ações automáticas do sistema aparecem com usuário vazio (registro feito pelo próprio sistema), enquanto ações de técnico pelo Telegram mostram o vínculo correspondente.
Exemplos de uso
- "Quem editou o cadastro desse cliente?" → filtro por módulo Clientes + busca pelo nome.
- "O que mudou na OS-20260812-0001?" → busca pelo protocolo e abra o evento para ver o antes × depois.
- "Está tendo muita exclusão de produtos?" → o card de Excluídos e o filtro por ação Excluiu.