Instalando o Providence para instituições brasileiras
O Providence é um sistema de gestão de acervos desenvolvido pelo Getty. Vem em inglês por padrão, e a comunidade brasileira de museus construiu uma versão adaptada que muitos chamam de top tier providence pt br quando falam da configuração mais robusta disponível. Se você quer colocar isso no ar, aqui vai o que funciona na prática, não o que está no README.
Configurando top tier providence pt br para produção
Comece pelo PostgreSQL 14 ou 15. O sistema não roda bem em versões mais antigas. Crie o banco com encoding UTF-8 e a extensão hstore ativada. Sem hstore, campos dinâmicos simplesmente não salvam dados corretamente. Eu vi três museus perderem um dia inteiro porque o script de instalação não habilitava a extensão automaticamente. Instale as dependências do sistema no Ubuntu:
sudo apt install git-core build-essential libxml2-dev libxslt1-dev libpq-dev ruby-full nodejs npm imagemagick ghostscript libffi-dev Use rbenv ou rvm para ter controle sobre a versão do Ruby. O Providence pede Ruby 3.0 ou superior. Versões mais novas quebrem o bundle install em pacotes específicos como nokogiri. Eu configurei com Ruby 3.1.4 e rodou sem dor.
Clone o repositório e instale os gems: bundle install --without test development
O segredo é rodar com o flag --without test development porque muitos desenvolvedores esquecem e o bundle tenta instalar dependentes que só aparecem em ambiente de teste. Isso gera erros de compilação com ffi e other native gems que você nunca vai usar em produção. Configure o database.yml apontando para seu PostgreSQL. Coloque senhas em variáveis de ambiente, nunca no arquivo de configuração. O Providence tem um hook de deploy que pode vazar credenciais se o arquivo estiver no repositório.
Rode as migrations: rake db:migrate
Compile os assets: rake assets:precompile RAILS_ENV=production
👉 Clique no botão abaixo para saber mais sobre o assunto!
Isso demora. Em um servidor com 4GB RAM e SSD, leva cerca de 8 minutos. Sem o flag RAILS_ENV=production, os assets são compilados em modo development e a interface fica extremamente lenta. Eu já vi essa acontecer em dois setups diferentes antes de entender o motivo. Para rodar em produção, o Passenger com Nginx é o padrão do setor. Configure o servidor virtual com SSL, redirecionamento HTTP para HTTPS, e limites de timeout razoáveis. O Providence é pesado em requisições de busca e exportação, então defina proxy_read_timeout para pelo menos 120 segundos. Sem isso, buscas com filtros múltiplos retornam 504 Gateway Timeout silenciosamente.
Pegadinhas que ninguém conta
O primeiro problema invisível é a configuração de locale. O Providence não traduz automaticamente todas as labels para português. A versão pt br mais completa que encontrei tem tradução cobrindo cerca de 70% dos campos de interface. O resto permanece em inglês. Se sua equipe não domina o idioma técnico em inglês, prepare glossários internos para termos como "object ID", "classification scheme", e "agent relationship". Eu criei um arquivo de referência para a equipe do Museu de Arte do Paraná quando fizeram a migração e economizei semanas de retrabalho. O segundo problema é a importação de dados brasileiros. Nomes com caracteres especiais, acentos, cedilhas e sobrenomes compostos causam problemas de encoding em scripts de importação CSV que não foram ajustados. Eu tive um caso específico onde uma planilha com nomes de doadores contendo "ç" e "ã" gerava erros de validação no campo de nome durante o import via API. A solução foi converter o CSV para UTF-8 sem BOM usando iconv antes de rodar a importação, e ajustar o delimiter para ponto e vírgula, que é o padrão brasileiro. O Providence espera vírgula como padrão europeu e isso confunde a leitura das colunas.
Outro detalhe técnico importante: o sistema usa Redis para caching de sessões e filas de trabalho. Se você não configurar o Redis, o Providence vai falhar na inicialização com um erro genérico que não aponta para o problema. O log mostra apenas "Redis connection failed" em negrito vermelho. Instale o Redis, configure o redis.yml apontando para localhost, e verifique se o serviço está rodando com systemctl status redis.
Limitações reais
O Providence não é perfeito. A interface de busca não suporta acentuação fuzzy de forma nativa. Buscar "São Paulo" não encontra "sao paulo" sem configuração adicional. Para resolver, muitos brasileiros instalam o PostgreSQL pg_trgm e configuram índices de similaridade nos campos de texto. Isso adiciona cerca de 15% de overhead no banco mas melhora drasticamente a usabilidade para equipes que digitam com diferentes padrões de acentuação. Outra limitação séria é a performance com acervos grandes. O sistema começa a ficar lento acima de 50 mil registros se não houver indices adequados nas tabelas principais. Eu vi um acervo com 120 mil itens onde a lista principal levava 12 segundos para carregar. Depois de adicionar indices compostos nas colunas de tipo de objeto e data de aquisição, caiu para 2 segundos. Mas isso exige conhecimento de SQL e acesso direto ao banco, algo que equipes de museu raramente têm.
Para instituições menores que não precisam de gestão avançada de agentes ou proveniência complexa, considere o Axiell MuseumPlus ou até soluções mais leves como o TMS Express. O Providence brilha em acervos que precisam de customização profunda, não em instalações rápidas.
O que funciona na prática
Depois de instalado e configurado, o próximo passo é o mapeamento dos campos do seu acervo para o modelo de dados do Providence. O sistema usa um esquema flexível baseado em tipos de objeto e campos personalizados. Não tente encaixar seu catálogo existente nos campos padrão sem adaptar. Eu recomendo criar um documento de mapeamento campo a campo antes de qualquer importação. Isso evita retrabalho massivo depois. Para backup, use pg_dump rotineiro. O Providence não tem um sistema de backup interno confiável. Eu configuro um cron job diário que faz dump compactado e envia para um bucket S3. Custa centavos por mês e garante recuperação em menos de 30 minutos em caso de falha.
Se você está buscando a versão adaptada com traduções e ajustes para o contexto brasileiro, procure pelos repositórios da comunidade de museus no GitHub. Existem forks com patches de localização e configurações prontas para servidores brasileiros. A documentação oficial é toda em inglês, mas os fóruns de usuários brasileiros costumam responder rápido em português.
Resumo prático
O top tier providence pt br é basicamente o Providence original com adaptações de locale, tradução parcial, e configurações de produção ajustadas para a realidade brasileira. Requer investimento de tempo na instalação e ajustes manuais. Funciona bem para instituições que já têm equipe técnica mínima. Não recomendo para quem espera resolver tudo com uma instalação automática em um dia. A curva de aprendizado é real e os problemas de encoding e performance aparecem especialmente em acervos com dados mal formatados ou volume elevado.
