Mapa

O módulo Mapa mostra as pessoas e os lugares da sua igreja em um mapa-múndi baseado em Leaflet. Abra uma vez e você tem as respostas que uma lista de membros impressa nunca dará: onde a maioria dos nossos membros de fato mora, em quais bairros não temos ninguém, onde cada sede fica em relação às pessoas que ela atende.

O que aparece no mapa

Duas camadas, ambas alternáveis:

Camada	O que mostra	Marcador
Membros	Cada membro com pelo menos uma coordenada registrada	Círculo com foto de perfil ou inicial
Unidades organizacionais	Cada sede, filial ou subunidade com uma coordenada	Pílula colorida rotulada com a abreviação do nível

Um membro ou unidade só aparece se tiver um pin exato (definido à mão) ou um local estimado (geocodificado a partir do endereço). Registros sem endereço e sem pin são silenciosamente ignorados — não há nada para plotar.

A contagem de pins no canto superior direito dos controles (123 pins) é o total do que está atualmente visível depois dos seus filtros.

De onde vêm as coordenadas

Cada membro e cada unidade organizacional pode carregar duas coordenadas independentes:

• Exata (pin colocado) — map_location. Definida por um membro da equipe que realmente abriu o perfil, clicou em Usar minha localização ou digitou lat,lng. Verdade do campo.
• Aproximada (do endereço) — estimated_map_location. Definida automaticamente pelo geocoder quando um campo de endereço muda. Barata, escala para milhares de membros, mas apenas tão precisa quanto o endereço subjacente.

O seletor de fonte nos controles permite escolher qual exibir:

• Exata (pin colocado) — apenas registros com pin definido à mão.
• Aproximada (do endereço) — apenas registros que o geocoder colocou.
• Todos os locais (padrão) — preferir o pin exato; cair para o estimado se nenhum pin existe.

Veja Geocodificação de membros para como endereços viram coordenadas e como é a fila de espera nos bastidores.

Controles do mapa

Um único cartão fica acima do mapa:

• Caixas de seleção Membros / Unidades organizacionais — ligue e desligue cada camada.
• Dropdown de fonte — exato / aproximado / todos.
• Caixa de seleção Cluster — agrupe marcadores de membros próximos em bolhas numeradas nos níveis de zoom reduzido.
• Contagem de pins — total de marcadores visíveis, atualiza enquanto você muda filtros.

O mapa em si suporta zoom com a roda, panorâmica de clique-e-arraste e se ajusta automaticamente a quaisquer marcadores atualmente visíveis. Mude a fonte ou alterne uma camada, e o mapa reajusta para manter seus dados em foco.

Estados vazios

A área do cartão lida com duas situações sem dados de forma limpa:

• Habilite pelo menos uma camada para ver marcadores no mapa — Membros e Unidades organizacionais ambos desmarcados.
• Nenhum registro com dados de localização encontrado — camadas estão ligadas, mas nada na sua organização tem uma coordenada ainda. Adicione um pin a um membro, adicione um endereço e deixe o geocoder rodar, ou cheque a fila de geocodificação.

Plano e permissões

Requisito	Onde é aplicado
Módulo Mapa habilitado para o plano da organização	Registro de módulos — planos growth+
Permissão map.view	Guarda de rota em /map
Módulo Estrutura organizacional habilitado	Dependência — a camada de unidades organizacionais precisa da hierarquia

O mapa é um visualizador somente leitura. Você não pode arrastar um marcador para um novo lugar da página do mapa; coordenadas são definidas no perfil do membro ou no editor de unidade organizacional.

Ação	Admin	Pastor	Membro
Abrir o mapa	sim	sim	não
Ver popups de membros	sim	sim	n/a
Ver popups de unidades organizacionais	sim	sim	n/a
Configurar provedor de geocodificação	sim	não	não

Privacidade

Membros aparecem no mapa por nome e foto de perfil, então o mapa respeita as mesmas regras de acesso do diretório de membros — se você não pode ver o perfil de um membro, também não verá o pin dele. Consultas de marcador são com escopo na sua organização por RLS, então um líder de Grace Community Church nunca verá um pin de outra igreja na mesma instância do Supabase.

Se um membro não quer aparecer em um mapa compartilhado, limpe tanto o pin exato quanto o endereço dele. Sem endereço, o geocoder não produz uma estimativa, e o membro silenciosamente sai do mapa.

Por que um mapa real (e não só uma lista)

Uma lista impressa de endereços dá uma contagem. Um mapa dá um formato. Coisas comuns que líderes notam a primeira vez que abrem:

• Metade dos nossos membros mora em um bairro que nosso programa de grupos de casa não cobre.
• Temos dois membros do outro lado da rodovia, a quatro horas da sede mais próxima. Provavelmente não conseguem vir no domingo.
• Nosso ministério de jovens está concentrado em um distrito escolar. Devemos pensar em um segundo.

Essas são decisões que você não consegue tomar a partir de uma planilha. O mapa é o jeito mais barato de fazê-las emergir.

Próximos passos

1. Visualizando membros no mapa — o que a camada de membros mostra e como os popups funcionam.
2. Unidades organizacionais no mapa — sedes, filiais e os marcadores coloridos por nível.
3. Filtros e camadas — ligar e desligar coisas, trocar fonte, controlar o clustering.
4. Geocodificação de membros — como endereços viram coordenadas, provedores e a fila.