Desafio Back-end 🖥️

Olá! 👋 Este é o primeiro contato com um pouco da nossa realidade. Nele você vai conhecer alguns dos problemas que resolvemos.

Introdução

O nosso desafio consiste dos seguintes entregáveis:

refatoração do código de criação de conta, que está complexo
criação de testes unitários para os trechos de código que estão sem cobertura
criação de uma nova funcionalidade

Para entregar o desafio, faça um clone desse repositório, e nos envie por e-mail o link dele.

Dicas:

não pule a leitura desse README, algo muito importante no nosso dia-a-dia é a atenção, ler código, documentação, tarefas, etc. Sair fazendo na maioria das vezes, acaba causando mais problemas, do que soluções. Portanto, pegue um café/bebida de sua preferência e vá com calma :)
ficou em dúvida sobre algum ponto? Só nos mandar um e-mail
procure quebrar os entregáveis em pequenas tarefas, para evitar uma eventual "Analysis paralysis"
dê uma olhada no nosso Playbook, lá explicamos "nosso jeito" de desenvolver
ao entregar o desafio, fique livre para adicionar neste README.md ou criar algum outro markdown para complementar algo sobre o desafio (isso é totalmente opcional)

API

Registration

POST /api/v1/registrations

Body

{ 
  "account": {
    "name": "Teste",
    "from_partner": true,
    "many_partners": true,
    "users": [
      {
        "email": "someone@example.com",
        "first_name": "Example",
        "last_name": "Fintera User",
        "phone": "62999999999"
      }
    ]
  }
}

Response

Success

{
  "message": "Registro realizado com sucesso"
}

Error

{
  "error": "Name can't be blank"
}

Registration Params

Param	Type	Description
name	string(required)	Nome da conta a ser criada
from_partner	boolean	Identifica se a conta é de um parseiro nosso
many_partners	boolean	Identifica se a conta esta vinculada a vários parseiros nossos
users	array(required)	Array de usuários associados à esta conta

User Params

Param	Type	Description
email	string	E-mail do usuário
first_email	string	Primeiro nome do usuário
last_name	string	Sobrenome do usuário
phone	string	Telefone do usuário

Entregáveis

Refatoração do código de criação de conta. De acordo com o seu conhecimento, avalie o código e realize uma refatoração com o objetivo de diminuir a complexidade atual
Deixamos alguns trechos do código sem cobertura, cabe a você descobrir quais pontos são e adicionar os novos testes
Criação de uma nova funcionalidade:
- Hoje a criação de uma conta, também inclui o cadastros dos usuários, desta forma UMA conta pode ter N usuários, e UM usuário pertence a UMA conta. Porém um novo requisito chegou: alguns dos nossos clientes têm mais de uma empresa, e precisam que os seus usuários possam acessar diferentes empresas. Portanto, precisamos ter um cadastro único de usuários, e que esses usuários estejam relacionados as empresas (chamadas de entities), e não mais a conta em si (diagrama de como é esperado ficar está abaixo).
- O corpo do endpoint de registro precisará ser alterado para suportar esta funcionalidade.
- Lembre-se de ajustar os testes para cobrir a nova funcionalidade

Entregável extra

Deixamos na aplicação vários pontos que podem ser refatorados, se identificar e quiser arrumar, conta como um bônus. Na próxima entrevista, também iremos abordar esse ponto, portanto se quiser apenas comentar sobre eles, tudo bem.

Setup

Você precisa:

docker
docker-compose
ruby 3.0.3

Para iniciar o container do PostgreSQL, basta rodar na raíz do projeto: docker-compose up

Se enfrentar dificuldade com o docker, suba um banco PostgreSQL localmente e ajuste as configurações de conexão.

Crie um arquivo .env e atualize as variáveis que precisam ser definidas: cp .env.example .env

Execute o bundle para instalar as dependências do projeto.

Inicialize a base de dados com: rails db:setup

Já para iniciar a aplicação: foreman start

Testes

O desafio back-end permite execução da suite de testes em paralelo, através da gem parallel_tests, para melhor performance. Para executar a suite de testes:

Prepare o banco de dados de teste
```
 rails db:test:prepare
```
Gere os bancos de dados de teste a serem utilizados para cada processo em paralelo (o comando gera X banco de dados, onde X é de acordo com o número de CPUs do seu computador):
```
 rails parallel:create
```
Execute os testes (o comando abaixo dispara as suites de testes em paralelo usando 4 processos):
```
 COVERAGE=true parallel_rspec spec -n 4
```
Verifique o resultado dos testes no arquivo
```
 ./coverage/index.html
```

Rubocop

Para rodar o rubocop, rode: rubocop --parallel

fabioml10/des-fin