Integrantes do grupo:

• Eduardo P.P. Ferreira

Para dar inicio à contribuição, é necessário clonar o repositório:

git clone https://github.com/EdPPF/trainee2023-backEnd.git

Feito isso, rode bundle install para iniciar as gems do repositório (para mais informações, veja a seção de dependências deste projeto).

As contribuições neste projeto são feitas durante os sprints definidos de acordo com a metodologia ágil SCRUM.

Para contribuir durante um sprint, certifique-se de mudar para a branch do sprint atual, como por exemplo

git checkout sprint-Models

Sempre que quiser iniciar um novo trabalho neste repositório, abra um novo issue na seção issues no GitHub. Coloque seu nome no issue para marcá-lo como sua tarefa. Além disso, crie uma nova branch a partir da branch do sprint atual, como

git branch issueN069,

troque para ela em seu repositório local,

git checkout issueN069

e inicie seu trabalho.

Após finalizar as tarefas do issue, marque-o como finalizado no GitHub e, após dar seus commits na branch em que trabalhou, dê push:

git push issueN069

Dependendo do caso, talvez seja necessário abrir um pull request (PR) para dar merge de sua branch à outra branch do projeto.

No próprio GitHub, isso pode ser feito ao ir na aba Pull requests e clicar em New pull request, ou, na página inicial do repositório, mudando para a branch que quer dar merge e clicando em Contribute no menu contextual que aparecerá logo acima dos arquivos dessa branch.

Em qualquer caso, é importante selecionar a branch que será mesclada (no caso, a branch onde foi feito o trabalho) e a branch na qual será mesclada. Durante os sprints, todos os issues serão mesclados na branch do sprint. Ao final do sprint, e após revisão, essa branch será mesclada à main.

Aqui estão listados os passos tomados para configuração inicial das gems no início do repositório, após escrita delas no gemfile.

Figaro (database credentials):

bundle install
bundle exec figaro install

RSpec:

bundle install
rails generate rspec:install

Factory Bot:

bundle install, depois foi criada a pasta spec/support, onde foi criado o arquivo factory_bot.rb.

Panko Serializer:

bundle install, depois foi criada a pasta app/serializer. Nessa pasta, são criados os arquivos de serializer para cada model (nem todas as models precisam de serializer).

Devise:

bundle install
rails g devise:install

Simple Token Authentication:

bundle install

Em config > application.yml, descomente as duas últimas linhas (db_user e db_password) apenas se necessário (verificar vídeo "Trainee 2023/1 - Rails API Models", aos 12min).

Uma ferramenta que não é exataente uma gem mas se relaciona com o banco de dados é o Active Storage, instalado por meio dos comandos:

rails active_storage:install
rails db:migrate