Registro de atividades

O registro de atividades (activity log) é a trilha de auditoria da loja. Cada vez que alguém faz login, altera um pedido, edita um produto ou muda uma configuração, a plataforma grava uma linha dizendo quem fez, o quê, em qual registro, de qual IP e quando. É a ferramenta para investigar incidentes ("quem apagou isso?") e para atender exigências de auditoria.

Como funciona

1. A plataforma grava um registro quando uma ação acontece e o par type + action está ligado.
2. Você consulta com filtros por tipo, ação, pessoa, registro afetado, gravidade e período.
3. Para análise externa, exporta em CSV.
4. Periodicamente, apaga o que é antigo demais.

A gravidade (event_level) vem em três valores:

Conceitos principais

Par tipo e ação

type é a área (orders, products, auth) e action o verbo (create, update, delete, login). A configuração liga ou desliga cada combinação.

Registro afetado

entity_type e entity_id apontam para o item que mudou. Com eles você monta o histórico de um pedido ou produto.

Antes e depois

Algumas ações guardam o estado anterior e posterior em payload_before e payload_after. Só a consulta em JSON devolve esses campos; o CSV não.

Ações do sistema

Rotinas automáticas gravam com user_id vazio e rótulos como System.

Endpoints

Erros comuns

• Esperar registro de um evento novo sem rodar Semear pares padrão: sem o par, o evento é descartado em silêncio.
• Enviar date_from como 2026-10-01: o formato é RFC 3339 completo e, se estiver errado, o filtro é ignorado sem aviso.
• Pedir per_page=500: valores acima de 100 voltam para 20.
• Tratar logs: null como erro: é a resposta de uma busca sem resultado.
• Ignorar X-Export-Truncated na exportação.
• Desligar logs + settings_update e perder a trilha de quem mexeu na própria auditoria.

Próximos passos