O projeto Cacicadas Digitais na Resex Tapajós-Arapiuns, contemnplado no Edital Mover-se na Web, é integrante de uma iniciativa mais ampla que visa promover a soberania digital, a Economia Digital Solidária e fortalecer a governança comunitária nas comunidades ribeirinhas e indígenas da Amazônia.
A proposta visa o desenvolvimento de uma solução digital completa de monitoramento de território que será composta por um aplicativo de coleta de dados offline, pela integração desses dados com a plataforma Cacicadas Digitais, e a personalização do Mapas Culturais para atuar como uma ferramenta central de armazenamento e gestão de informações, permitirá que as comunidades gerenciem seus territórios de maneira eficiente e integrada.
A plataforma livre Cacicadas Digitais tem como objetivo confluir pessoas e organizações do territórios da Resex Tapajós-Arapiuns. Nela serão reunidos dados e informações com o foco na governança territorial baseada nos nossos saberes na floresta. A plataforma também irá contribuír para o Sistema Nacional de Unidades de Conservação, para a defesa do colonialismo de dados e para o cuidado do que é mais importante: a Floresta.
Este repositório é uma adaptação direta do Mapas Culturais Base Project, contendo configurações, estrutura e scripts necessários para rodar o projeto Em Cena.
Repositório: 👉 https://github.com/hacklabr/mapas-CacicadasDigitais/
Esta instalação utiliza:
- Mapas Culturais (core)
- Docker e Docker Compose
- PHP
- PostgreSQL + PostGIS
- Nginx
- Redis
A organização do repositório, bem como os scripts de automação, seguem o padrão definido pelo Mapas Culturais Base Project.
Os principais arquivos e diretórios da instalação são:
- .env_sample – Modelo para criação do arquivo
.env - start.sh – Inicializa o ambiente de produção/homologação
- restart.sh – Reinicializa o ambiente de produção/homologação
- stop.sh – Desliga o ambiente de produção/homologação
- update.sh – Atualiza o ambiente de produção
- logs.sh – Exibe os logs do docker-compose
- bash.sh – Acessa o terminal do container do Mapas Culturais
- psql.sh – Acessa o console do PostgreSQL
- init-letsencrypt.sh – Auxilia na criação do certificado Let's Encrypt
- docker-compose.yml – Definição dos serviços do ambiente de produção/homologação
- docker-compose-certbot.yml – Serviços usados para geração de certificado SSL
- docker/ – Arquivos de configuração do Docker
- common/ – Configurações comuns
- db/ – Dump padrão do banco de dados
- production/ – Configurações exclusivas de produção
- dev/ – Scripts e configurações para desenvolvimento local
- start.sh – Sobe o ambiente de desenvolvimento
- bash.sh – Acessa o container da aplicação
- shell.sh – Acessa o shell do Mapas Culturais
- psql.sh – Acessa o banco de dados
- docker-compose.local.yml – Docker Compose do ambiente local
- watch.sh – Compilação de assets do tema
- plugins/ – Plugins utilizados no projeto Em Cena
- themes/ – Temas utilizados no projeto Em Cena
- Git
- Docker
- Docker Compose
- Linux ou macOS
Para subir o ambiente de desenvolvimento, execute:
cd dev
sudo ./start.shApós a inicialização, acesse no navegador:
Para parar o ambiente, utilize:
Ctrl + C
O banco inicial inclui um usuário com permissão total:
- E-mail:
Admin@local - Senha:
mapas123
⚠️ Usuário destinado apenas a ambientes de desenvolvimento.
O ambiente de desenvolvimento inclui o MailHog, disponível em:
Os temas utilizados pelo Em Cena estão localizados em:
themes/
A ativação do tema é feita por meio dos arquivos de configuração do Mapas Culturais, tanto para desenvolvimento quanto para produção.
Os plugins utilizados pelo Em Cena estão localizados em:
plugins/
A habilitação dos plugins é feita por meio do arquivo de configuração correspondente no diretório docker/common.
⚠️ Este resumo não substitui a documentação completa do Mapas Culturais Base Project.
Passos principais:
- Clonar o repositório no servidor
- Criar o arquivo
.enva partir do.env_sample - (Opcional) Configurar certificado SSL com Let's Encrypt
- Subir o ambiente com:
sudo ./start.shPara atualizar o ambiente de produção, execute:
sudo ./update.shEsse script realiza:
- Pull da imagem do Mapas Culturais
- Build da imagem do projeto
- Reinicialização do docker-compose
O backup deve ser realizado manualmente ou automatizado externamente, utilizando os comandos e diretórios abaixo.
O banco de dados PostgreSQL pode ser exportado diretamente a partir do container Docker com o comando:
docker compose exec db pg_dump -U mapas mapas > backup.sqlEsse comando gera um dump completo do banco de dados da aplicação.
💡 É recomendável compactar o arquivo gerado e armazená-lo em local seguro.
Além do banco de dados, é necessário realizar backup dos arquivos persistentes localizados no diretório:
docker-data/
Esse diretório contém, entre outros:
- arquivos enviados pelos usuários
- arquivos privados da aplicação
- logs
- certificados (quando aplicável)
O backup pode ser feito copiando o diretório inteiro, por exemplo:
cp -r docker-data /caminho/para/backups/docker-data- Plataforma baseada no Mapas Culturais
- Estrutura técnica derivada do Mapas Culturais Base Project
- Projeto Cacicadas Digitais, sobrerania digital popular de pessoas e organizações dos territórios da Resex Tapajós-Arapiuns.
