Estrutura organizacional

Cada igreja se organiza diferente. Uma igreja em loja de bairro se reúne em uma sala e tem Ministérios. Uma rede multi-sede abrange regiões, filiais, centros e células. Um pastor de campus usa Departamento → Ministério. Não existe um modelo fixo de três níveis no GCM — você nomeia e aninha seus patamares para combinar com como seus membros já falam.

Este módulo é o que torna isso possível. Ele alimenta os escopos de líderes, os recortes de presença, os relatórios de doações, a visualização de mapa e quase todo filtro em toda lista do app.

Já está confortável com o básico?

O guia de primeiros passos passa pela configuração inicial em 5 minutos. Esta seção vai mais fundo — cada tela, cada caso extremo, cada decisão que as tabelas subjacentes te deixam tomar.

Três coisas para manter claras

O GCM divide o modelo organizacional em três conceitos que vivem em três tabelas diferentes. Eles parecem semelhantes na UI; eles se comportam muito diferente nos relatórios.

Conceito	O que é	Tabela	Exemplo
Nível	O nome de um patamar na sua hierarquia	org_level_definitions	"Filial" (nível 1), "Centro" (nível 2), "Célula" (nível 3)
Unidade	Uma instância concreta em um nível	org_units	Filial Centro, Centro Norte, Célula Acácia
Atribuição	Um membro pertencente a uma unidade	member_unit_assignments	Jane Doe → Célula Acácia

Líderes e equipe têm sua própria tabela — user_unit_assignments_v2 — que controla o que eles podem ver, não a que pertencem. Um pastor é membro de uma célula e o pastor de toda uma filial; os dois são registros separados.

Quando você precisa deste módulo

Você nem sempre precisa de uma hierarquia. Uma igreja de casa de site único pode ignorar o módulo totalmente e juntar todo mundo em Ministérios. Você começa a precisar dele quando uma destas é verdadeira:

• Você tem mais de uma localização física e precisa filtrar membros ou presença por sede.
• Você tem pastores cuja visão de membros deve ser mais estreita que a do pastor sênior.
• Seus relatórios precisam consolidar — por exemplo, "presença de domingo por filial, separada por centro".
• Você imprime demografia por região para reuniões do conselho.
• Sua visualização de mapa deve fixar unidades, não só membros.

Se nenhuma dessas se aplica, pule para Membros e volte depois.

A regra N-níveis

O GCM suporta até 10 níveis de profundidade. O nível 1 é sempre obrigatório; os níveis 2 a 10 são opcionais e cada um pode ser ligado ou desligado por organização. O modelo é estritamente em formato de árvore — cada unidade tem exatamente um pai (exceto o nível 1, que não tem).

A regra para membros é uma unidade por nível. Um membro pode pertencer a uma filial e a uma célula, nunca a duas filiais ao mesmo tempo. Isso mantém as consolidações sem ambiguidade: quando você soma a presença por filial, ninguém é contado duas vezes.

Para a equipe, a regra é diferente — um líder pode ser atribuído a várias unidades no mesmo nível (um pastor multi-campus, um tesoureiro regional). O escopo visível dele é a união de suas unidades atribuídas e todos os descendentes.

Ordem de configuração

Configure uma vez, nesta ordem, e você evitará a maior parte do retrabalho que pega as igrejas que pulam direto para convidar usuários:

1. Defina seus níveis — nomeie os patamares que sua igreja realmente usa.
2. Crie suas unidades — uma linha por local físico ou lógico.
3. Conecte as relações pai-filho — aninhe cada unidade sob seu pai.
4. Atribua membros — vincule cada membro à unidade-folha à qual ele pertence.
5. Atribua líderes e pastores — restrinja usuários à(s) unidade(s) que eles supervisionam.
6. Arquive o que muda — quando um campus fecha ou uma célula se divide, arquive — não exclua.

Permissões

Ação	Admin	Pastor	Pastor de unidade	Membro
Definir níveis	sim	sim	não	não
Criar / editar / arquivar unidades	sim	sim	não	não
Atribuir membros a uma unidade	sim	sim	sim (somente unidades atribuídas)	não
Atribuir um líder a uma unidade	sim	sim	não	não
Ver membros de uma unidade	sim	sim	sim (subárvore atribuída)	apenas a própria unidade

A regra de "subárvore atribuída" é aplicada no banco via Row-Level Security na função current_org_id() e no RPC user_visible_unit_ids. Mesmo que um pastor inspecione as chamadas de rede do navegador e consulte diretamente, o banco recusa linhas fora do escopo dele.

O que consolida em quê

Uma vez que sua hierarquia existe, cada contagem que menciona uma unidade sabe como cascatear:

• Contagem de membros em uma filial = membros diretamente na filial + membros em cada descendente.
• Presença em uma filial em um domingo = a união da presença em cada reunião realizada por qualquer descendente.
• Total de doações para um centro = doações registradas contra qualquer membro cuja unidade está na subárvore do centro.
• Pinos no mapa = cada unidade com map_location definido, codificado por cor pelo nível.

É por isso que o nível em que você coloca um membro importa. Colocar todo mundo no nível 1 porque é "mais fácil" derrota a cascade — os totais por filial seriam iguais aos totais globais e os centros estariam vazios.

Migrando de uma estrutura plana

Clientes GCM existentes que começaram antes do N-nível ser lançado estavam em um modelo legado de três níveis (filial / centro / bascenta). Esse modelo se foi — suas linhas existentes foram elevadas para org_units durante a migração e as definições de nível foram preservadas como estavam. Se você está começando do zero hoje não precisa pensar nisso; se está rearquitetando, veja Migrando de uma estrutura plana para uma estrutura N-níveis.

Próximos passos

• Defina seus níveis — a base de tudo o mais.
• Crie sua primeira unidade — seu registro de nível 1.
• Atribua membros — vincule pessoas à árvore.