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 deploy é na plataforma Jataí: todo push na branch main publica automaticamente, e as migrations rodam na release phase. A raspagem do Google Maps roda localmente — o Google bloqueia o IP do servidor — e os leads chegam à produção pela API. 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.