Setup do ambiente local

TLDR: make setup configura o ambiente; os scripts em run/ sobem servidor, testes, lint e migrations.

Pré-requisitos

• Ruby na versão de .ruby-version
• PostgreSQL
• COMMONS_DIR exportado no shell — vem do setup de máquina da WeHive. Se o make reclamar, recarregue o shell com exec zsh. Em máquina nova, rode o setup da WeHive primeiro.

macOS com Postgres.app

Se você usa o Postgres.app, a gem pg precisa ser compilada apontando para o pg_config da versão instalada:

bash brew install libpq gem install pg -- --with-pg-config="/Applications/Postgres.app/Contents/Versions/15/bin/pg_config"

Ajuste o número da versão para a que você tem instalada.

Passos

1. Configurar o ambiente

bash make setup

Reconfigura .commons, .claude e .env. Rode de novo sempre que precisar reconciliar o ambiente.

2. Preparar o banco

bash bundle install rake db:create rake db:migrate

Ou, usando os scripts do projeto:

bash run/migrate run/seed

3. Subir a aplicação

bash run/server.dev

O script instala as gems sem o grupo production e sobe via overmind com o Procfile.dev. Se não houver Procfile.dev, cai para ./bin/rails server.

Para o worker de jobs:

bash run/worker

Scripts disponíveis

Alvos de make

Puxar dados de produção

O comando exclui os dados da tabela webhooks, que é grande demais:

bash heroku pg:pull DATABASE_URL ibft_api_development \ --app protected-ravine-77042 \ --exclude-table-data webhooks

Dados mínimos

O sistema precisa de pelo menos uma organização viva, com ID 1:

ruby Organization.create(name: 'IBFT', gateway: :asaas, gateway_token: '123456')

A criação de usuários admin está em operations.md.

Troubleshooting