Arquivando e restaurando unidades

Igrejas se reorganizam. Um campus fecha. Duas células se mesclam. Uma região se divide em três. O módulo Estrutura organizacional distingue três estados para uma unidade para que relatórios históricos permaneçam precisos enquanto a árvore ao vivo reflete a realidade de hoje.

Estado	O que significa	Onde aparece
Ativa	O padrão — a unidade está ao vivo.	Árvore, seletores, painéis, mapa.
Arquivada	archived_at está definido. A unidade fica oculta do uso diário, mas suas linhas em org_units, member_unit_assignments, presença e doações estão intactas.	Aba Arquivadas na página de estrutura organizacional.
Excluída	deleted_at está definido. A unidade é removida suavemente do banco.	Em nenhum lugar visível. Restaurável só pelo suporte.

Você vai usar Arquivar dez vezes mais que Excluir. É o padrão seguro.

Arquivar uma única unidade

Na árvore organizacional, clique no menu de três pontos na linha de uma unidade e escolha Arquivar. Um diálogo de confirmação abre com três informações:

• O nome da unidade.
• Um aviso de que todas as unidades filhas também serão arquivadas se houver alguma. A cascade é automática e calculada via collectAllDescendants — cada descendente recebe archived_at definido na mesma operação.
• Uma nota de que unidades arquivadas ficam fora de contagens e seletores, mas continuam restauráveis.

Confirme para executar. Um toast aparece com a contagem de unidades arquivadas.

Arquivar em massa

Marque as caixas em várias unidades na árvore, clique em Arquivar na barra de ferramentas fixa que aparece. A mesma regra de cascade se aplica — descendentes de cada unidade selecionada são puxados automaticamente. O toast mostra a contagem total.

Esse é o fluxo que você quer ao fechar um campus: selecione o campus e cada filho se dobra em um clique.

O que "arquivada" faz no app

Depois de arquivar:

• A unidade desaparece da aba ativa da árvore organizacional.
• A unidade desaparece de cada seletor em membros, presença, doações e relatórios.
• A contagem de membros da unidade e a consolidação de doações param de contribuir para os painéis (ou seja, o total de membros da organização na página inicial cai pelo tanto que estava na subárvore arquivada).
• A unidade deixa de aparecer como alvo de workflow.
• A unidade mantém suas linhas member_unit_assignments. Os membros continuam vinculados à unidade arquivada — eles não são auto-desatribuídos. Se você reativar depois, tudo volta ao lugar.
• Linhas históricas de presença e doação que referenciavam a unidade no momento do registro ainda resolvem — elas buscam pelo id, e o id ainda existe.

Arquive antes de excluir, sempre

Não existe uma "lixeira com expurgo automático" no GCM. Unidades arquivadas ficam para sempre até você agir. Isso é deliberado — seus dados estão mais seguros onde você pode vê-los.

A aba Arquivadas

Mude para a aba Arquivadas em /org-structure para ver cada unidade arquivada em uma lista plana, ordenada por nome. Cada linha mostra:

• O nome da unidade (esmaecido).
• O badge de nível.
• A data de arquivamento ("Arquivada em 14 jan 2026").
• Um menu de três pontos com as opções Desarquivar e Excluir permanentemente.

Clicar em uma linha abre uma modal de detalhes somente leitura com o nome, nível, endereço e último líder conhecido. Daí você também pode desarquivar.

Desarquivar (restaurar)

Abra a linha da unidade na aba Arquivadas, clique em Desarquivar no menu de três pontos (ou na modal de detalhes). O GCM limpa archived_at naquela unidade específica.

Desarquivar não cascateia. Se você arquivou uma filial com três centros e quatro células, desarquivar a filial traz a filial de volta, mas deixa os centros e as células arquivados. Você pode:

• Selecioná-los um a um na aba Arquivadas.
• Usar seleção em massa para desarquivar um grupo de uma vez.

