Unidades organizacionais no mapa

A camada de unidades organizacionais coloca o esqueleto estrutural da sua igreja no mapa. Sedes, filiais, regiões, grupos de células — qualquer que seja o nome da sua hierarquia — cada uma com um endereço registrado aparece como um marcador em pílula colorida. Ligue a camada com a caixa Unidades organizacionais no cartão de filtros.

Como é um marcador de unidade organizacional

Marcadores de unidades organizacionais deliberadamente não são o mesmo formato dos marcadores de membros. São quadrados arredondados (ou círculos no nível superior) com um rótulo de três letras, pintados em uma cor específica do nível. De relance você pode dizer isso é uma sede, aqueles são grupos de células sem ampliar ou clicar.

Visual	O que te diz
Formato	Círculo = nível superior (ex.: Sede). Quadrado arredondado = cada nível abaixo.
Cor	Uma cor por nível. Mesmo nível = mesma cor em todo o mapa.
Rótulo	Primeiras três letras do nome do nível, em maiúsculas. Sede → SED, Centro → CEN, Grupo de célula → GRU.

A paleta de cores cicla por seis valores fixos (roxo, verde, laranja, rosa, verde-azulado, amarelo). Se sua hierarquia tem mais de seis níveis, o nível sete volta para o roxo — raro, mas possível.

De onde vêm os nomes dos níveis

Níveis de unidades organizacionais não são codificados. Sua organização os define em Configurações → Estrutura organizacional → Níveis quando você configura a hierarquia. Uma igreja pode usar Filial / Centro / Bascenta; uma rede multi-sede pode usar Região / Sede / Ministério; uma igreja pequena pode usar Igreja / Grupo.

O mapa lê os rótulos de nível ao vivo de org_level_definitions, então mudar um nome de nível nas configurações atualiza o texto do popup e a abreviação de três letras no marcador na próxima vez que o mapa carregar. A cor permanece amarrada ao índice do nível, não ao nome — renomear Centro para Sede não reorganiza as cores.

Clicando em um marcador de unidade organizacional

Clique na pílula e um popup abre com:

• Nome — o nome completo da unidade organizacional (ex.: Sede Central de Cartagena).
• Endereço — o endereço configurado, se um existe.
• Selo de nível — o rótulo do nível (ex.: Sede) colorido na cor do nível.
• Link Ver unidade — pula para /org-structure?unit=:id com aquela unidade pré-selecionada na árvore de estrutura organizacional.

Da visão de estrutura organizacional você pode editar o endereço da unidade, mudar seu pai, adicionar unidades filhas ou ajustar o nível. Mudanças no endereço fluem pelo geocoder e aparecem no mapa em um minuto ou pouco mais.

De onde vêm as coordenadas

Assim como membros, cada unidade organizacional pode carregar duas coordenadas independentes:

• Pin exato (map_location) — colocado à mão por um admin no editor de unidade organizacional, usando Usar minha localização ou digitando lat,lng.
• Coordenada aproximada (estimated_map_location) — colocada pelo geocoder a partir do endereço da unidade organizacional.

O seletor de fonte nos controles do mapa se aplica a ambas as camadas. Coloque em Exato e você só verá unidades organizacionais com pin colocado à mão; Aproximado mostra apenas as geocodificadas; Todos os locais desenha cada unidade na sua melhor coordenada disponível.

A maioria das organizações acaba com pins colocados à mão para seu nível superior, um ou dois (as sedes que a liderança quer fixar exatamente) e estimativas geocodificadas para tudo abaixo.

Clustering: unidades organizacionais vs membros

Esta é a pergunta mais feita sobre a camada de unidades organizacionais, então:

Marcadores de unidades organizacionais nunca são clusterizados. O alternador de cluster no topo dos controles do mapa só se aplica à camada de membros.

Por que a assimetria? Algumas razões cozidas no design:

• Volume. Uma organização típica tem 5–30 unidades organizacionais no total. Uma organização típica tem centenas ou milhares de membros. Clustering existe para resolver o problema de mancha de membros do tamanho de uma cidade; unidades organizacionais não têm esse problema.
• Identidade importa por unidade. Um marcador de membro em um cluster é OK — você não perde nada colapsando 20 pontos azuis anônimos em uma bolha 20. Um marcador de unidade organizacional colapsado em uma bolha perde a cor do nível e a abreviação, que é o ponto inteiro da camada.
• Sobreposição espacial é rara. Unidades organizacionais ficam em seus próprios endereços, que geralmente são bem separados. Duas sedes no mesmo bairro é incomum; dois grupos de células no mesmo prédio, menos — mas naquele nível de zoom você já entrou perto o suficiente para vê-los individualmente.

Se você tem muitos grupos de células de nível folha (centenas em uma única cidade), eles vão se sobrepor em uma visão com zoom reduzido. O atalho por enquanto é ampliar. Uma opção futura para clusterizar o nível hierárquico mais baixo está no roadmap; até lá, visibilidade individual vence.

Quando uma unidade organizacional não aparece

Se uma unidade que você espera ver está faltando:

1. Nenhuma coordenada. Abra a unidade em /org-structure?unit=:id — o campo de localização tem um valor, e o campo de endereço tem conteúdo? Sem nenhum dos dois, o geocoder não tem com o que trabalhar e o mapa pula o registro.
2. Geocoder ainda pendente. Cheque estimated_geocode_status. Novas unidades começam em pending; o worker leva um minuto ou pouco mais para rodar. Atualize o mapa depois de um minuto.
3. Filtro de fonte exclui. Se você ajustou a fonte para Exato e a unidade só tem uma estimativa geocodificada, ela ficará oculta. Mude para Todos os locais.
4. Camada alternada para desligado. A caixa Unidades organizacionais no cartão de filtros está desmarcada.
5. Excluída suavemente. O mapa exclui registros deleted_at IS NOT NULL da mesma forma que cada módulo faz. Restaure da lixeira se deve continuar existindo.

Editando a localização de uma unidade organizacional do mapa

Você não pode. Mesmo que a camada de membros, o mapa é somente leitura — você pode visualizar, mas o único lugar para mudar uma coordenada é o editor de unidade no módulo estrutura organizacional. O trabalho do mapa é descoberta; o trabalho do editor é mutação. Deliberadamente não habilitamos arrastar-para-mover no mapa porque sedes não se movem e um clique errado acidental sobrescreveria silenciosamente um pin importante.

Relacionado

• Visão geral do mapa — a página que hospeda ambas as camadas.
• Visualizando membros no mapa — o que a outra camada mostra.
• Filtros e camadas — alternar unidades organizacionais, trocar fonte de coordenadas.
• Geocodificação — como endereços de unidades organizacionais viram coordenadas.
• Criando unidades organizacionais — o editor onde você define o endereço e o pin de uma unidade.
• Módulo Membros — a outra metade da imagem no mapa.