Project Car Shop

Descrição do Projeto

Desenvolvimento de uma API com CRUD para gerenciar uma concessionária de veículos, aplicando os princípios de Programação Orientada a Objetos (POO) e usando o banco de dados MongoDB através do framework do Mongoose.

Habilidades desenvolvidas

API orientada a objetos
NoSQL

Requisitos Obrigatórios

01 - Crie a rota /cars onde seja possível cadastrar um carro

O endpoint deve ser acessível através do caminho (/cars);
Os carros cadastrados devem ser salvos na collection cars do banco de dados;
Os nomes dos arquivos/classes/interfaces devem ser definidos em inglês e seguir a organização/padronização de diretórios e nomenclatura ensinadas na seção;
Os nomes das classes devem possuir os mesmos nomes dos arquivos; (ex: Pet.ts ---> export default class Pet { });
Os atributos necessários para criar um carro estão na tabela:

Atributos	Descrição
`id`	String contendo id do veículo
`model`	String contendo modelo do veículo
`year`	Number contendo ano de fabricação do veículo
`color`	String contendo cor principal do veículo
`status`	Booleano contendo status que define se um veículo pode ou não ser comprado (este atributo deve ser opcional e se não passado, deve ser `false`)
`buyValue`	Number contendo valor de compra do veículo
`doorsQty`	Number contendo quantidade de portas de um carro
`seatsQty`	Number contendo quantidade de assentos de um carro

O corpo da requisição poderá seguir o formato abaixo:

{
  "model": "Marea",
  "year": 2002,
  "color": "Black",
  "status": true,
  "buyValue": 15.990,
  "doorsQty": 4,
  "seatsQty": 5
}

Os seguintes pontos serão avaliados

Será validado que existe uma interface de nome ICar que representa o contrato usado para cadastrar um carro;
Será validado que a interface contém os atributos especificados na tabela;
Será validado que existe uma classe de domínio com o nome Car que representa o objeto carro;
Será validado que a classe de domínio carro contém os atributos: doorsQty e seatsQty acessíveis apenas a própria classe;
Será validado que a classe de domínio carro contém os atributos restantes acessíveis a própria classe e suas subclasses;
Será validado que a instância da classe de domínio carro recebe como parâmetro um objeto do tipo ICar;

Será validado que é possível cadastrar um carro com sucesso;

Deve-se retornar um JSON com as seguintes chaves:

  {
    "id": "6348513f34c397abcad040b2",
    "model": "Marea",
    "year": 2002,
    "color": "Black",
    "status": true,
    "buyValue": 15.990,
    "doorsQty": 4,
    "seatsQty": 5
  }

⚠️ Atenção, para o requisito ser avaliado corretamente:

A instância de um objeto de domínio deve receber um objeto como parâmetro;
As exportações devem ser feitas no formato export default;

02 - Crie o endpoint para listar carros

O endpoint deve ser acessível através do caminho (/cars) e (/cars/:id);
Os carros listados devem vir da collection cars do banco de dados;
Através do caminho /cars/:id, apenas o carro com o id presente na URL deve ser retornado;

Os seguintes pontos serão avaliados

Será validado que é possível listar todos os carros;

Deve-se retornar um JSON com as seguintes chaves:

  [
    {
      "id": "634852326b35b59438fbea2f",
      "model": "Marea",
      "year": 2002,
      "color": "Black",
      "status": true,
      "buyValue": 15.99,
      "doorsQty": 4,
      "seatsQty": 5
    },
    {
      "id": "634852326b35b59438fbea31",
      "model": "Tempra",
      "year": 1995,
      "color": "Black",
      "buyValue": 39,
      "doorsQty": 2,
      "seatsQty": 5
    }
  ]

Será validado que não é possível listar um carro que não existe;
- Deve-se retornar o status 404 e um JSON com a seguinte mensagem:
```
  { "message": "Car not found" }
```
Será validado que não é possível listar um carro quando o formato do id esta inválido;
- Deve-se retornar o status 422 e um JSON com a seguinte mensagem:
```
  { "message": "Invalid mongo id" }
```

Será validado que é possível listar um carro específico com sucesso;

Deve-se retornar um JSON com as seguintes chaves:

  {
    "id": "634852326b35b59438fbea2f",
    "model": "Marea",
    "year": 2002,
    "color": "Black",
    "status": true,
    "buyValue": 15.99,
    "doorsQty": 4,
    "seatsQty": 5
  }

03 - Escreva testes para cobrir 30% da camada de Service

