Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • W Wiki
  • Project information
    • Project information
    • Activity
    • Labels
    • Planning hierarchy
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 0
    • Issues 0
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Packages & Registries
    • Packages & Registries
    • Package Registry
    • Infrastructure Registry
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • Lobo-guará
  • Wiki
  • Wiki
  • Configuração do Ambiente

Last edited by João Pedro Souza da Silva Jun 16, 2025
Page history
This is an old version of this page. You can view the most recent version or browse the history.

Configuração do Ambiente

Home Escopo e Cronograma Processo Design/Mockups Configuração Arquitetura Infra Código BD

Este guia explica como configurar o ambiente para rodar o projeto em todos os seus repositórios.

Frontend

Configuração do VS Code

Para executar o Frontend do projeto, é necessário instalar:

  • Node.js 22.14.0
  • Yarn
  • Visual Studio Code

Após a instalação do Node.js, verifique se ele foi instalado corretamente executando o seguinte comando no terminal:

node -v

Backend

Configuração do Ambiente Backend

Requisitos

Certifique-se de ter as seguintes ferramentas instaladas na sua máquina:

  • Node.js v22.14.0
  • Yarn
  • Docker + Docker Compose
  • Git

Verifique se tudo foi instalado corretamente:

node -v
yarn -v
docker -v
git --version

Instalação

Clone o repositório e acesse a pasta do projeto:

git clone https://tools.ages.pucrs.br/lobo-guara/backend.git
cd backend

Instale as dependências:

yarn install

Banco de Dados

Suba o container do banco de dados com Docker Compose:

docker-compose up -d

Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto com o seguinte conteúdo:

DATABASE_URL="postgresql://postgres:postgres@localhost:5432/loboguara"
SECRET_KEY="sua_chave_secreta"
MAILERSEND_API_KEY="sua_api_key"
MAILERSEND_FROM_EMAIL="[email protected]"

ℹ️ Consulte a equipe para obter os valores reais de SECRET_KEY e MAILERSEND_API_KEY.


Migrações

Rode as migrações do banco de dados:

yarn prisma migrate deploy

Execução

Para iniciar a aplicação em modo de desenvolvimento:

yarn start:dev

A API estará disponível em:

  • Swagger: http://localhost:3000/docs
  • Base URL: http://localhost:3000

Parando os Containers

Para parar os containers do banco de dados:

docker-compose stop
Clone repository
  • Arquitetura do Projeto
  • Banco de Dados
  • Configuração do Ambiente
  • Código
  • Escopo e Cronograma
  • Processos
  • codigo
  • design
    • mockups
  • Home
  • mockups