Manual Mapas - Configuração

Variáveis de ambiente e opções de configuração de uma instalação Mapas Culturais.

O Mapas Culturais é configurado por variáveis de ambiente, lidas em tempo de execução, e por arquivos de configuração PHP no diretório config/. Overrides de desenvolvimento ficam em dev/config.d/.

Variáveis de ambiente

As variáveis abaixo controlam o comportamento da aplicação em runtime:

Banco de dados

Variável	Descrição	Exemplo
`DB_HOST`	Host do PostgreSQL	`postgres`
`DB_PORT`	Porta do PostgreSQL	`5432`
`DB_NAME`	Nome do banco	`mapas`
`DB_USER`	Usuário do banco	`mapas`
`DB_PASS`	Senha do banco	`secret`

Cache e sessões

Variável	Descrição	Exemplo
`REDIS_CACHE`	DSN do Redis para cache (vazio = fallback em APCu/filesystem)	`redis://redis:6379`
`SESSIONS_SAVE_PATH`	DSN do Redis para sessões PHP (vazio = filesystem)	`tcp://redis:6379`

Aplicação

Variável	Padrão	Descrição
`APP_DEBUG`	`false`	Ativa modo de depuração; logs em `var/logs/app.log`
`BASE_URL`	—	URL pública base, deve terminar com `/`
`DISABLE_SUBSITES`	`false`	Desativa suporte a subsites e multitenancy
`BUILD_ASSETS`	`0`	Compila assets do frontend na inicialização do contêiner
`NUM_PROCESSES`	`2`	Quantidade de processos PHP
`JOBS_INTERVAL`	`60`	Intervalo do executor de jobs em segundo

Mailer

Variável	Descrição	Exemplo
`MAILER_TRANSPORT`	DSN do Symfony Mailer	`smtp://mailpit:1025`
`MAILER_FROM`	Endereço remetente	`noreply@mapas.example.com`

Transportes suportados: smtp://, ses+smtp:// (Amazon SES), mailgun+smtp://, sendgrid+smtp:// e mailchimp+mandrill+smtp://.

reCAPTCHA

Variável	Descrição
`GOOGLE_RECAPTCHA_SITEKEY`	Chave pública do Google reCAPTCHA v2
`GOOGLE_RECAPTCHA_SECRET`	Chave secreta do Google reCAPTCHA v2

Web Push (RedeMapas)

Variável	Descrição
`VAPID_SUBJECT`	Subject do VAPID (`mailto:` ou URL)
`VAPID_PUBLIC_KEY`	Chave pública VAPID
`VAPID_PRIVATE_KEY`	Chave privada VAPID

Provedor de autenticação

Defina o provedor de autenticação no arquivo de configuração:

return [
    'auth.provider' => 'OpauthLoginCidadao',
    'auth.config' => [
        'client_id'          => 'YOUR_CLIENT_ID',
        'client_secret'      => 'YOUR_CLIENT_SECRET',
        'auth_endpoint'      => 'https://id.cultura.gov.br/oauth/v2/auth',
        'token_endpoint'     => 'https://id.cultura.gov.br/oauth/v2/token',
        'user_info_endpoint' => 'https://id.cultura.gov.br/api/v1/person.json',
        'timeout'            => '24 hours',
    ],
];

Veja Provedores de autenticação para a lista completa.

Habilitando módulos

Registre os módulos no arquivo de configuração:

return [
    'plugins' => [
        'Opportunities'            => ['namespace' => 'Opportunities'],
        'OpportunityPhases'        => ['namespace' => 'OpportunityPhases'],
        'EvaluationMethodSimple'   => ['namespace' => 'EvaluationMethodSimple'],
        'Notifications'            => ['namespace' => 'Notifications'],
        'MailNotification'         => ['namespace' => 'MailNotification'],
        'Seals'                    => ['namespace' => 'Seals'],
        'LGPD'                     => ['namespace' => 'LGPD'],
        'Reports'                  => ['namespace' => 'Reports'],
        'GeoDivisions'             => ['namespace' => 'GeoDivisions'],
    ],
];

Consulte Módulos para ver todos os módulos disponíveis.

Multitenancy e subsites

Para habilitar múltiplas subinstalações no mesmo servidor, garanta que DISABLE_SUBSITES não esteja definido, ou esteja como false. Cada subsite é associado a um domínio e usa um namespace de tema separado.

O suporte a subsites vem desativado por padrão no ambiente de desenvolvimento (DISABLE_SUBSITES=true em compose.yaml).

Modo debug

Ative o modo debug para obter páginas de erro detalhadas e logs mais verbosos:

APP_DEBUG=true

Os logs são gravados em var/logs/app.log dentro do contêiner.

Migrações do banco

As migrações ficam em src/db-updates.php e são aplicadas automaticamente quando o contêiner inicia. Nenhuma etapa manual é necessária. Para aplicar atualizações manualmente:

docker compose exec mapas php /var/www/src/tools/apply-updates.php

Notas operacionais específicas do RedeMapas

A instalação RedeMapas acrescenta algumas preocupações que passam fácil despercebidas se você ler a configuração como se fosse um deploy genérico do Mapas:

HTTPS é praticamente obrigatório para testar de forma realista PWA e Web Push
o comportamento de autenticação pode depender de endpoints do Ministério da Cultura ou de provedores hospedados pela própria instalação
o tema ativo da instalação pode introduzir comportamento sensível ao ambiente, como fluxo customizado de logout, manifestos e assinatura de push

Durante o debugging, trate configuração, comportamento de tema e topologia de deploy como uma única unidade operacional.

Manual Rede das Artes

Configuração