Skip to content

GitLab

Last edited by Mathias Gatti Elbern
Page history

Rodando localmente (development)

Configuração

A configuração de cada ambiente está no config/environments/<env>.js. Para desenvolvimento vamos utilizar o arquivo config/environments/development.js. Nele esta configurado para subir a aplicação na porta 3000 e utilizar o MongoDB com a seguinte config:

username: "admin",
password: "p1c4d1nh0",
database: "dev"

Requisitos

Será necessário ter em sua máquina:

Configurando MongoDB

Docker

  • Na raiz do repositório existe um arquivo chamado docker-compose.yml. Com ele é possível subir uma instancia do MongoDB, já configurada para ser utilizada localmente. Para isso é preciso ter instalado o Docker em sua máquina (Linux ou Windows). Com o Docker rodando, o seguinte comando pode ser executado docker-compose up -d

Após isto o MongoDB já estará rodando.

Sem Docker - Para os que tiverem problemas com o Windows Home

  • Também é possível utilizar o MongoDB localmente. Para isto basta configurar o usuário e senha de acordo com o env do projeto.
  1. Deve-se instalar o MongoDB localmente na máquina através do link: https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-4.4.1-signed.msi
  2. No cmd digitar 'cd C:\Program Files\MongoDB\Server\4.4\bin\mongo.exe' O mongodb deve se conectar. Verificar em qual porta está conectado o mongo. No meu caso foi a 27017
  3. Digitar o comando 'use admin'
  4. Digitar o comando para adicionar usuário 'db.createUser( { user: "admin", pwd: "p1c4d1nh0", roles: [ { role: "dbOwner", db: "dev" } ] } )'
  5. No MongoDB Compass adicionar uma conexão como segue: Hostname: localhost Port: 27017 (vai depender de qual porta o mongo está conectado) Authentication: username/password Username: admin Password: p1c4d1nh0 Authentication Database: admin
  6. Após esses passos é possível iniciar o back.

https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/

Dependências

Para que todas as dependências do projeto sejam instaladas pode ser utilizado o gerenciador de pacotes NPM.

Com o repositório clonado, navegue até o a pasta raiz do projeto, e execute, npm install.

Rodando

Depois das devidas configurações, basta executar o seguinte comando para rodar o projeto, npm run dev.

Swagger e docs

O projeto conta com um middleware do Swagger para automaticamente documentar as rotas desenvolvidas. Para visualiza-lo, com o projeto em execução, basta acessar http://localhost:3000/api/docs.

Carregando as manutenções da URL para o arquivo Json

Rodar comando '& python ./scriptCarService.py' que gera o arquivo em json scheduledMaintenancesInitialPayload.json

Carregando as manutenções da Chevrolet para banco

Depois das devidas configurações, e de adicionar informações dos carros no banco, preferencialmente pelo front-end(CASO ADICIONE PELO SWAGGER, USAR LETRAS MAIUSCULAS). Ex: "brand":"CHEVROLET" "model":"ONIX" Após ter os veículos adicionados no contexto da gerência, rodar o comando para iniciar o script seeds.js: 'npm run seed'.