Obrigatoriamente seus arquivos de teste devem ficar no diretório tests/unit;
Obrigatoriamente seus testes devem fazer stub do banco de dados;
Opcionalmente você pode parar o serviço do MongoDB em sua máquina e executar seus teste com o comando npm run test:mocha;
Só será contabilizada a cobertura, se seus testes não conterem erros.

Os seguintes pontos serão avaliados

Será validado que os testes escritos por você estão sendo executados sem erros;
Será validado que existe um mínimo de 3 funções na camada Services.
Será validado que a cobertura total das linhas dos arquivos da camada Services é maior ou igual a 30%;

04 - Crie a rota /cars/:id onde seja possível atualizar um carro por ID

O endpoint deve ser acessível através do caminho (/cars/:id);
Apenas o carro com o id presente na URL deve ser atualizado;
O corpo da requisição poderá seguir o formato abaixo:

{
  "model": "Marea",
  "year": 1992,
  "color": "Red",
  "status": true,
  "buyValue": 12.000,
  "doorsQty": 2,
  "seatsQty": 5
}

Os seguintes pontos serão avaliados

Será validado que não é possível alterar um carro que não existe;
- Deve-se retornar o status 404 e um JSON com a seguinte mensagem:
```
  { "message": "Car not found" }
```
Será validado que não é possível alterar um carro quando o formato do id esta inválido;
- Deve-se retornar o status 422 e um JSON com a seguinte mensagem:
```
  { "message": "Invalid mongo id" }
```

Será validado que é possível alterar um carro com sucesso;

Deve-se retornar um JSON com as seguintes chaves:

  {
    "id": "634852326b35b59438fbea2f",
    "model": "Marea",
    "year": 1992,
    "color": "Red",
    "status": true,
    "buyValue": 12.000,
    "doorsQty": 2,
    "seatsQty": 5
  }

05 - Crie a rota /motorcycles onde seja possível cadastrar uma moto

O endpoint deve ser acessível através do caminho (/motorcycles);
As motos cadastradas devem ser salvas na collection motorcycles do banco de dados;
Os nomes dos arquivos/classes/interfaces devem ser definidos em inglês e seguir a organização/padronização de diretórios e nomenclatura ensinadas na seção;
Os nomes das classes devem possuir os mesmos nomes dos arquivos; (ex: Pet.ts ---> export default class Pet { });
Interface e classe de domínio referentes a carro, obrigatoriamente devem ser refatorados;
Os atributos necessários para criar uma moto estão na tabela:

Atributos	Descrição
`id`	String contendo id do veículo
`model`	String contendo modelo do veículo
`year`	Number contendo ano de fabricação do veículo
`color`	String contendo cor principal do veículo
`status`	Booleano contendo status que define se um veículo pode ou não ser comprado (este atributo deve ser opcional e se não passado, deve ser `false`)
`buyValue`	Number contendo valor de compra do veículo
`category`	String contendo categoria da moto (opções: `Street`, `Custom` ou `Trail`)
`engineCapacity`	Number contendo capacidade do motor

O corpo da requisição poderá seguir o formato abaixo:

{
  "model": "Honda Cb 600f Hornet",
  "year": 2005,
  "color": "Yellow",
  "status": true,
  "buyValue": 30.000,
  "category": "Street",
  "engineCapacity": 600
}

Os seguintes pontos serão avaliados

Será validado que existe uma interface de nome IMotorcycle que representa o contrato usado para cadastrar uma moto;
Será validado que a interface contém os atributos especificados na tabela;
Será validado que existe uma interface de nome IVehicle e esta contém os atributos repetidos de carro e moto;
- Deve-se refatorar as Interfaces se necessário;
Será validado que existe uma classe de domínio com o nome Motorcycle que representa o objeto moto;
Será validado que a classe de domínio moto contém os atributos: category e engineCapacity acessíveis apenas a própria classe;
Será validado que a classe de domínio moto contém os atributos restantes acessíveis a própria classe e suas subclasses;
Será validado que a instância da classe de domínio moto recebe como parâmetro um objeto do tipo IMotorcycle;
Será validado que existe uma classe de domínio com o nome Vehicle e esta contém os atributos repetidos de carro e moto;
- Deve-se refatorar as Domains se necessário;
Será validado que a classe de domínio veiculo contém os atributos acessíveis a própria classe e suas subclasses;
Será validado que existe uma classe de nome AbstractODM que representa o modelo de comunicação com o banco e ela serve como abstração para as demais;
- Deve-se refatorar as Models se necessário;

Será validado que é possível cadastrar uma moto com sucesso;

Deve-se retornar um JSON com as seguintes chaves:

  {
    "id": "6348513f34c397abcad040b2",
    "model": "Honda Cb 600f Hornet",
    "year": 2005,
    "color": "Yellow",
    "status": true,
    "buyValue": 30.000,
    "category": "Street",
    "engineCapacity": 600
  }

