💬 FórumHub — API REST com Spring Boot 3, MySQL e JWT
(Alura - Challenge)
FórumHub é uma API REST completa, segura e totalmente automatizada para um sistema de fórum online, com autenticação via JWT, validação robusta e arquitetura profissional com Spring Boot. Desenvolvido como parte do Challenge da formação Back-End Java OOP da Alura. O projeto adota arquitetura em camadas (controller, service, repository, domain e DTOs), aplicando boas práticas de organização, responsabilidade e manutenção de código.
O desenvolvimento do projeto consolidou habilidades como:
- ⚙️ Arquitetura RESTful
- 🛠️ Testes unitários e de integração com JUnit e Mockito
- ✅ Validações robustas com Bean Validation
- 🚨 Tratamento de erros
- 📚 Documentação automatizada com Swagger (OpenAPI)
- 🔐 Segurança com JWT (JSON Web Token)
- ☕ Java 17 ou superior + 🌱 Spring Boot 3
- 🔐 Spring Security + 🧾 JWT
- 📦 JPA + 🐘 Hibernate
- 🐬 Banco de dados MySQL
- 🛠️ Controle de versionamento de banco com Flyway
- 📦 Maven: Gerenciamento de dependências e build.
- 📦 JUnit 5
- 🔧 Mockito
- 📄 Swagger (OpenAPI)
- 💻 IntelliJ IDE: Ambiente de desenvolvimento integrado.
- 💾 MySQL: Sistema de gerenciamento de banco de dados relacional de código aberto.
- 📡 Insomnia: Ferramenta de teste de APIs REST que permite enviar requisições HTTP, validar respostas e testar endpoints com facilidade.
O projeto utiliza o Flyway para gerenciar as migrations de banco de dados no MySQL. Todas as alterações de estrutura no banco (como criação de tabelas e alterações de schema) são versionadas e controladas, garantindo consistência entre os ambientes de desenvolvimento e produção.
O FórumHub é um back-end de fórum desenvolvido com Spring Boot, com foco em boas práticas e organização de API REST.
- Cadastro e login de usuários
- Autenticação via JWT
- Controle de acesso baseado em perfis de usuário
- Cursos
- Cadastro de cursos
- Listagem de cursos
- Categorias
- Organização dos tópicos por categorias
- Tópicos de Discussão
- Criar novos tópicos
- Listar tópicos (com paginação e filtros)
- Atualizar e excluir tópicos
- Controle de status dos tópicos
- Marcar uma resposta como solução
- Respostas aos Tópicos
- Adicionar respostas aos tópicos
- Listar respostas (com paginação e filtros)
- Atualizar e excluir respostas
- Validação de dados de entrada (DTOs com Bean Validation)
- Mensagens de erro claras e padronizadas
- Tratamento centralizado de exceções
- API documentada com Swagger UI
Para ver a interface Swagger em ação, acesse as demonstrações visuais com GIFs interativos mostrando os principais endpoints da API.
O projeto conta com uma cobertura significativa de testes unitários e de integração, garantindo a qualidade e o correto funcionamento dos fluxos principais de negócio da API, incluindo:
- Cadastro de usuários, perfis, cursos, tópicos e respostas.
- Autenticação com JWT.
- Validações de regras de negócio.
- Tratamento global de exceções.
Os testes foram desenvolvidos com:
- 📦 JUnit 5
- 🔧 Mockito
- 🎯 Spring Boot Test
├── hub.forum.api
│ ├── controller
│ │ ├── AutenticacaoController.java
│ │ ├── CursoController.java
│ │ ├── PerfilController.java
│ │ ├── RespostaController.java
│ │ ├── TopicoController.java
│ │ └── UsuarioController.java
│ ├── domain
│ │ ├── categoria
│ │ │ └── Categoria.java
│ │ ├── curso
│ │ │ └── Curso.java
│ │ ├── perfil
│ │ │ └── Perfil.java
│ │ ├── resposta
│ │ │ └── Resposta.java
│ │ ├── topico
│ │ │ ├── StatusTopico.java
│ │ │ └── Topico.java
│ │ └── usuario
│ │ └── Usuario.java
│ ├── dto
│ │ ├── curso
│ │ │ ├── DadosCadastroCurso.java
│ │ │ ├── DadosDetalhamentoCurso.java
│ │ │ └── DadosListagemCurso.java
│ │ ├── perfil
│ │ │ ├── DadosCadastroPerfil.java
│ │ │ ├── DadosDetalhamentoPerfil.java
│ │ │ └── DadosListagemPerfil.java
│ │ ├── resposta
│ │ │ ├── DadosAtualizacaoResposta.java
│ │ │ ├── DadosCadastroResposta.java
│ │ │ ├── DadosDetalhamentoResposta.java
│ │ │ └── DadosListagemTotalResposta.java
│ │ ├── token
│ │ │ └── DadosTokenJWT.java
│ │ ├── topico
│ │ │ ├── validar
│ │ │ │ └── DadosValidarResposta.java
│ │ │ ├── DadosAtualizacaoTopico.java
│ │ │ ├── DadosCadastroTopico.java
│ │ │ ├── DadosDetalhamentoResumidoTopico.java
│ │ │ ├── DadosListagemTotalTopico.java
│ │ │ └── DadosListagemUnicoTopico.java
│ │ └── usuario
│ │ ├── DadosCadastroUsuario.java
│ │ ├── DadosDetalhamentoUsuario.java
│ │ ├── DadosListagemUsuario.java
│ │ └── DadosLogin.java
│ ├── infra
│ │ ├── exception
│ │ │ ├── TratadorDeErros.java
│ │ │ └── ValidacaoException.java
│ │ ├── security
│ │ │ ├── SecurityConfigurations.java
│ │ │ └── SecurityFilter.java
│ │ └── springdoc
│ │ └── SpringDocConfigurations.java
│ ├── repository
│ │ ├── CursoRepository.java
│ │ ├── PerfilRepository.java
│ │ ├── RespostaRepository.java
│ │ ├── TopicoRepository.java
│ │ └── UsuarioRepository.java
│ ├── service
│ │ ├── AutenticacaoService.java
│ │ ├── CursoService.java
│ │ ├── PerfilService.java
│ │ ├── RespostaService.java
│ │ ├── TokenService.java
│ │ ├── TopicoService.java
│ │ └── UsuarioService.java
│ └── ApiApplication.java
└── README.md
Os testes estão organizados por módulo e divididos em cenários de sucesso (acertivos) e erro:
test
└── hub.forum.api
├── controller
│ ├── all
│ │ ├── CadastroControllersTestErro400.java
│ │ └── CadastroControllersTestOk200.java
│ ├── resposta
│ │ ├── acertivos
│ │ │ ├── RespostaControllerAtualizarTest.java
│ │ │ ├── RespostaControllerDeletarRespostaTest.java
│ │ │ └── RespostaControllerListarTest.java
│ │ └── erros
│ │ ├── RespostaControllerAtualizarTestERRO.java
│ │ └── RespostaControllerDeletarRespostaTestERRO.java
│ └── topico
│ ├── acertivos
│ │ ├── TopicoControllerAtualizarTest.java
│ │ ├── TopicoControllerDeletarTopicoTest.java
│ │ ├── TopicoControllerListarByIdTest.java
│ │ ├── TopicoControllerListarTest.java
│ │ └── TopicoControllerMarcarSolucaoTest.java
│ └── erros
│ ├── TopicoControllerAtualizarTestERRO.java
│ ├── TopicoControllerDeletarTopicoTestERRO.java
│ └── TopicoControllerMarcarSolucaoTestERRO.java
└── service
├── all
│ └── CadastroCompletoTest.java
├── resposta
│ ├── acertivos
│ │ ├── RespostaServiceAtualizarTest.java
│ │ ├── RespostaServiceDeletarRespostaTest.java
│ │ └── RespostaServiceMarcarSolucaoTest.java
│ └── erros
│ ├── RespostaServiceAtualizarTestERRO.java
│ ├── RespostaServiceDeletarRespostaTestERRO.java
│ └── RespostaServiceMarcarSolucaoTestERRO.java
└── topico
├── acertivos
│ ├── TopicoServiceAtualizarTest.java
│ ├── TopicoServiceDeletarTopicoTest.java
│ └── TopicoServiceListarByIdTest.java
└── erros
├── TopicoServiceAtualizarTestERRO.java
├── TopicoServiceDeletarTestERRO.java
└── TopicoServiceListarByIdTestERRO.java
- ☕ Java 17 ou superior
- 🐬 MySQL instalado
- 💻 IDE de sua preferência (IntelliJ IDE, VSCode, Eclipse etc.)
- Clone o repositório
git clone https://github.com/renancvitor/challenge-forum-hub-api.git- Acesse a pasta do projeto
cd challenge-forum-hub-api- Configure o banco de dados no arquivo
src/main/resources/application.propertiescom suas credenciais locais. Ao iniciar o projeto, as migrations serão aplicadas automaticamente pelo Flyway.
spring.datasource.url=jdbc:mysql://localhost:3306/nome_do_banco
spring.datasource.username=seu_usuario
spring.datasource.password=sua_senha- Execute o projeto com o Maven Wrapper:
./mvnw spring-boot:run- Acesse o Swagger em:
http://localhost:8080/swagger-ui/index.html- Faça login para obter o token JWT e utilizar nas requisições protegidas.
Agradeço à Alura por essa oportunidade de aprendizado contínuo e por incentivar o desenvolvimento de habilidades de programação de forma estruturada e desafiadora. 🚀 Este projeto consolidou habilidades práticas em desenvolvimento de APIs RESTful robustas, autenticação segura com Spring Security e JWT, tratamento global de exceções e versionamento controlado de banco com Flyway — competências amplamente aplicadas em desenvolvimento back-end profissional.
Se você quiser contribuir para o projeto, siga estas etapas:
- Faça um fork deste repositório.
- Crie uma nova branch (
git checkout -b feature/alguma-coisa). - Faça suas mudanças.
- Envie um pull request explicando as mudanças realizadas.
Obrigado pelo interesse em contribuir!
Se tiver dúvidas ou sugestões, sinta-se à vontade para entrar em contato:
- 📧 E-mail: [email protected]
- 🟦 LinkedIn: Renan Vitor
📌 Este projeto está licenciado sob a Licença MIT, o que significa que você pode utilizá-lo, modificar, compartilhar e distribuir livremente, desde que mantenha os devidos créditos aos autores e inclua uma cópia da licença original - veja o arquivo LICENSE para detalhes ou acesse a licença MIT oficial.