Planejamento do Módulo Georeferenciamento

Objetivo:
Criar um módulo para apresentar um mapa do estado de São Paulo com os números de votos que os candidatos Adilson Barroso (contato_id=41) e Fabiana Bolsonaro (contato_id=42) tiveram nas cidades do estado.

Funcionalidades:
- Exibir mapa do estado de São Paulo usando Leaflet.
- Mostrar marcadores nas cidades com badges indicando o número de votos para cada candidato.
- Mostrar bandeira vermelha nos municípios que não tiveram votos.
- Filtro ou abas para alternar entre visualização por cidade e por mesorregião.
- Drill-down ao clicar em uma mesorregião para mostrar os municípios dentro dela.
- Loading spinner enquanto os dados são carregados.
- Legenda clara para bandeira vermelha e badges.

Dados:
- Tabela candidatos_monitorados: campos votos, id_municipio, contato_id.
- Tabela municipios: campos codigo_ibge, latitude, longitude.
- Tabela municipios_regiao_metropolitanas: campo mesorregiao.

Arquivos e Estrutura:
- public/modules/georeferenciamento/index.php: interface principal do módulo.
- public/modules/georeferenciamento/includes/functions.php: funções PHP para consulta dos dados.
- public/modules/georeferenciamento/api/votos_cidade.php: endpoint para dados de votos por cidade.
- public/modules/georeferenciamento/api/votos_mesorregiao.php: endpoint para dados de votos por mesorregião.
- Uso da biblioteca Leaflet via CDN para renderização do mapa.

UX:
- Spinner de carregamento.
- Legenda explicativa.
- Drill-down em mesorregiões.

Próximos passos:
- Criar includes/functions.php com consultas SQL.
- Criar endpoints API para fornecer dados JSON.
- Implementar mapa com Leaflet e integração com os dados.
- Implementar filtros e drill-down.