⚠️ Atenção, para o requisito ser avaliado corretamente:

A instância de um objeto de domínio deve receber um objeto como parâmetro;
As exportações devem ser feitas no formato export default;
Arquivos/códigos feitos para cars ~~devem~~ podem sofrer refatorações;

06 - Escreva testes para cobrir 60% da camada de Service

Obrigatoriamente seus arquivos de teste devem ficar no diretório tests/unit;
Obrigatoriamente seus testes devem fazer stub do banco de dados;
Opcionalmente você pode parar o serviço do MongoDB em sua máquina e executar seus teste com o comando npm run test:mocha;
Só será contabilizada a cobertura, se seus testes não conterem erros.

Os seguintes pontos serão avaliados

Será validado que os testes escritos por você estão sendo executados sem erros;
Será validado que existe um mínimo de 5 funções na camada Services.
Será validado que a cobertura total das linhas dos arquivos da camada Services é maior ou igual a 60%;

07 - Crie a rota /motorcycles onde seja possível listar motos

O endpoint deve ser acessível através do caminho (/motorcycles) e (/motorcycles/:id);
As motos listadas devem vir da collection motorcycles do banco de dados;
Através do caminho /motorcycles/:id, apenas a moto com o id presente na URL deve ser retornada;

Os seguintes pontos serão avaliados

Será validado que é possível listar todas as motos;

Deve-se retornar um JSON com as seguintes chaves:

  [
    {
      "id": "634852326b35b59438fbea2f",
      "model": "Honda Cb 600f Hornet",
      "year": 2005,
      "color": "Yellow",
      "status": true,
      "buyValue": 30.000,
      "category": "Street",
      "engineCapacity": 600
    },
    {
      "id": "634852326b35b59438fbea31",
      "model": "Honda Cbr 1000rr",
      "year": 2011,
      "color": "Orange",
      "status": true,
      "buyValue": 59.900,
      "category": "Street",
      "engineCapacity": 1000
    }
  ]

Será validado que não é possível listar uma moto que não existe;
- Deve-se retornar o status 404 e um JSON com a seguinte mensagem:
```
  { "message": "Motorcycle not found" }
```
Será validado que não é possível listar uma moto quando o formato do id esta inválido;
- Deve-se retornar o status 422 e um JSON com a seguinte mensagem:
```
  { "message": "Invalid mongo id" }
```

Será validado que é possível listar uma moto específica com sucesso;

Deve-se retornar um JSON com as seguintes chaves:

  {
    "id": "634852326b35b59438fbea31",
    "model": "Honda Cbr 1000rr",
    "year": 2011,
    "color": "Orange",
    "status": true,
    "buyValue": 59.900,
    "category": "Street",
    "engineCapacity": 1000
  }

Requisitos Bônus

08 - Crie a rota /motorcycles/:id onde seja possível atualizar uma moto por ID

O endpoint deve ser acessível através do caminho (/motorcycles/:id);
Apenas a moto com o id presente na URL deve ser atualizada;
O corpo da requisição poderá seguir o formato abaixo:

{
  "model": "Honda Cb 600f Hornet",
  "year": 2014,
  "color": "Red",
  "status": true,
  "buyValue": 45.000,
  "category": "Street",
  "engineCapacity": 600
}

Os seguintes pontos serão avaliados

Será validado que não é possível alterar uma moto que não existe;
- Deve-se retornar o status 404 e um JSON com a seguinte mensagem:
```
  { "message": "Motorcycle not found" }
```
Será validado que não é possível alterar uma moto quando o formato do id esta inválido;
- Deve-se retornar o status 422 e um JSON com a seguinte mensagem:
```
  { "message": "Invalid mongo id" }
```

Será validado que é possível alterar uma moto com sucesso;

Deve-se retornar um JSON com as seguintes chaves:

  {
    "id": "634852326b35b59438fbea2f",
    "model": "Honda Cb 600f Hornet",
    "year": 2014,
    "color": "Red",
    "status": true,
    "buyValue": 45.000,
    "category": "Street",
    "engineCapacity": 600
  }

09 - Escreva testes para cobrir 80% da camada de Service

Obrigatoriamente seus arquivos de teste devem ficar no diretório tests/unit;
Obrigatoriamente seus testes devem fazer stub do banco de dados;
Opcionalmente você pode parar o serviço do MongoDB em sua máquina e executar seus teste com o comando npm run test:mocha;
Só será contabilizada a cobertura, se seus testes não conterem erros.

