/sps-node

Api developed for sps test project.

Primary LanguageJavaScript

SPS Node API


Sumário desta Documentação


Como rodar este projeto na sua máquina local

  1. git clone https://github.com/pedroluiznogueira/sps-react.git
  2. Abra o projeto clonado em sua IDE/Editor de texto de preferência
  3. Abra a pasta do projeto no terminal
  4. Digite "npm install" e aperte enter
  5. Digite "node src/index.js" (se perguntado se deseja rodar o projeto em outra porta sem ser a 3000 digite Y)

Configuração do MongoDB

-> Este projeto está configurado para persistir localmente em uma conexão com o MongoDB
-> Caso precise instalar ele na sua máquina local acesse:

  1. Instalação do MongoDB
  2. Instalação do ROBO 3T (interface gráfica para o MongoDB, similar ao Workbench para o MySQL)

-> Rodando o MongoDB no windows:

  1. Abra o terminal e acesse a pasta C:\Program Files\MongoDB\Server\5.0\bin "5.0" refere-se à versão que você tem instalada
  2. Digite mongo e aperte enter

-> Uma conexão será criada e aberta para o MongoDB
-> Sua conexão aperecerá com algo deste tipo: mongodb://127.0.0.1:27017

-> Conectando o Robo 3t com seu Serviço do MongoDB

  1. Abra o Robo 3T
  2. Crie uma conexão, usando o caminho que o Mongo gerou ácima "mongodb://127.0.0.1:27017"
  3. Em adress coloque o que aparece para você em: 127.0.0.1
  4. Posteriormente ao ":" coloque a porta que aparece para você: 27017 (Provavelmente é a mesma pois é a padrão do Mongo)

Relacionando a conexão do Projeto à sua conexão do MongoDB local

-> Abra a pasta src/database
-> Em index.js dentro de database
-> Altere a linha 3 com a sua conexão
-> No final segue o nome do banco local que deseja criar


Documentação da API podendo ser acessar no Swagger UI

-> Após rodar a aplicação, acesse: localhost:3000/api-docs
-> Lá você encontrará o mapeamento de todos os end-points da API
-> A descriçaõ e detalhes da documentação da API no swagger não está finalizada
-> As informações necessárias para uso e entendimento da API já estão contidas


Contribuições

-> Sinta-se livre para abrir contribuir para esse projeto seguindo os seguintes passos:

  1. Fork neste projeto
  2. Faça suas mudanças e suba-às para o seu repositório forkeado
  3. Abra um Pull Request para a branch DEVELOPER deste projeto