Documentação

Instalação

Para rodar o ProspectOS em ambiente de desenvolvimento você precisa de Ruby 3.4.5, PostgreSQL 14+ e Node.js 20+. O gerenciamento de gems usa RVM (gemset prospectos). Clone o repositório, copie .env.example para .env e preencha as variáveis obrigatórias antes de continuar.

Passos para subir localmente:

  • bin/setup — instala gems, cria e migra o banco.
  • bin/dev — inicia o servidor Rails, o compilador Tailwind e o worker de jobs em paralelo via Foreman.
  • Acesse http://localhost:3000 e crie a primeira conta pelo formulário de cadastro.

Para produção, o alvo de deploy é a plataforma Brasa PaaS (usebrasa.com.br). O scraper Python roda como serviço interno no tier Pro (2 GB de RAM). Consulte o arquivo docs/deploy-brasa.md no repositório para o passo-a-passo completo, incluindo configuração de variáveis de ambiente, banco de dados gerenciado e RAILS_SERVE_STATIC_FILES.