Em julho de 2013, agentes culturais de vários países da América Latina e do Brasil se reuniram para discutir a criação de uma ferramenta de mapeamento de iniciativas culturais e gestão cultural. Desse encontro surgiram as bases para a criação de Mapas Culturais, um software livre que permite o aprimoramento da gestão cultural dos municípios e estados.
Mapas Culturais é uma plataforma colaborativa que reúne informações sobre agentes, espaços, eventos e projetos culturais, fornecendo ao poder público uma radiografia da área de cultura e ao cidadão um mapa de espaços e eventos culturais da região. A plataforma está alinhada ao Sistema Nacional de Informação e Indicadores Culturais do Ministério da Cultura (SNIIC) e contribui para a realização de alguns dos objetivos do Plano Nacional de Cultura.
A plataforma já está em uso em diversos municipios, estados, no governo federal em diversos projetos do ministério da cultura e até mesmo fora do Brasil no Uruguai. Instalações recentes:
Instalações
- IberculturaViva - https://mapa.iberculturaviva.org/
- Mapa Uruguai - http://culturaenlinea.uy/
- SNIIC - http://mapas.cultura.gov.br/
- Museus - http://museus.cultura.gov.br/
- Sistema Nacional de Bibliotecas Públicas - http://bibliotecas.cultura.gov.br/
- Cultura Viva - http://culturaviva.gov.br/
- Pontos de Memória - http://pontosdememoria.cultura.gov.br/
- Distrito Federal - http://mapa.cultura.df.gov.br/
- Ceará - https://mapacultural.secult.ce.gov.br/
- Espírito Santo - https://mapa.cultura.es.gov.br/
- Goiás - https://mapagoiano.cultura.go.gov.br/
- Maranhão - http://ma.mapas.cultura.gov.br/
- Mato Grosso - https://mapas.mt.gov.br/
- Mato Grosso do Sul - https://www.mapacultural.ms.gov.br/
- Pará - https://mapacultural.pa.gov.br/
- Paraíba - http://pb.mapas.cultura.gov.br/
- Pernambuco - https://www.mapacultural.pe.gov.br/
- Sergipe - http://mapas.cultura.se.gov.br/
- Tocantins - http://mapa.cultura.to.gov.br/
- Ilheus - http://ilheus.ba.mapas.cultura.gov.br/
- Camaçari - https://mapacultural.camacari.ba.gov.br/
- Senhor do Bonfim - http://senhordobonfim.ba.mapas.cultura.gov.br/
- Chorozinho - https://mapacultural.chorozinho.ce.gov.br/
- Sobral - https://cultura.sobral.ce.gov.br/
- Juazeiro do Norte - https://mapacultural.juazeiro.ce.gov.br/
- Belo Horizonte - http://mapaculturalbh.pbh.gov.br/
- Santa Luzia - http://mapacultural.santaluzia.mg.gov.br/
- Ipatinga - http://mapacultural.ipatinga.mg.gov.br/
- Varzea Grande - http://varzeagrande.mt.mapas.cultura.gov.br/
- João Pessoa - http://jpcultura.joaopessoa.pb.gov.br/
- Londrina - https://londrinacultura.londrina.pr.gov.br/
- Foz do Iguaçu - http://mapadaculturafoz.pmfi.pr.gov.br/
- Maringa - http://maringacultura.maringa.pr.gov.br:38081/
- Rio das Ostras - http://mapadacultura.riodasostras.rj.gov.br/
- Laguna - http://laguna.sc.mapas.cultura.gov.br/
- Novo Hamburgo - http://mapacultural.novohamburgo.rs.gov.br/
- Rio Grande - http://mapacultural.riogrande.rs.gov.br/
- São Paulo - http://spcultura.prefeitura.sp.gov.br/
- Santo André - http://culturaz.santoandre.sp.gov.br/
- São Caetano do Sul - http://mapacultural.saocaetanodosul.sp.gov.br/
- Osasco - http://osasco.sp.mapas.cultura.gov.br/
- Franco da Rocha - http://francodarocha.sp.mapas.cultura.gov.br/
- Guaruja - http://mapadacultura.guaruja.sp.gov.br/
- Varzea Paulista - http://janelacultural.varzeapaulista.sp.gov.br/
- Itu - http://mapacultural.itu.sp.gov.br/
- Guarulhos - http://grucultura.guarulhos.sp.gov.br/
- Itapetininga - http://mapacultural.itapetininga.sp.gov.br/
Mapas Culturais é uma aplicação web server-side baseada em linguagem PHP e banco de dados Postgres, entre outras tecnologias e componentes, que propicia um ambiente virtual para mapeamento, divulgação e gestão de ativos culturais.
- Mapas Cuturais Base Project - Repositório de projeto base para novas instalações.
- Multiple Local Auth - Plugin de autenticação local + oauth.
- Mapas SDK
- Mapas Culturais APP
- Cultural Magazine Theme
A maneira mais simples e segura para instalar o Mapas Culturais é utilizando o Mapas Culturais Base Project como base para a criação de um repositório próprio para o seu projeto, que reunirá o tema, os plugins e as configurações da aplicação. O Mapas Culturais Base Project utiliza o Docker e o Docker Composer para rodar a aplicação, facilitando os processos de deploy e de atualizaçao.
- Instalação utilizando o Base Project - RECOMENDADO
Documentação
Uma nova documentação está sendo escrita no gitbook, organizada em três seções:
A documentação pode ser navegada no endereço (http://docs.mapasculturais.org)
Toda documentação da aplicação está na pasta documentation. Principais referências:
- API
- API - exemplos
- Guia do desenvolvedor
- Como contribuir
- Desenvolver um novo tema
- Importação de arquivos de dados geoespaciais (Shapefiles)
- Deploy diretamente no sistema operacional - NÃO RECOMENDADO
- Habilitar um novo tema
Lista dos principais softwares que compõe e aplicação. Maiores detalhes, ver documentação de instalação ou guia do desenvolvedor.
- Ubuntu Server >= 18.04 ou Debian Server >= 10
- PHP = 7.2
- Composer
- PostgreSQL >= 10
- Postgis >= 2.2
- Node.JS >= 8.x
- Ruby
Para instalações de pequeno/medio porte nas quais o número de entidades, isto é, número de agentes, espaços, projetos e evento,giram em torno de 2000 ativos, recomenda-se o mínimo de recursos para um servidor (aplicação + base de dados):
- 2 cores de CPU;
- 2gb de RAM;
- 50mbit de rede;
Desejável:
- 4 cores de CPU;
- 4gb de RAM;
- 100mbit de rede;
Para instalações em cidades de grande porte onde o número de entidades, isto é, número de agentes, espaços, projetos e evento, giram em torno de dezenas de milhares de ativos de cada, recomenda-se o mínimo de recursos para um servidor:
- 4 cores de CPU
- 4gb de RAM
- 100mbit de rede
Recomendado:
- 8 cores de CPU
- 8gb de RAM
- 500mbit de rede
Vale lembrar que os requisitos de hardware podem variar de acordo com a latência da rede, velocidade dos cores dos cpus, uso de proxies, entre outros fatores. Recomendamos aos sysadmin da rede em que a aplicação será instalada um monitoramento de tráfego e uso durante o período de 6 meses a 1 ano para avaliação de cenário de uso.
Encorajamos a comunidade a colaborar conosco criando issues para relatar problemas, sugerir melhorias ou novas funcionalidades. Ao reportar uma issue, você está ajudando a equipe de desenvolvimento a entender as necessidades dos usuários e aprimorar o sistema. Quanto mais detalhada for a sua issue, mais eficaz será a nossa resposta e resolução do problema. Seja parte do nosso esforço para tornar o Mapa Cultural uma ferramenta cada vez melhor para todos!
- Algo não está funcionando como esperado? Você encontrou uma falha ou bug no mapas?
- Você tem uma ideia ou sugestão e quer compartilhar?
É importante ressaltar que para contribuir com o código é necessário ter instalado o docker, docker-compose, node e pnpm.
Para contribuir, será necessário fazer um clone desse repositório, depois disso basta executar o comando ./dev/start.sh e o site deve ficar disponível na porta 4242 do host.
As alterações precisam ser sugeridas através de um Pull Request e deve conter detalhes das alterações, conforme descrito no temaplate.
Adotamos a utilização de 4 branches:
main: código de produçãodevelop: código de estável de desenvolvimentofeature/*: código de novas funcionalidadesfix/*: código de novas correções
Adotamos a utilização de 3 travas de segurança automatizadas:
- verificação de estilo de escrita de código
- verificação de testes unitários backend
- verificação de testes de integração frontend
Adotamos o uso de múltiplos ambientes de publicação:
- ao atualizar a branch
mainatualizamos o mapas.tec.br - ao atualizar a branch
developatualizamos o experimente.mapas.tec.br - ao abrir um PR no github criamos uma nova instalação em
pr-#.mapas.tec.br
- Telegram:
Mapas Culturais é um software livre licenciado com GPLv3.