https://github.com/josepholiveira/database-relations-challenge
https://github.com/josepholiveira/database-relations-challenge
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/josepholiveira/database-relations-challenge
- Owner: josepholiveira
- Created: 2020-05-10T17:34:21.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-24T02:30:48.000Z (over 2 years ago)
- Last Synced: 2025-02-13T07:44:11.946Z (4 months ago)
- Language: TypeScript
- Size: 1.77 MB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
Desafio 09: Relacionamentos com banco de dados no Node.js
“Mude você e todo o resto mudará naturalmente”!
Sobre o desafio |
Entrega |
Licença
## :rocket: Sobre o desafio
Nesse desafio, você vai estar criando uma nova aplicação para aprender novas coisas e treinar o que você aprendeu até agora no Node.js junto ao TypeScript, incluindo o uso de banco de dados com o TypeORM, e relacionamentos ManyToMany!
Essa será uma aplicação que deve permitir a criação de clientes, produtos e pedidos, onde o cliente pode gerar novos pedidos de compra de certos produtos, como um pequeno e-commerce.
### Template da aplicação
Para te ajudar nesse desafio, criamos para você um modelo que você deve utilizar como um template do Github.
O template está disponível na seguinte url: **[Acessar Template](https://github.com/Rocketseat/gostack-template-typeorm-relations)**
**Dica**: Caso não saiba utilizar repositórios do Github como template, temos um guia em **[nosso FAQ](https://github.com/Rocketseat/bootcamp-gostack-desafios/tree/master/faq-desafios).**
Agora navegue até a pasta criada e abra no Visual Studio Code, lembre-se de executar o comando `yarn` no seu terminal para instalar todas as dependências.
### Rotas da aplicação
Agora que você já está com o template clonado e pronto para continuar, você deve verificar os arquivos da pasta `src` e completar onde não possui código com o código para atingir os objetivos de cada rota.
- **`POST /customers`**: A rota deve receber `name` e `email` dentro do corpo da requisição, sendo o `name` o nome do cliente a ser cadastrado. Ao cadastrar um novo cliente, ele deve ser armazenado dentro do seu banco de dados e deve ser retornado o cliente criado. Ao cadastrar no banco de dados, na tabela `customers` ele deverá possuir os campos possuindo os campos `name`, `email`, `created_at`, `updated_at`.
**Dica**: Antes de criar um novo cliente, sempre verifique se já existe um cliente com o mesmo e-mail. Caso ela exista, retorne um erro.
- **`POST /products`**: Essa rota deve receber `name`, `price` e `quantity` dentro do corpo da requisição, sendo o `name` o nome do produto a ser cadastrado, `price` o valor unitário e `quantity` a quantidade existente em estoque do produto. Com esses dados devem ser criados no banco de dados um novo produto com os seguitnes campos: `name`, `price`, `quantity`, `created_at`, `updated_at`.
**Dica**: Antes de criar um novo produto, sempre verifique se já existe um produto com o mesmo nome. Caso ela exista, retorne um erro.
- **`POST /orders/`**: Nessa rota você deve receber no corpo da requisição o `customer_id` e um array de products, contendo o `id` e a `quantity` que você deseja adicionar a um novo pedido. Aqui você deve cadastrar na tabela `order` um novo pedido relacionado ao `customer_id` informado, e na tabela `orders_products` deve armazenar o `product_id`, `order_id`, `price` e `quantity`. Além disso você deve sempre diminuir a quantidade existente de um produto na tabela de products, de acordo com a quantidade pedida.
**Dica 1**: Nessa funcionalidade, você precisará fazer um relacionamento de N:N entre produtos e pedidos, onde vários produtos podem estar em vários pedidos, com isso você deve sempre lembrar de armazenar o valor do produto no momento da compra e a quantidade pedida na tabela pivô com nome de `orders_products`, então essa tabela vai ter os campos `id`, `order_id`, `product_id`, `quantity`, `price`, `created_at` e `updated_at`. Para esse tipo de relacionamento, você pode verificar na documentação [Como fazer relacionamento muitos-para-muitos com propriedades customizadas](https://github.com/typeorm/typeorm/blob/master/docs/many-to-many-relations.md#many-to-many-relations-with-custom-properties).
**Dica 2**: A sua requisição do insomnia deve enviar um JSON com o formato parecido com esse:
```json
{
"customer_id": "e26f0f2a-3ac5-4c21-bd22-671119adf4e9",
"products": [
{
"id": "ce0516f3-63ae-4048-9a8a-8b6662281efe",
"quantity": 5
},
{
"id": "82612f2b-3f31-40c6-803d-c2a95ef35e7c",
"quantity": 7
}
]
}
```
**Dica 3**: Uma chamada a essa rota deve retornar os dados do cliente, produtos do pedido e id do pedido, num formato parecido com o seguinte:
```json
{
"id": "5cbc4aa2-b3dc-43f9-b121-44c1e416fa92",
"created_at": "2020-05-11T07:09:48.767Z",
"updated_at": "2020-05-11T07:09:48.767Z",
"customer": {
"id": "e26f0f2a-3ac5-4c21-bd22-671119adf4e9",
"name": "Rocketseat",
"email": "[email protected]",
"created_at": "2020-05-11T06:20:28.729Z",
"updated_at": "2020-05-11T06:20:28.729Z"
},
"order_products": [
{
"product_id": "ce0516f3-63ae-4048-9a8a-8b6662281efe",
"price": "1400.00",
"quantity": 5,
"order_id": "5cbc4aa2-b3dc-43f9-b121-44c1e416fa92",
"id": "265b6cbd-3ab9-421c-b358-c2e2b5b3b542",
"created_at": "2020-05-11T07:09:48.767Z",
"updated_at": "2020-05-11T07:09:48.767Z"
},
{
"product_id": "82612f2b-3f31-40c6-803d-c2a95ef35e7c",
"price": "500.00",
"quantity": 7,
"order_id": "5cbc4aa2-b3dc-43f9-b121-44c1e416fa92",
"id": "ae37bcd6-7be7-47b9-b277-afee35aab4e4",
"created_at": "2020-05-11T07:09:48.767Z",
"updated_at": "2020-05-11T07:09:48.767Z"
}
]
}
```
- **`GET /order/:id`**: Essa rota deve retornar
### Específicação dos testes
Em cada teste, tem uma breve descrição no que sua aplicação deve cumprir para que o teste passe.
Caso você tenha dúvidas quanto ao que são os testes, e como interpretá-los, dê uma olhada em **[nosso FAQ](https://github.com/Rocketseat/bootcamp-gostack-desafios/tree/master/faq-desafios).**
Para esse desafio, temos os seguintes testes:
⚠️ Antes de rodar os testes, crie um banco de dados com o nome "gostack_desafio09_tests" para que todos os testes possam executar corretamente ⚠️
- **`should be able to create a new customer`**: Para que esse teste passe, sua aplicação deve permitir que um cliente seja criado, e retorne um json com o cliente criado.
- **`should not be able to create a customer with one e-mail thats already registered`**: Para que esse teste passe, sua aplicação deve retornar um erro quando você tentar cadastrar um cliente com um e-mail que já esteja cadastrado no banco de dados.
- **`should be able to create a new product`**: Para que esse teste passe, sua aplicação deve permitir que um produto seja criado, e retorne um json com o produto criado.
- **`should not be able to create a duplicated product`**: Para que esse teste passe, sua aplicação deve retornar um erro quando você tentar cadastrar um produto com um nome que já esteja cadastrado no banco de dados.
- **`should be able to create a new order`**: Para que esse teste passe, sua aplicação deve permitir que um pedido seja criado, e retorne um json com o todos os dados do pedido criado.
- **`should not be able to create an order with a invalid customer`**: Para que esse teste passe, sua aplicação não deve permitir a criação de um novo pedido com um cliente que não existe no banco de dados, retornando um erro.
- **`should not be able to create an order with invalid products`**: Para que esse teste passe, sua aplicação não deve permitir a criação de um novo pedido com um produtos que não existem no banco de dados, retornando um erro caso um ou mais dos produtos enviados não exista no banco de dados.
- **`should not be able to create an order with products with invalid quantities`**: Para que esse teste passe, sua aplicação não deve permitir a criação de um novo pedido com um produtos que não possuem quantidade disponível, retornando um erro caso um ou mais dos produtos enviados não possua a quantidade necessária.
- **`should be able to subtract an product total quantity when it is ordered`**: Para que esse teste passe, sua aplicação deve permitir que, quando um novo pedido for criado, seja alterada a quantidade total dos produtos baseado na quantidade pedida.
- **`should be able to list one specific order`**: Para que esse teste passe, você deve permitir que a rota `orders/:id` retorne um pedido, contendo todas as informações do pedido com o relacionamento de `customer` e `order_products`.
## :calendar: Entrega
Esse desafio deve ser entregue a partir da plataforma Skylab, envie o link do repositório que você fez suas alterações. Após concluir o desafio, fazer um post no Linkedin e postar o código no Github é uma boa forma de demonstrar seus conhecimentos e esforços para evoluir na sua carreira para oportunidades futuras.
## :memo: Licença
Esse projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
---
Feito com 💜 by Rocketseat :wave: [Entre na nossa comunidade!](https://discordapp.com/invite/gCRAFhc)