Skip to content

API RESTful para o gerenciamento de uma concessionária de veículos

Notifications You must be signed in to change notification settings

leticia-238/car-shop

Repository files navigation

🛻 Car Shop 🚙

Sobre o projeto

Projeto realizado durante módulo de Backend na Trybe, entre 14 de Setembro e 21 de Setembro de 2022.

O Car Shop é uma API RESTful para o gerenciamento de uma concessionária de veículos.

Nesse projeto foram aplicados os princípios de Programação Orientada a Objetos (POO) para a construção de uma API com CRUD utilizando o banco de dados MongoDB.

A API foi documentada com Swagger utilizando o swagger-ui-express, para acessar a interface interativa e visualizar os serviços disponíveis pela api é preciso instalar e iniciar a aplição no computador segundo as instruções. Assim que o servidor estiver iniciado acesse o endereço http://localhost:3001/api-docs/ no browser.

Imagem da documentação da api

O arquivo src/models/connection.ts e o código dentro do arquivo de src/connections.ts foram desenvolvidos pela equipe da Trybe, escola de programação onde eu realizei este projeto. Toda as outras implementações no back-end foram realizadas por mim.

Tecnologias e Ferramentas utilizadas

Banco de Dados: MongoDB

Back-end: Node.js, Typescript, Express.js, Mongoose

Testes: Mocha, Chai, Sinon

Containerização dos serviços: Docker, Docker Compose

Instruções para a instalação

Pré-requisitos para iniciar a aplicação no computador

Execute os seguintes passos no terminal

  1. Clone o projeto:

    git clone git@github.com:leticia-238/car-shop.git`
  2. Entre na pasta do repositório clonado:

    cd car-shop`
  3. Inicie o servidor:

    Para iniciar o servidor com o docker-compose:
    npm run compose:up

    Este comando irá iniciar os containers da aplicação e do banco de dados de acordo com as configurações do arquivo docker-compose.yml

    Para iniciar o servidor com o node e o mongodb com docker:
    • Caso não tenha o MongoDB instalado em sua máquina rode o seguinte comando:
    docker run --name car_shop_db -p 27017:27017 -d mongo:5.0.7
    • Instale as dependências e inicie o servidor:
    npm install && npm start

Para rodar os testes execute:

 npm run test:dev