Desenvolvida para retornar uma listagem de usuários e produtos, assim como um orçamento baseado na taxa do usuário selecionado e no valor dos produtos escolhidos.
http://localhost:2000/usersretorna uma lista de usuários;http://localhost:2000/users/:userIdretorna o usuário correspondente;http://localhost:2000/productsretorna uma lista de produtos;http://localhost:2000/products/:productIdretorna o produto correspondente;http://localhost:2000/users/:userId/products?productIdsretorna o valor em reais a ser pago pelo usuário, calculado com base na taxa do usuário e preço da cada produto; os ids de produtos devem ser uma lista separada por vírgulas e sem espaço (id1,id2,id3,...).
Apenas o método GET foi implementado. Todos os endpoints retornam dados em formado JSON. Caso seja passado algum valor inválido em userId ou productId(s), o usuário será informado que aquele id não foi encontrado:
Na pasta do projeto, execute npm i para instalar as dependências. Caso não possua o json-server instalado, instale-o globalmente com npm i -g json-server.
Em uma janela do terminal execute json-server db.json -w para subir os dados do arquivo db.json.
Em outra janela do terminal, execute npm run server para subir o servidor e poder testar os endpoints do projeto.
Para rodar os testes execute npm t. Para mostrar em detalhes os arquivos cobertos pelos testes, execute npm run test:coverage.
Todo o código e comentários foram escritos em inglês, assim como as mensagens de commits; as exceções foram as mensagens transmitidas para o usuário. O projeto está dividido em:
- server: servidor express que roda na porta
2000; - routes: rotas e endpoints do servidor, acionam os controladores;
- controllers: usam os métodos de serviços para buscar os dados e devolver para o usuário;
- services: fazem as requisições para retornar os dados solicitados pelos controladores;
- utils: funções para serem reaproveitadas em outras partes do código;
- errors: classes para melhorar a identificação e tratamento de erros;
- tests: testes unitários.
Outros arquivos:
- .mockend.json: usado para gerar os dados de usuários e produtos;
- db.json: usado para guardar os dados gerados pelo mockend e acessá-los com json-server.
No início do projeto as requisições eram feitas com o axios diretamente para os endpoints do mockend, porém o tempo de resposta por vezes ultrapassava dois segundos para cada requisição. Ao utilizar o json-server para guardar os dados, o tempo de resposta caiu para ms, melhorando consideravelmente a performance do programa.
Inicialmente, devido a um erro de interpretação, a soma dos preços estava sendo calculada de forma errada, resultando em valores incorretos. Isso foi corrigido no commit f1ab81c e aprimorado no commit bbbcb81.
axios, express e body-parser para rodar o projeto e nodemon durante o desenvolvimento.
Para rodar o projeto também é necessário instalar o json-server (não está no package.json pois está instalado globalmente).
Foram desenvolvidos testes unitários utilizando jest e supertest; também foi utilizada a ferramenta postman.