Uma plataforma livre de mapeamento e gestão cultural usada por municípios, estados e o governo federal brasileiro.

Mapas Culturais é uma plataforma livre de mapeamento e gestão cultural. Usada por centenas de municípios brasileiros, governos estaduais e instituições federais, ela reúne agentes culturais, espaços, eventos e projetos em um único ambiente colaborativo, apoiando a jornada completa do fomento cultural, do cadastro à prestação de contas final.

A plataforma é mantida por uma rede comunitária de desenvolvedores e gestores públicos, e busca reconhecimento como Software Público pelo governo brasileiro e como Digital Public Good pelas Nações Unidas.

O que o Mapas Culturais faz

O Mapas Culturais oferece um ambiente web para mapear, publicar e gerenciar ativos culturais. Suas entidades centrais são:

• Agentes: indivíduos, coletivos e organizações com dados de perfil e geolocalização
• Espaços: teatros, museus, centros culturais e outros locais
• Eventos: atividades agendadas, com recorrência e referência geográfica
• Projetos: iniciativas culturais agrupadas, com fases e participantes
• Oportunidades / editais: chamadas públicas com fluxos de avaliação em múltiplas fases
• Inscrições: candidaturas ligadas a oportunidades, acompanhadas por todo o ciclo de avaliação

Juntas, essas entidades implementam a Jornada Completa do Fomento Cultural: do primeiro cadastro de um agente na plataforma ao envio para um edital, avaliação, seleção, acompanhamento e prestação de contas.

Visão geral da arquitetura

O Mapas Culturais é uma aplicação PHP server-side construída sobre Slim, Doctrine, PostgreSQL/PostGIS e um sistema modular de temas e módulos. Na prática, o código se divide entre o núcleo do framework, módulos de funcionalidade, temas de instalação e camadas de deploy e configuração.

Para ver a stack completa, a organização de diretórios, os fluxos de execução e as abstrações centrais, consulte o guia canônico de Arquitetura.

Estrutura de branches

O repositório do RedeMapas mantém duas linhas paralelas de desenvolvimento:

Ao contribuir, identifique a qual linha sua alteração pertence e abra o pull request contra develop ou develop-minc. Use o sufixo -minc no nome da branch, como feat/algo-minc, para trabalho voltado à linha MinC.

RedeMapas na prática

A instalação de referência documentada aqui não é um ambiente genérico de "Mapas puro". Ela corresponde à linha RedeMapas / Rede das Artes, que combina:

• o núcleo do Mapas Culturais
• um tema dedicado RedeMapas em src/themes/
• convenções de deploy com Docker Compose e Kubernetes
• preocupações de produção como subsites, Web Push e fluxos de autenticação compatíveis com o MinC

Essa distinção importa ao ler ou alterar o código. Parte do comportamento fica no núcleo do framework, parte em módulos e parte apenas no tema ativo da instalação.

Modelo de contribuição

Ao iniciar uma alteração, responda primeiro a estas perguntas:

1. Isso é uma mudança de framework/core que deve subir para o upstream?
2. Isso é uma preocupação da instalação RedeMapas e deve ficar no tema local ou na configuração?
3. Isso é específico da linha comunitária (develop) ou da linha MinC (develop-minc)?

Como regra prática:

• melhorias de framework e de plataforma reaproveitáveis devem mirar a linha upstream adequada
• comportamento de UI e integrações específicos da instalação devem permanecer no tema do RedeMapas ou na configuração de deploy
• o nome da branch deve deixar o alvo explícito, especialmente em trabalho para o MinC

Fluxo de desenvolvimento

No trabalho do dia a dia, mantenha as responsabilidades divididas assim:

• use Início Rápido para setup local e checagens da primeira execução
• use Arquitetura para stack, fluxo de requisição e abstrações centrais
• use Docker Compose para operações com contêineres e HTTPS local
• use Testes para o fluxo com PHPUnit

Instalações ativas

O Mapas Culturais está implantado em dezenas de instalações brasileiras e internacionais:

Federal / internacional

• SNIIC — Sistema Nacional de Informações e Indicadores Culturais
• Cultura Viva — programa federal dos pontos de cultura
• Rede das Artes — Ministério da Cultura platform
• IberculturaViva — rede ibero-americana de cultura comunitária
• Mapa Uruguai — mapa cultural nacional do Uruguai

Instalações estaduais (seleção)

Amapá, Ceará, Espírito Santo, Goiás, Maranhão, Mato Grosso, Pará, Pernambuco, Paraíba, Piauí, Tocantins e mais de vinte outras.

Licença

O Mapas Culturais é distribuído sob a licença AGPL-3.0. O código-fonte está disponível em github.com/redemapas/mapas. Contribuições são bem-vindas. Veja o guia de contribuição para mais detalhes.