Definindo níveis de hierarquia
Antes de poder adicionar uma única unidade, o GCM precisa saber como chamá-la. Uma unidade no nível 2 pode ser um Centro em uma igreja, um Campus em outra, uma Região numa terceira. Os rótulos são inteiramente seus.
Esta página é puramente sobre rótulos e interruptores liga/desliga. Criar de fato unidades acontece em Criando unidades.
Abra o editor de hierarquia
Vá em Configurações → Hierarquia organizacional na barra lateral. Você cairá no painel HierarchyTab com um cartão por nível definido.

Uma organização nova começa com o nível 1 já no lugar — chamado Filial por padrão — porque o modelo exige pelo menos um nível para o resto do app funcionar. Os níveis 2 a 10 são adicionados sob demanda.
Cada nível tem quatro campos
| Campo | O que controla | Obrigatório? |
|---|---|---|
| Rótulo singular | Como uma unidade é chamada ("Filial", "Centro") | Sim |
| Rótulo plural | Como muitas unidades são chamadas ("Filiais", "Centros") — usado em títulos de página, cabeçalhos de tabela | Não, padrão é rótulo + "s" |
| Ativo | Se esse patamar aparece em menus de criação de unidade e filtros | Sim para o nível 1, opcional abaixo |
| Índice de nível | O patamar numérico (1 = topo). Definido automaticamente — não dá para reordenar no meio da edição | n/a |
O rótulo singular alimenta botões como Adicionar filial, o título do diálogo de criar-unidade, e cada lugar em que a UI menciona o patamar no corpo do texto. O plural aparece em cartões de estatística ("3 filiais com 482 membros") e no cabeçalho da página. Os dois são traduzidos via a função t() se você ativou o espanhol.
Adicionar um nível
Clique em Adicionar nível N+1 no fim. O GCM semeia o novo nível com um rótulo placeholder ("Nível 4") e um plural placeholder ("Nível 4s"). Abra o cartão, digite seus nomes reais, clique em Salvar alterações.
Níveis podem ser adicionados até um teto rígido de 10. Além disso, o botão some.
Não reordene depois de criar unidades
O índice de nível é a chave estrangeira de org_units.level_index de volta para org_level_definitions.level_index. Renumerar um nível depois de você ter criado unidades as deixaria órfãs. A UI não te deixa reordenar por essa razão — planeje dois níveis mais profundo do que você precisa hoje para ter folga.
Desativar um nível
Se você configurar Região → Filial → Centro → Célula mas depois recolher para Filial → Célula, você pode desligar o interruptor Ativo em Região e Centro. Níveis desativados:
- Desaparecem do menu de criar-unidade.
- Ficam ocultos do drill-down da árvore organizacional.
- São pulados em seletores de unidade pelo app.
- Mantêm suas linhas existentes em
org_units— os dados não são excluídos, só ocultos.
O nível 1 não pode ser desativado. O interruptor fica oculto nesse cartão porque o resto do módulo assume que pelo menos um patamar existe.
Remover um nível
Níveis só podem ser removidos quando são o último na sequência e não têm unidades anexadas. O ícone de lixeira aparece ao lado do título do nível em dois casos específicos:
- O nível é o nível definido mais alto (você não pode abrir um buraco no meio da hierarquia).
- Zero unidades existem nesse nível.
Se qualquer das condições falhar, o botão se oculta — você precisará excluir ou mover as unidades existentes primeiro. Veja Arquivar + restaurar para limpeza.
Padrões comuns por tipo de igreja
| Tipo de igreja | Níveis sugeridos |
|---|---|
| Site único, pequena | Só Ministérios — um nível, com o nome que seus membros usam |
| Site único, grande | Departamento → Ministério |
| Dois sites | Filial → Ministério |
| Baseada em células | Filial → Centro → Célula |
| Denominacional | Região → Distrito → Igreja Local |
| Megaigreja com campi | Região → Campus → Departamento → Pequeno Grupo |
O número certo é o menor número que deixa seus relatórios cascatearem e seus pastores se restringirem à sua fatia. Adicionar níveis em que você vai "crescer" geralmente significa caixas vazias no seu painel.
O que os badges de contagem significam
Cada cartão de nível mostra dois badges ao lado do título assim que existem unidades:
- N unidades — quantas unidades ativas estão nesse nível. Contagens excluem linhas arquivadas.
- L de N líderes — quantas dessas unidades têm um
leader_member_iddefinido. A diferença é a lista de tarefas: filiais sem equipe, células sem pastores, etc.
Esses badges são um check-up rápido. Se o nível 3 diz "12 unidades, 2 líderes" você tem dez grupos sem equipe — provavelmente a razão pela qual seus relatórios de acompanhamento parecem vazios.
Comportamento de salvamento
Edições são locais até você clicar em Salvar alterações. O indicador âmbar "alterações não salvas em N níveis" conta quantos cartões têm edições pendentes. Apertar salvar percorre cada linha suja e as escreve em sequência — se uma falhar (por exemplo, você apagou um rótulo singular), o toast traz o erro e as outras permanecem sujas.
Rótulos singulares são obrigatórios
Rótulos singulares em branco são silenciosamente pulados durante o salvamento. Se você não consegue fazer uma mudança grudar, cheque se você não limpou acidentalmente o campo singular.
Exemplos de traduções
Se sua organização é bilíngue (definido em Configurações → Idioma), os rótulos são armazenados como strings simples. Para traduzi-los, você adicionaria as strings localizadas às chaves de lookup do t() em org_structure.level_label.<id> no seu JSON de locale. Para a maioria das igrejas, os rótulos de nível são falados do mesmo jeito em inglês e espanhol — Cell e Célula são o único par comum.
Próximos passos
- Crie unidades em cada nível agora que os rótulos existem.
- Conecte as relações pai-filho quando você tiver unidades para aninhar.
- Atribua líderes para que pastores tenham o escopo certo desde o primeiro dia.
