An open API service indexing awesome lists of open source software.

https://github.com/rafaelmachadobr/dslist

Esse repositório é um motor de busca de jogos que possibilita aos utilizadores encontrar detalhes acerca de diversos jogos. Os utilizadores têm a capacidade de efetuar pesquisas com base no género e classificação dos jogos. Adicionalmente, a aplicação inclui uma funcionalidade especial que permite personalizar a ordenação da lista de jogos.
https://github.com/rafaelmachadobr/dslist

api back-end crud database game h2-database hibernate java jpa maven postgresql restful spring spring-boot

Last synced: 2 months ago
JSON representation

Esse repositório é um motor de busca de jogos que possibilita aos utilizadores encontrar detalhes acerca de diversos jogos. Os utilizadores têm a capacidade de efetuar pesquisas com base no género e classificação dos jogos. Adicionalmente, a aplicação inclui uma funcionalidade especial que permite personalizar a ordenação da lista de jogos.

Awesome Lists containing this project

README

          

# Projeto DSList - Intensivão Java Spring

## Sobre o projeto

🎮 DSList é uma incrível aplicação Back-end construída durante o Intensivão Java Spring, organizado pela [DevSuperior](https://devsuperior.com.br). 🌟

A proposta da aplicação é ser uma pesquisa de games, onde os usuários podem mergulhar no mundo dos jogos e encontrar informações sobre seus títulos favoritos. 🕹️💻

Com uma pitada de diversão, os usuários têm a liberdade de realizar buscas com base no gênero e classificação dos jogos, para descobrir verdadeiras pérolas dos videogames. 🕵️‍♂️🌟

E não para por aí! A DSList também traz um endpoint especial, permitindo que os jogos sejam organizados de forma personalizada na lista, tornando a experiência única e sob medida para cada usuário. 🔄🎊

Prepare-se para embarcar nessa jornada emocionante e desvendar o universo dos jogos com a DSList! 🚀🎉

## Modelo conceitual

![Modelo Conceitual](.github/dslist-model.png)

## Padrão camadas adotado

![Padrão camadas](.github/dslist-padrao-camadas.jpg)

## Endpoints

### Buscar todos os jogos paginado
```
GET /games
```

### Buscar jogo por id
```
GET /games/{id}
```

### Busca a categoria das listas de jogos
```
GET /lists
```

### Busca uma lista por meio de seu ID mostrando quais jogos estão dentro desta categoria
```
GET /lists/{id}/games
```

## Retorno da API

![Retorno da API](.github/dslist-api.png)

## Tecnologias utilizadas

### Back end
- [Java 17](https://www.java.com/pt-BR/)
- [Spring Boot](https://spring.io/projects/spring-boot)
- [H2 Console](https://www.h2database.com/html/main.html)
- [JPA / Hibernate](https://hibernate.org/)
- [Maven](https://maven.apache.org/)
- [Postman](https://www.postman.com/)

### Implantação em produção
- Hospedagem: [Railway](https://railway.app/)
- Banco de dados: [PostgreSQL](https://www.postgresql.org/)

## Como executar o projeto

### Pré-requisitos:
- Java 17
- Maven

```bash
# Clonar repositório
git clone https://github.com/rafaelmachadobr/DSList.git

# Entrar na pasta do projeto back end
cd DSList

# Executar o projeto
./mvnw spring-boot:run
```

## Licença

Este projeto está sob a licença MIT. Consulte a [LICENÇA](./LICENSE) para mais informações.