Esse design dividido importa quando só parte de uma reestruturação se reverte — digamos que você fecha um campus, mas depois decide reabrir o prédio principal sem as células satélites.

Desarquivar em massa

Na aba Arquivadas, marque as caixas nas linhas que você quer, aperte Desarquivar na barra de ferramentas fixa. Todas as unidades selecionadas têm archived_at limpo em uma única atualização.

A ordem não importa — a restauração da árvore é puramente baseada em parent_unit_id, então enquanto o pai também estiver desarquivado (ou nunca tiver sido arquivado), o filho renderiza corretamente.

Exclusão permanente

Se você tem certeza de que uma unidade nunca vai voltar — digamos que você digitou errado uma filial de teste durante o onboarding — você pode excluir permanentemente pela aba Arquivadas.

Dois caminhos:

• Por unidade: Menu de três pontos → Excluir permanentemente.
• Em massa: Selecione várias linhas arquivadas, clique em Excluir na barra de ferramentas fixa.

Ambos os caminhos definem deleted_at nas unidades. As linhas ainda existem no banco para fins forenses, mas o app as trata como sumidas.

Exclusão permanente não pode ser desfeita pela UI

Uma vez que deleted_at está definido, a unidade cai fora de cada superfície da UI — incluindo a aba Arquivadas. Não há botão "restaurar da lixeira". Se você excluir uma unidade da qual precisava, contate o suporte com o id da unidade do seu log de auditoria.

Exclusão da aba ativa (com reatribuição)

Há também uma ação Excluir em unidades ativas. Ao contrário de Arquivar, essa exclui suavemente de imediato — e força você a decidir o que acontece com membros e filhos primeiro.

O assistente pergunta:

• O que deve acontecer com as unidades filhas? Excluí-las também (exclusão suave recursiva) ou Mover para uma unidade irmã que você escolhe.
• O que deve acontecer com os membros atribuídos? Desatribuí-los (remover as linhas member_unit_assignments) ou Reatribuí-los para uma unidade irmã que você escolhe.

O fluxo roda como uma sequência: reparentamento de filho → reatribuição de membro → limpeza de escopo de usuário → exclusão suave nos alvos.

Recorra a isso quando você tem certeza de que quer remover a unidade, mas não quer que a cascade também apague dados que você se importa. A maioria das equipes usa Arquivar em vez disso e pula o assistente.

Trilha de auditoria

Cada arquivamento, desarquivamento e exclusão escreve no log de dados com o id de usuário do ator, timestamp e a unidade-alvo. Você pode encontrá-lo em Logs de Dados → Unidades organizacionais. A trilha sobrevive à exclusão da unidade — você pode responder "quem excluiu a Célula Norte?" meses depois.

Perguntas comuns

Arquivar uma unidade desatribui seus membros? Não. As linhas member_unit_assignments deles ficam. Eles só não aparecerão em visões filtradas por unidade até que a unidade seja restaurada.

E se eu arquivar uma unidade cujo líder está definido? O leader_member_id é preservado. Quando você restaura, o líder ainda está anexado. Restaurar também reativa o nome do líder nos relatórios.

Posso desarquivar em massa uma subárvore inteira em um clique? Não em um clique. Você tem que selecionar as linhas que quer — mas na aba Arquivadas, selecionar tudo e clicar em Desarquivar faz o trabalho em uma operação.

Por que unidades arquivadas são excluídas de painéis, mas não de relatórios históricos de presença? Painéis contam o estado ao vivo — "quantas filiais ativas temos agora mesmo". Relatórios contam eventos — "quantos compareceram a este culto em março de 2024". Os eventos ainda referenciam a unidade pelo id mesmo depois que a unidade é arquivada, então o relatório ainda resolve.

Próximos passos

• Migre de uma estrutura plana — para organizações fazendo upgrade de um modelo de um único patamar.
• Defina seus níveis — recomece ou renomeie o que está lá.