DSList - Backend

• Descrição:

  A aplicação é uma coleção de jogos eletrônicos que permite aos usuários realizarem pesquisas e encontrar informações sobre diferentes jogos listados. As buscas podem ser realizadas com base no gênero e na classificação dos jogos. Além disso, possui a funcionalidade de reorganizar a lista de jogos de acordo com suas preferências.

• Tabela de Conteúdos:

  • Modelo de Domínio
  • Padrão de Camadas
  • Endpoints
  • Instruções para Executar
  • Contribuição

• Modelo de Domínio

  Este é o modelo de domínio para o projeto, foi construído utilizando a ferramenta de modelagem Astah, na versão gratuíta Community, nele é possível visualizar as tabelas, atributos, relacionamentos, cardinalidades e chaves primárias.

  

• Padrão de Camadas

  A arquitetura do projeto segue o seguinte padrão de camadas abaixo.

  

• Endpoints

  A seguir, estão listados os principais endpoints da API com suas respectivas funcionalidades:

  • Endpoint: {/games}

  Rest	Request	Função
  GET	Games	Retorna a lista completa de jogos
  GET	Game By ID	Retorna as informações de um jogo específico com base no seu ID
  GET	Games Lists	Retorna os gêneros dos games disponíveis
  GET	Games By Lists	Retorna os jogos que pertencem a um gênero específico, com base no seu ID
  POST	List Replacement	Permite que o usuário organize a ordem da lista de jogos de acordo com sua preferência

  Obs: após a requisição List Replacement ser concluída corretamente, obtendo o código de resposta 200, é possível verificar no endpoint GET By Lists as alterações realizadas nas posições dos jogos na lista disponível.

  • Todas as requisições estão disponíveis para testes, feedbacks e afins. Clique no botão abaixo para abrir no Postman.

  

• Instruções para Executar

  • Pré-Requisito:
    • Java (JDK 17)
      

  # Clonar repositório - SSH
  git clone git@github.com:marcosrebelo97/dslist-backend.git
  
  # Acessar pasta do projeto back-end
  cd dslist-backend
  
  # Instalar as dependências do Maven
  mvn install
  
  # Executar o projeto
  ./mvnw spring-boot:run

Tecnologias | Implantação em produção

• Java (JDK 17)
• Spring Boot
• Spring Data JPA
• Spring Boot Web
• Maven
• H2 Database
• Ambiente local com Docker Compose
• Processo de deploy: CI/CD
• Implantação Back-end: Railway | Disponível em: dslist-backend-production-9a69.up.railway.app/games
• Implantação Banco de Dados: PostgreSQL | DBeaver

Colaborador

Marcos Guerreiro Rebelo

---

• Contribuição:

  Este projeto faz parte dos meus estudos práticos sobre back-end, então, ficarei contente se você me fornecer algum feedback sobre o projeto, código, estrutura ou qualquer coisa que você possa relatar que possa me tornar um desenvolvedor melhor.

  E-mail: marcosrebelo9@gmail.com

  Conecte-se comigo no Linkedln