Início Rápido
Coloque uma instância local do Mapas Culturais no ar em poucos minutos com Docker Compose.
Este guia mostra como clonar o repositório do RedeMapas e subir todos os serviços localmente. Toda a stack roda em Docker, sem necessidade de instalar dependências manualmente.
Pré-requisitos
Iniciando o ambiente local
git clone https://github.com/redemapas/mapas.git
cd mapasdocker compose up -dIsso inicia três serviços: a aplicação PHP, o PostgreSQL com PostGIS e o MailPit para captura de e-mails. As migrações do banco são executadas automaticamente na primeira inicialização pelo entrypoint do contêiner.
O contêiner da aplicação espera o PostgreSQL passar no health check antes de iniciar. Na primeira execução, o download das imagens e a execução das migrações podem levar um ou dois minutos.
Abra http://localhost:8080 no navegador.
O MailPit captura todos os e-mails enviados pela aplicação. Abra http://localhost:8025 para ver as mensagens capturadas. Isso é útil para testar fluxos de cadastro, redefinição de senha e notificações.
O banco fica exposto em localhost:5432. Conecte usando qualquer cliente PostgreSQL com as credenciais abaixo, ou use o script auxiliar dev/psql.sh.
| Parâmetro | Valor |
|---|---|
| Host | localhost |
| Porta | 5432 |
| Banco | mapas |
| Usuário | mapas |
| Senha | mapas-dev |
Serviços em resumo
| Serviço | URL | Descrição |
|---|---|---|
| Aplicação | http://localhost:8080 | Interface web principal |
| MailPit | http://localhost:8025 | Interface de captura de e-mails |
| PostgreSQL | localhost:5432 | Banco de dados (mapas / mapas-dev) |
Depois que a stack subir
Depois que os contêineres estiverem rodando, estes são os próximos guias de que você normalmente vai precisar:
- Docker Compose para HTTPS com Caddy, shell dentro do contêiner, PsySH, acesso ao PostgreSQL, restauração e rebuild de assets
- Testes para uso do PHPUnit, estrutura de testes, builders e directors
- Arquitetura para stack, fluxo de execução e organização do workspace
Se você estiver alterando o frontend, este costuma ser o próximo comando mais usado:
dev/pnpm.sh -C src run watchChecklist de verificação local
Depois de subir a stack ou mexer em infraestrutura, valide estes pontos antes de continuar:
http://localhost:8080carrega a aplicaçãohttps://mapas.localhost:8443funciona se você estiver testando PWA ou Web Push- o MailPit recebe mensagens em
http://localhost:8025 dev/psql.shconecta com sucesso e o bancomapasexiste- a suíte de testes inicia sem erros de ambiente
- os assets de frontend recompilam normalmente com
dev/pnpm.sh -C src run watch
Próximos passos
Funcionalidades
Entenda agentes, espaços, eventos, projetos e oportunidades.
Arquitetura
Entenda o framework PHP, o ORM, o sistema de hooks e a hierarquia de temas.
Temas e módulos
Personalize a plataforma criando temas e módulos de funcionalidade.
Deploy em produção
Faça deploy com Docker Compose ou Kubernetes usando o Helm chart incluído.
Esse material é fruto do Programa de Difusão Nacional - Funarte Redes das Artes, realizado pelo Laboratório do Futuro (entidade vinculada à Universidade Federal do Ceará) no ano de 2025.