Skip to Content
Plataforma AdminTrilha de Auditoria

Trilha de Auditoria

A trilha de auditoria registra automaticamente toda acao relevante realizada no sistema. Cada criacao, edicao ou exclusao de dados gera um registro imutavel que pode ser consultado a qualquer momento para fins de compliance, investigacao e transparencia.


Por que Auditar?

A auditoria e essencial para:

  • Compliance — Atender requisitos de LGPD, GDPR e normas contabeis (IFRS, USALI)
  • Seguranca — Detectar acessos indevidos ou acoes suspeitas
  • Investigacao — Rastrear quem fez o que e quando em caso de incidentes
  • Transparencia — Dar visibilidade a gestores sobre acoes da equipe
  • Reversao — Entender o estado anterior de um registro antes de uma alteracao

O que e Registrado

Toda mutacao (criacao, atualizacao ou exclusao) em entidades de negocio gera um registro de auditoria. Alguns exemplos:

AcaoEntidadeExemplo
CREATEReserva”Usuario Maria criou a reserva #RES-2026-001847”
UPDATEHospede”Usuario Joao atualizou o telefone do hospede Carlos Silva”
DELETELancamento”Usuario Ana excluiu o lancamento contabil #LC-00412”
REVERSEMovimentacao”Usuario Pedro estornou a movimentacao de caixa #MV-00198”
READTenant (N2)“Superuser N2 acessou dados do tenant Hotel Solar”

Nota: Leituras normais (GET) nao sao registradas para evitar volume excessivo. A excecao sao acessos de suporte (N2), que registram toda leitura cross-tenant.


Campos do Registro

Cada entrada na trilha de auditoria contem:

CampoDescricaoExemplo
idIdentificador unico do registro (UUIDv7, ordenavel por tempo)019...abc
tenantIdTenant onde a acao ocorreu (nulo para acoes cross-tenant N2)tenant-uuid
tableNameNome da tabela/entidade afetadareservations
recordIdID do registro criado, editado ou excluidorecord-uuid
actionTipo da acaoCREATE, UPDATE, DELETE, REVERSE, READ
userIdID do usuario que realizou a acaouser-uuid
superuserLevelSe a acao foi de um superuser: n1 ou n2n1
originOrigem da acaoAPI, INTEGRATION, AUTOMATION, SYSTEM, SUPERUSER
oldValueEstado anterior do registro (para UPDATE e DELETE){ "status": "pending" }
newValueNovo estado do registro (para CREATE e UPDATE){ "status": "confirmed" }
ipAddressIP de origem da requisicao189.40.72.15
userAgentNavegador/cliente que realizou a acaoMozilla/5.0...
createdAtData/hora exata da acao2026-05-26T14:30:00Z

Protecao de Dados Pessoais (PII)

A trilha grava os valores que cada modulo registra (oldValue / newValue); nao ha mascaramento automatico de dados pessoais nos registros de auditoria. Os dados pessoais de hospedes sao criptografados no proprio cadastro, e toda revelacao do documento de um hospede gera um registro READ. Numeros de cartao nunca sao registrados.


Imutabilidade

Registros de auditoria sao imutaveis por design:

  • Nao podem ser editados, nem por administradores
  • Nao podem ser excluidos, nem por superusuarios N1
  • A tabela nao possui operacao UPDATE nem DELETE na API
  • IDs usam UUIDv7 (ordenados por tempo), garantindo sequenciamento

Importante: A unica remocao de registros e a rotina automatica de retencao (veja Retencao), que apaga diariamente os registros mais antigos que o periodo contratado.


Como Consultar

Via Interface

  1. Acesse Configuracoes > Log de Auditoria (requer papel Admin)
  2. Use os filtros disponiveis:
FiltroDescricao
PeriodoData inicial e final
UsuarioQuem realizou a acao
EntidadeTabela afetada (reservas, hospedes, financeiro, etc.)
AcaoCREATE, UPDATE, DELETE, REVERSE
  1. Clique em uma linha para expandir os detalhes (valores anteriores e novos)

Via API

A API aceita tambem os filtros recordId e userId:

GET /api/tenants/:tenantId/audit/logs?tableName=reservations&action=UPDATE&startDate=2026-05-01&endDate=2026-05-31 Authorization: Bearer <token>

Origens das Acoes

OrigemDescricao
APIAcao realizada via interface web (dashboard)
INTEGRATIONAcao originada por integracao via chave de API
AUTOMATIONAcao automatica do sistema (ex: no-show automatico, depreciacao programada)
SYSTEMOperacao interna do sistema (ex: seed de dados, migracoes)
SUPERUSERAcao de um superuser N1 ou N2

Casos de Uso Comuns

Quem cancelou uma reserva?

Filtre por tableName = reservations, action = UPDATE, e procure por registros onde newValue.status = "cancelled". O campo userId mostra quem fez a acao e createdAt mostra quando.

Quando um usuario foi alterado?

Filtre por tableName = users e recordId = &lt;id-do-usuario&gt;. A trilha mostra todas as alteracoes, incluindo mudanca de papel (role).

O suporte Opero acessou meus dados?

Filtre por origin = SUPERUSER. Toda acao de N1/N2 e registrada com o campo superuserLevel preenchido.

Rastrear alteracoes financeiras

Filtre por tableName em (accrual_entries, cash_movements, accounts_payable, etc.) para ver todas as operacoes financeiras e quem as realizou.


Retencao

Os registros de auditoria sao mantidos por 30 dias em todos os planos. Para guardar por mais tempo, contrate na Loja a retencao de 1 ano (audit.retention_1y) ou ilimitada (audit.retention_unlimited). Apos o periodo de retencao, uma rotina diaria apaga os registros antigos.


Permissoes

PapelAcesso a Trilha de Auditoria
Admin / Tenant AdminLeitura completa
FinanceiroSem acesso
OperacionalSem acesso
POS / FornecedoresSem acesso
Superuser N1Leitura completa (cross-tenant)
Superuser N2Leitura (se acesso de suporte aprovado)
Last updated on