CAMAAR

Projeto desenvolvido em Ruby on Rails para a disciplina de Engenharia de Software.

Tecnologias utilizadas

• Ruby 3.2.10
• Ruby on Rails 8.1.3
• SQLite3
• Puma
• Capybara
• Selenium WebDriver

Pré-requisitos

Antes de rodar o projeto, verifique se você possui instalado:

• Ruby
• Rails
• Bundler
• SQLite3
• Git

Para verificar as versões instaladas, execute:

ruby --version
rails --version
bundle --version
sqlite3 --version
git --version

Clonando o projeto

Clone o repositório:

git clone https://github.com/SEU-USUARIO/SEU-REPOSITORIO.git

Entre na pasta do projeto:

cd SEU-REPOSITORIO

Substitua SEU-USUARIO e SEU-REPOSITORIO pelos dados corretos do repositório.

Instalando as dependências

Na raiz do projeto, execute:

bundle install

Esse comando instala todas as gems necessárias declaradas no arquivo Gemfile.

Preparando o banco de dados

Como o projeto utiliza SQLite, execute:

bin/rails db:prepare

No Windows, caso o comando acima não funcione, use:

ruby bin\rails db:prepare

Esse comando cria o banco de dados, executa as migrations e prepara o ambiente de desenvolvimento.

Rodando o servidor

Para iniciar o servidor Rails, execute:

bin/rails server

No Windows, recomenda-se usar:

ruby bin\rails server

ou:

bundle exec rails server

Depois acesse no navegador:

http://localhost:3000

Se a página inicial do Rails aparecer, o projeto está rodando corretamente.

Observação para usuários Windows

Caso o servidor inicie e depois caia com um erro parecido com:

No such file or directory - bin/rails

abra o arquivo:

config/puma.rb

e comente a linha:

plugin :tmp_restart

deixando assim:

# plugin :tmp_restart

Depois tente iniciar o servidor novamente:

ruby bin\rails server

Avisos relacionados ao VIPS

Em alguns ambientes Windows, podem aparecer avisos semelhantes a:

VIPS-WARNING unable to load ...

Esses avisos estão relacionados ao processamento de imagens e, em geral, não impedem a aplicação Rails de iniciar. Caso o projeto ainda não utilize upload ou manipulação de imagens, eles podem ser ignorados inicialmente.

Testes

Para rodar os testes padrão do Rails:

bin/rails test

No Windows:

ruby bin\rails test

O projeto também possui suporte a testes com Capybara e Selenium WebDriver.

Estrutura básica do projeto

app/        # Código principal da aplicação
config/     # Configurações do Rails
db/         # Banco de dados e migrations
test/       # Testes automatizados
public/     # Arquivos públicos
Gemfile     # Dependências do projeto

Comandos úteis

Instalar dependências:

bundle install

Preparar banco de dados:

ruby bin\rails db:prepare

Rodar servidor:

ruby bin\rails server

Rodar testes:

ruby bin\rails test

Ver rotas disponíveis:

ruby bin\rails routes

Abrir console Rails:

ruby bin\rails console

Status do projeto

Projeto em desenvolvimento.