Histórico de Mesclagem
Toda vez que você mescla dois registros de pessoa, o TimelyChurch grava uma entrada permanente no log de Histórico de Mesclagem. Este artigo explica o que é registrado, como ler o log e como reverter uma mesclagem que não deveria ter acontecido.
Por Que Manter um Log de Mesclagem?
Mesclar duas pessoas é uma operação que parece destrutiva — você colapsa dois históricos em um, e o registro secundário é arquivado. Uma trilha de auditoria confiável oferece:
- Responsabilidade — Quem mesclou quem, e quando.
- Recuperação — Se uma mesclagem estava errada, você pode ver exatamente o que foi combinado e desfazê-la.
- Conformidade — Para igrejas que operam sob SOC 2 ou frameworks similares, um registro resistente a adulteração de quem alterou o quê é essencial.
Onde Encontrar
- No portal de administração, navegue até Pessoas > Histórico de Mesclagem.
- Você verá uma lista em ordem cronológica reversa de cada mesclagem que aconteceu na sua igreja.
Cada linha mostra:
- Pessoa Principal — O registro que foi mantido (clicável para abrir o perfil)
- Pessoa Secundária — O nome do registro que foi arquivado (tirado do snapshot, já que o registro agora está com exclusão suave)
- Mesclado Por — O membro da equipe que realizou a mesclagem
- Mesclado Em — A data e hora da mesclagem
- Registros Transferidos — Um resumo do que foi movido (por exemplo, "12 Participações em Grupos, 3 Notas, 1 Participação em Família")
- Notas — Quaisquer notas de texto livre que o responsável adicionou no momento da confirmação
O Que É Registrado
Para cada mesclagem, o TimelyChurch grava uma entrada PersonMergeLog que captura:
Identidade
- O church_id (cada mesclagem é escopada ao seu inquilino)
- O ID da pessoa principal (a que permanece)
- O ID da pessoa secundária (a que foi arquivada)
Snapshot
- Um snapshot completo do registro da pessoa secundária no momento da mesclagem — nome, e-mail, telefone, endereço, data de nascimento, gênero, campos personalizados. Este snapshot é o que alimenta o nome "Pessoa Secundária" mostrado no log mesmo depois que o registro subjacente é removido.
Contagens de Registros Transferidos
O log registra quantos de cada tipo de registro relacionado foram movidos do secundário para o principal. Os tipos de registro reconhecidos incluem:
| Tipo de Registro | O Que Conta |
|---|---|
| Participações em Grupos | Grupos pequenos, classes e equipes |
| Registros de Presença | Entradas de presença vinculadas à pessoa secundária |
| Check-ins | Eventos de check-in |
| Acompanhamentos | Tarefas de acompanhamento abertas e concluídas |
| Notas | Notas pastorais, de oração e gerais |
| Doações | Registros de doações |
| Compromissos | Compromissos e campanhas de compromisso |
| Envios de Formulários | Cartões de conexão e envios de formulários |
| Atribuições de Voluntariado | Funções de voluntariado ativas |
| Participações em Famílias | Participações em qualquer unidade familiar |
| Valores de Campos Personalizados | Valores armazenados para campos personalizados |
| Auto-Referências | Referências cruzadas onde outro registro apontava para o secundário |
Se um tipo específico era zero, ele é omitido do resumo para que você veja apenas o que realmente se moveu.
Escolhas de Campo
- Um registro de qual escolha campo a campo foi feita durante a mesclagem — por exemplo, "manteve o e-mail do principal, pegou a data de nascimento do secundário". Isso é capturado no fluxo de mesclagem lado a lado que permite escolher entre valores conflitantes.
Autoria
- O ID do usuário merged_by
- O timestamp merged_at
- Notas de texto livre que o operador digitou na confirmação
Lendo uma Entrada do Log de Mesclagem
Quando você clica em uma linha na página Histórico de Mesclagem, vê uma visualização detalhada com:
- Os nomes de ambos os registros (o principal permanece clicável; o secundário abre uma visualização arquivada se necessário)
- A contagem completa de registros transferidos
- A matriz de decisão campo a campo
- Quem realizou a mesclagem e quando
- Quaisquer notas do momento
Isso é suficiente para reconstruir exatamente o que aconteceu. Se um membro liga e diz "vocês me mesclaram com meu irmão", você tem os dados para verificar — e reverter, se necessário.
Revertendo uma Mesclagem Incorreta
Uma mesclagem errada é recuperável, mas requer intervenção da equipe. Não há um botão de um clique "Desfazer Mesclagem" porque os registros ao redor (doações, presença) já foram reatribuídos.
Padrão de Recuperação
- Abra Pessoas > Histórico de Mesclagem e encontre a mesclagem incorreta.
- Anote o ID da pessoa secundária — o registro dela foi excluído com suavidade, não destruído.
- Na página Pessoas, mude para o filtro Arquivados e encontre o registro da pessoa secundária.
- Clique em Restaurar para trazê-la de volta ao seu diretório ativo.
- Abra o perfil da pessoa principal e mova manualmente de volta quaisquer registros que foram transferidos mas não deveriam ter sido — geralmente os mais relevantes são participações em famílias, participações em grupos e notas.
- Use a lista de escolhas de campo do log de mesclagem para saber quais campos de informação de contato reverter no principal se os valores errados foram mantidos.
Se sua igreja tem muita atividade nos registros mesclados, isso pode ser trabalhoso. A trilha de auditoria é o que torna isso possível.
Dica: Se você descobre uma mesclagem incorreta rapidamente (no mesmo dia, antes que a pessoa secundária tenha nova atividade), é muito mais fácil recuperar do que se já passaram semanas. Crie o hábito de revisar o log de mesclagem logo após realizar mesclagens, especialmente durante uma campanha de limpeza de duplicatas.
Boas Práticas
- Sempre adicione notas ao mesclar. Uma linha "Confirmado por telefone com João" compensa depois.
- Use a mesclagem lado a lado para casos limítrofes. Ela captura escolhas de campo no log de auditoria.
- Revise a página Histórico de Mesclagem semanalmente durante campanhas de limpeza. Isso detecta erros cedo.
- Treine vários membros da equipe no protocolo de mesclagem. Quando apenas uma pessoa sabe como as mesclagens são feitas, erros passam despercebidos.
- Trate o ID da pessoa secundária como referência permanente. Se você precisar de suporte, esse ID e a entrada do log de mesclagem nos dizem exatamente o que aconteceu.
Privacidade e Retenção
Entradas do log de mesclagem são retidas indefinidamente por padrão. O snapshot armazenado no log são os dados da pessoa secundária no momento da mesclagem — ele não atualiza se o registro principal mudar depois. Isso é intencional: o snapshot é um registro forense, não um espelho ao vivo.
Se sua igreja tem uma política de retenção que exige purgar logs de mesclagem após um período fixo, entre em contato com o suporte; isso é uma configuração por igreja.