Job Board System (Rails Web App)

Status do Projeto: Em desenvolvimento ⚠️

Essa aplicação é uma plataforma Web de gestão de vagas de emprego e candidaturas. Ela permite que pessoas do RH de empresas criem e gerenciem as vagas de forma colaborativa. Além disso, a plataforma funciona como um site de busca empregos, no qual visitantes podem se cadastrar e se candidatar as vagas disponíveis.

O projeto foi contruído seguindo a prática do TDD, contando com testes unitários e de integração, e foi desenvolvido ao longo do programa TreinaDev, da Campus Code.

Conteúdo

1. Pré-requisitos
2. Dependências
3. Instalando a aplicação
4. Rodando a aplicação
5. Executando os Testes
6. API
7. Próximos Passos

---

Pré-requisitos

• Ruby 3.0.0
• Rails 6.1.1
• Node
• Yarn
• SQlite3

Verifique se tem esses requisitos buscando as versões no terminal:

ruby --version 

Dependências

• Devise 4.7.3
• Rspec_rails 4.0.2
• Capybara 3.34.0
• SimpleCov 0.12.2
• Factory_bot_rails 6.1.0
• Bootstrap 5.0.0.beta2
• Jquery-rails 4.4.0
• Faker 2.16.0
• Rubocop 1.11.0
• Rubocop-rails 2.9.1

Instalando a aplicação

1. Clone o repositório

Assumindo que tenha o git instalado na sua máquina:

git clone https://github.com/le-santos/job-board-system.git 

2. Instale as dependências

No diretório da aplicação, execute o Bundler para instalar as gems necessárias

bundle install 

3. Inicialize a DB e o schema.rb

rails db:create 
rails db:migrate 

4. Rode a aplicação

rails server 

Quando o servidor estiver no ar, a aplicação estará disponível no endereço: https://localhost:3000

Rodando a aplicação

Para testar a navegação e as interfaces com um usuário real, o arquivo seeds.rb inclui uma amostra de dados para popular o banco de dados. Carregue essa informações da seguinte forma:

# Para carregar os valores do db/seeds.rb com:
rails db:seed

# Ou caso precise apagar o banco antes
rails db:reset 

Dessa forma, podes navegar como Visitante ou logar como:

• Colaborador(admin): { email: [email protected], password: 123456 }
• Colaborador(staff): { email: [email protected], password: 123456 }
• Candidato: { email: [email protected], password: 123456 }

Executando os Testes

Para os testes foram utilizadas as gems Rspec e Capybara, além da FactoryBot para facilitar a criação de instâncias nos testes.

 # Rode todos os testes com: 
 rspec 

 # Ou usando o bundle exec: 
 bundle exec rspec 

Além dessas, foi incluída a gem SimpleCov para verificar a cobertura de testes da aplicação. Ao rodar os testes, será gerado um arquivo em coverage/index.html com os dados gerados pelo simpleCov.

Funcionalidades

A aplicação tem duas funcionalidades básicas:

• Gestão de vagas por pessoas do RH de uma empresa
• Busca de vagas por visitantes e candidatos

Usuário Colaborador:

☑️ O primeiro colaborador pode se cadastrar com um email corporativo e criar o perfil da empresa, sendo admin deste perfil

☑️ Todos os colaboradores que se cadastrarem com o email de mesmo domínio estarão associados a essa empresa

☑️ Todos os colaborares associados podem ver detalhes da empresa, criar vagas e visualizar candidaturas

☑️ Todos os colaboradores podem recusar ou aprovar candidaturas, enviando propostas aos candidatos

Usuário Visitante:

☑️ Pode visualizar as empresas e suas vagas

☑️ Pode se candidatar a alguma vaga, mediante cadastro

Usuário Candidato:

☑️ Pode criar e editar seu perfil

☑️ Pode vizualizar suas candidaturas enviadas

☑️ Pode vizualizar propostas recebidas, as quais pode aprovar ou recusar

Vagas:

☑️ Podem ser desativadas por um colaborador

☑️ São desativadas automaticamente após zerar a quantidade disponível ou quando a data expirar

API

A aplicação conta com um endpoint para acessar um json com a lista de vagas da plataforma.

Para testar, rode a aplicação com rails server e utilize o seguinte endpoint na sua máquina https://localhost:3000/v1/jobs.

// Exemplo de Response:
[
 {
  "id":1,
  "title":"Desenvolvedor(a) Backend Júnior",
  "details":"Desenvolvedor(a) para criação de aplicações web",
  "salary":3500,
  "level":"Júnior",
  "requirements":"Ruby on Rails, SQLite, HTML, CSS",
  "deadline":"24/12/2022",
  "quantity_of_positions":4,
  "company_id":6,
  "created_at":"2021-03-12T18:06:10.214Z",
  "updated_at":"2021-03-12T18:06:10.214Z",
  "status":"active"
 },
 {
  "id": 2,
  "title": "Desenvolvedor(a) Frontend Pleno",
  "details": "Desenvolvedor(a) React para desenvolvimento de aplicações web",
  "salary": 5000,
  "level": "Pleno",
  "requirements": "React, Javascript, HTML, CSS",
  "deadline": "24/12/2022",
  "quantity_of_positions": 4,
  "company_id": 1,
  "created_at": "2021-03-12T18:06:10.275Z",
  "updated_at": "2021-03-12T18:06:10.275Z",
  "status": "active"
 }
]

Próximos passos

O projeto já conta com todas as suas funcionalidades básicas. As próximas tarefas incluem:

• Completar a revisão do CSS e layout de todas as views
• Adicionar funcionalidade de busca por vagas
• Revisar formato dos formulários de cadastro
• Adicionar validação de dados como email e CPF
• Adicionar confirmação de cadastro