Exportar registros de auditoria

A maioria das orgs nunca precisa exportar dados de auditoria — o registro no app vai longe o suficiente para qualquer investigação normal. Mas três situações tornam a exportação valiosa:

1. Época de impostos. Você quer uma cópia congelada e fora da plataforma de toda edição de doação do ano fiscal para defender uma declaração que pode ser questionada depois.
2. Arquivo periódico. Exports regulares fornecem uma cópia portátil e datada mesmo se a política operacional de retenção mudar.
3. Conformidade. Algumas denominações e seguradoras exigem trilhas de auditoria retidas por 7+ anos. Backups de banco de dados satisfazem isso; exports CSV são mais amigáveis para realmente revisar os dados.

Exportar o registro de auditoria da organização

A partir de /activity-log:

1. Aplique os filtros que você quer exportar (tipo de entidade, ação, e-mail do ator). Pule filtros para obter tudo.
2. Clique no botão Exportar CSV no cabeçalho da página.
3. O export roda no servidor e te envia por e-mail um link de download quando estiver pronto. Exports grandes (100.000+ linhas) levam alguns minutos; pequenos completam em segundos.

As colunas do CSV espelham a tabela:

created_at,actor_email,actor_name,action,entity_type,entity_id,changed_columns,reason

changed_columns é separado por vírgula dentro da célula (entre aspas). reason é a justificativa em texto livre quando uma foi fornecida (ex. motivo de execução de workflow); vazio caso contrário.

TIP

O export tem limite de taxa de 5 exports por hora por org para manter a fila de e-mail sã. Se você está fazendo runs de arquivo anual, agende-os — não dispare dez de uma vez.

Exportar atividade do membro

O registro de atividade do membro não tem botão de export por membro — é projetado para leitura humana, não puxadas em massa. Se você precisa dos dados subjacentes:

• Use a API para consultar member_activity_log filtrado por member_id ou janela de created_at.
• Ou exporte o registro de auditoria da org e faça join com seu CSV de membros externamente.

Exportar histórico de importações

Em Dados e Registros → Histórico de Importações, o botão Exportar escreve um CSV de cada job de importação (status, contagens de linha, created_at). Não inclui os registros de erro por linha — esses são baixados por job pelo botão Baixar CSV de erros em cada linha.

Se você precisa dos erros em nível de linha para muitos jobs, o endpoint da API /api/import-jobs/{id}/errors os retorna como JSON.

Cadência sugerida de export

Plano	O quê	Quando	Por quê
Qualquer	Registro de auditoria da org	Mensal ou trimestral	Manter um arquivo portátil
Qualquer	Registro de auditoria da org	Anual	Arquivo de época de impostos
Qualquer	Histórico de importações	Após cada lote grande de importação	Para ter o CSV de erros de linha antes da janela de 30 dias de deleção de arquivo
Qualquer	Atividade do membro para casos de RH	Ad-hoc	Documentar o ciclo de vida de uma pessoa específica

O que você não pode exportar

• O registro de auditoria da plataforma não é acessível a orgs; apenas equipe Genius Church Manager. Se você tem uma solicitação regulatória que o requer, contate o suporte — podemos fornecer um extrato com escopo para seu tenant.
• Valores antes/depois das colunas não são armazenados, então não estão no export. O campo changed_columns diz o quê mudou; o estado atual da linha mais backups de banco de dados dizem os valores.
• Registros de acesso de leitura não existem neste produto. Rastreamento de visualização é um add-on enterprise; contate o suporte se seu programa de conformidade o exige.

Armazenar exports com segurança

Dados CSV de auditoria contêm nomes de membros, histórico de edição, e (em histórico de importações) potencialmente PII dos seus arquivos de origem. Trate exports da mesma forma que um backup de banco de dados de membros:

• Criptografe em repouso se você está armazenando fora de um serviço gerenciado.
• Mantenha-os em uma pasta com acesso restrito — não um drive compartilhado que todos podem ler.
• Retenha apenas pelo tempo que sua política de retenção exigir; exclua execuções mais antigas uma vez que uma mais recente é arquivada.

WARNING

Não cole linhas de registro de auditoria em e-mails, Slack ou ferramentas de IA. Elas contêm e-mails de atores e IDs de entidade que podem ser cruzados de volta para pessoas. Se você precisa compartilhar uma entrada para um caso de suporte, redija o e-mail do ator e ID da entidade primeiro — a equipe de suporte pode procurar a mesma linha por id ou created_at.

E quanto a backups?

As tabelas de auditoria estão incluídas nos backups gerenciados que protegem os dados da organização. A janela de recuperação ativa é uma configuração operacional da plataforma; qualquer retenção contratual mais longa é documentada no acordo Enterprise. Backups recuperam o banco de dados; exports CSV permitem revisar o registro em uma planilha.

Veja também

• Registro de auditoria da organização para a fonte do export
• Histórico de importações para o CSV por job
• API para acesso programático