Os seguintes pontos serão avaliados

Será validado que os testes escritos por você estão sendo executados sem erros;
Será validado que existe um mínimo de 8 funções na camada Services.
Será validado que a cobertura total das linhas dos arquivos da camada Services é maior ou igual a 80%;

Requisitos não avaliativos

10 - Crie a rota /cars/:id onde seja possível excluir um carro por ID

O endpoint pode ser acessível através do caminho (/cars/:id);
Através do caminho /cars/:id, apenas o carro com o id presente na URL deve ser excluído;

Não é possível excluir um carro que não existe;
- Retorne status 404 e um JSON com a mensagem:
```
  { "message": "Car not found" }
```
Não é possível excluir um carro quando o formato do id esta inválido;
- Retorne status 422 e um JSON com a mensagem:
```
  { "message": "Invalid mongo id" }
```
Ao excluir com sucesso, retorne status 204 sem body;

11 - Crie a rota /motorcycles/:id onde seja possível excluir uma moto por ID

O endpoint pode ser acessível através do caminho (/motorcycles/:id);
Através do caminho /motorcycles/:id, apenas a moto com o id presente na URL deve ser excluída;

Não é possível excluir uma moto que não existe;
- Retorne status 404 e um JSON com a mensagem:
```
  { "message": "Motorcycle not found" }
```
Não é possível excluir uma moto quando o formato do id esta inválido;
- Retorne status 422 e um JSON com a mensagem:
```
  { "message": "Invalid mongo id" }
```
Ao excluir com sucesso, retorne status 204 sem body;

12 - Escreva testes de unidade para cobrir 100% da sua aplicação

Escreva testes para as camadas de Models, Services e Controllers de forma a cobrir 100% das camadas de sua aplicação;
Se quiser se desafiar, escreva testes de integração também;
✨ Dica: Utilize o comando npm run test:coverage para verificar a cobertura de seus testes;
✨ Dica: Não se esqueça que seus arquivos de testes devem ficar no diretório tests/unit, ou tests/integration;
✨ Dica: Não se esqueça que seus testes devem fazer stub do banco de dados, quando escritos a nível de unidade.

Name		Name	Last commit message	Last commit date
Latest commit History 41 Commits
src		src
tests		tests
.DS_Store		.DS_Store
.env.example		.env.example
.eslintignore		.eslintignore
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
docker-compose.yml		docker-compose.yml
jest.config.js		jest.config.js
jest.d.ts		jest.d.ts
nyc.config.js		nyc.config.js
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Project Car Shop

Descrição do Projeto

Requisitos Obrigatórios

01 - Crie a rota /cars onde seja possível cadastrar um carro

02 - Crie o endpoint para listar carros

03 - Escreva testes para cobrir 30% da camada de Service

04 - Crie a rota /cars/:id onde seja possível atualizar um carro por ID

05 - Crie a rota /motorcycles onde seja possível cadastrar uma moto

06 - Escreva testes para cobrir 60% da camada de Service

07 - Crie a rota /motorcycles onde seja possível listar motos

Requisitos Bônus

08 - Crie a rota /motorcycles/:id onde seja possível atualizar uma moto por ID

09 - Escreva testes para cobrir 80% da camada de Service

Requisitos não avaliativos

10 - Crie a rota /cars/:id onde seja possível excluir um carro por ID

11 - Crie a rota /motorcycles/:id onde seja possível excluir uma moto por ID

12 - Escreva testes de unidade para cobrir 100% da sua aplicação

About

Releases

Packages

Contributors 2

Languages

priscilaSartori/project-car-shop

Folders and files

Latest commit

History

Repository files navigation

Project Car Shop

Descrição do Projeto

Requisitos Obrigatórios

01 - Crie a rota /cars onde seja possível cadastrar um carro

02 - Crie o endpoint para listar carros

03 - Escreva testes para cobrir 30% da camada de Service

04 - Crie a rota /cars/:id onde seja possível atualizar um carro por ID

05 - Crie a rota /motorcycles onde seja possível cadastrar uma moto

06 - Escreva testes para cobrir 60% da camada de Service

07 - Crie a rota /motorcycles onde seja possível listar motos

Requisitos Bônus

08 - Crie a rota /motorcycles/:id onde seja possível atualizar uma moto por ID

09 - Escreva testes para cobrir 80% da camada de Service

Requisitos não avaliativos

10 - Crie a rota /cars/:id onde seja possível excluir um carro por ID

11 - Crie a rota /motorcycles/:id onde seja possível excluir uma moto por ID

12 - Escreva testes de unidade para cobrir 100% da sua aplicação

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Languages

Packages