https://github.com/maxjdev/forumhub-oraclenexteducation-challenge

Projeto do modulo: Java e Spring Framework G7 - ONE
https://github.com/maxjdev/forumhub-oraclenexteducation-challenge

docker forum java jwt mysql security spring-boot

Last synced: 3 months ago
JSON representation

Projeto do modulo: Java e Spring Framework G7 - ONE

• Host: GitHub
• URL: https://github.com/maxjdev/forumhub-oraclenexteducation-challenge
• Owner: maxjdev
• Created: 2024-11-23T08:42:37.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-26T20:36:13.000Z (over 1 year ago)
• Last Synced: 2024-12-26T13:14:37.281Z (over 1 year ago)
• Topics: docker, forum, java, jwt, mysql, security, spring-boot
• Language: Java
• Homepage:
• Size: 438 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


# Forum-Hub - Challenge ONE



## Oracle Next Education + Alura

![Java](https://img.shields.io/badge/java-%23ED8B00.svg?style=for-the-badge&logo=openjdk&logoColor=white)

![Spring](https://img.shields.io/badge/spring-%236DB33F.svg?style=for-the-badge&logo=spring&logoColor=white)

![JWT](https://img.shields.io/badge/JWT-000000?style=for-the-badge&logo=JSON%20web%20tokens&logoColor=white)

![Apache Maven](https://img.shields.io/badge/Apache%20Maven-C71A36?style=for-the-badge&logo=Apache%20Maven&logoColor=white)

![MySQL](https://img.shields.io/badge/MySQL-005C84?style=for-the-badge&logo=mysql&logoColor=white)

![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&logo=docker&logoColor=white)

![Swagger](https://img.shields.io/badge/Swagger-85EA2D?style=for-the-badge&logo=Swagger&logoColor=white)



## Descrição

A API forum-hub é uma plataforma para gerenciamento de tópicos e usuários em um fórum. Com funcionalidades que incluem cadastro, consulta, atualização e exclusão de tópicos e usuários, além de operações relacionadas a cursos e respostas, essa API permite que os usuários interajam de forma fluida e segura.

## Tecnologias Utilizadas

- **Java 17**

- **Spring Boot**

- **JWT**

- **MySQL**

- **Maven**

- **Docker**

- **Swagger**

## Entidades

- **Curso**: Representa os cursos associados aos tópicos do fórum.

- **Resposta**: Representa as respostas de usuários para tópicos específicos.

- **Tópico**: Representa os tópicos discutidos no fórum.

- **Usuário**: Representa os usuários registrados na plataforma.

## Infraestrutura

- **Documentação**: A API gera documentação automática utilizando SpringDoc(OpenAPI / Swagger).

- **GlobalHandler**: Para tratamento global de exceções e respostas de erro.

- **Segurança**: Implementação de segurança com JWT e Spring Security.

## Controllers

- **Autenticacao**: Login e cadastro

- **Curso**: Operações CRUD

- **Resposta**: Operações CRUD

- **Topico**: Operações CRUD

- **Usuario**: Operações CRUD

### Exemplos de Endpoints: 

| HTTP              | Rotas                  | Descrição                                       |

|-------------------|------------------------|-------------------------------------------------|

| POST   | /usuario/cadastrar     | Cadastrar um novo usuário.                      |

| GET    | /topico/listar         | Listar todos os tópicos do fórum com paginação. |

| GET    | /topico/buscar/{id}    | Buscar detalhes de um tópico específico.        |

| PUT    | /topico/atualizar/{id} | Atualizar o status de um tópico.                |

| DELETE | /topico/deletar/{id}   | Deletar um tópico existente.                    |



 

### Imagens


![Print-1](img/1.png)




![Print-2](img/2.png)




![Print-3](img/3.png)



### Contruibuição

- Para contribuir, bifurque este repositório e envie suas alterações por meio de pull requests.

- Para relatórios de bugs ou sugestões de melhorias, abra um problema na página do projeto.