/sars-camp

Essa API é do escopo SARsCamp, com funcionalidades relativas de consulta de cardápio, consulta de achados e perdidos, consulta de saldo e autenticação de usuários e alunos.

Primary LanguageTypeScript

SARsCamp - API

Visão Geral📚

Esta API foi desenvolvida em NestJS, utilizando mySQL como banco de dados e a biblioteca Prisma como ORM para fazer as solicitações de acesso a banco.

Pré-Requisitos para rodar a API

Informações Técnicas🛠️

Esta seção é destinada a desenvolvedores.

Instalação do framework e suas depedências⚙️

  • Primeiramente após clonar o projeto use o comando:
cd sars-camp
  • Ao entrar no projeto utilize o comando para instalar as dependências.
npm install
  • Em seguida será necessário criar um arquivo .env para as credenciais do banco de dados. Dentro do arquivo .env insira esta linha com as suas credenciais:
DATABASE_URL=mysql://USER:PASSWORD@HOST:PORT/DATABASE
  • Será necessário também adicionar um segredo para o os tokens de autenticação presentes na API. Para isso no arquivo .env adicione esta linha:
JWT_SECRET=segredo
  • Será necessário utilizar o Prisma para fazer o mapeamento do banco de dados. Para isso você pode fazer uma migration desses respectivos bancos, utilizando este comando:
npx prisma migrate dev
  • Para finalizar será necessário gerar de fato o cliente Prisma para utilizá-lo no projeto. Fazemos isso com esse comando:
npx prisma generate

Rodando o projeto 🚀

  • Para inciar o projeto como desenvolvedor basta utilizar o comando:
npm run start:dev
  • Ele começará a rodar a API no localhost na porta 3000.

Documentação das rotas

  • Para acessar a documentação das rotas feitas por meio da biblioteca Swagger basta entrar na rota:
http://localhost:3000/api

Docker 📦

  • A API possui um Dockerfile, ou seja, caso deseje colocar em ambiente de produção, seria muito interessante utilizar do Docker.
  • Para isso primeiramente é necessário tê-lo em sua máquina. Para baixar basta entrar no site Docker e ver como instalá-lo em sua máquina.
  • Após instalar o Docker basta rodar o comando abaixo para criar a imagem:
docker build -t sars-camp .
  • Em seguida para rodar o projeto digite o comando:
docker-compose up

Com isso a API estará rodando na porta 3000. Vale ressaltar que é necessário fazer a configuração do prisma antes de iniciar o docker.