AuditLog

​

Campos

​

Relacionamentos

• Relaciona-se opcionalmente com Organization.
• userId identifica logicamente o User associado à ação.

​

Regras de Negócio

• Log append-only — registros nunca são editados ou removidos.
• type classifica se o registro nasceu de uma ação da aplicação ou de uma rotina do sistema.
• type = SYSTEM_LOG pode ter userId = null quando não houver ator humano ou usuário de sistema associado.
• Rastreamento via domain + resource + resourceId (ex.: domain = IDENTITY, resource = USER, resourceId = uuid).
• domain e resource são enums fechados para garantir filtros consistentes.
• action é 100% aberto e não possui enum. A aplicação pode registrar combinações de negócio como USER_BLOCKED, ROUTE_APPROVED, TICKET_REPRINTED ou SESSION_REVOKED.
• Armazena snapshots de antes (oldData) e depois (newData) para rastreabilidade completa.
• Captura metadados da requisição (userAgent, ip) para fins de segurança.
• A consulta pode ser filtrada por organização, usuário, domain, resource, resourceId, action e data.
• Por ser append-only, o registro usa apenas createdBy e createdAt como auditoria direta.

​

Enums

​

AuditLogType

​

AuditDomain

​

AuditResource

​

Example

{
  "auditLogId": "0197a819-ae6c-7cd6-b872-1f6c898c50d9",
  "organizationId": "0197a7f7-7291-7a43-96db-2c8580b80c5d",
  "userId": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "type": "APPLICATION_LOG",
  "domain": "OPERATIONS",
  "resource": "ROUTE",
  "resourceId": "0197a80c-4204-7b77-9005-48cc23677587",
  "action": "ROUTE_APPROVED",
  "userAgent": "DEVMOB-Ops/1.0",
  "ip": "203.0.113.10",
  "oldData": {
    "status": "PENDING_APPROVAL"
  },
  "newData": {
    "status": "ACTIVE"
  },
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T16:00:00.000Z"
}