API REST do Projeto Integrador GeekHub (Grupo GuildCode — UNIFIO), um marketplace para compra e venda de produtos geek e colecionáveis.
O backend gerencia cadastro e autenticação de usuários com JWT RSA, catálogo de categorias e anúncios, carrinho de compras, ciclo de pedidos com controle e estorno de estoque, avaliações pós-compra e perfil público consolidado do vendedor.
| Camada | Tecnologia |
|---|---|
| Linguagem | Java 21 |
| Framework | Spring Boot 4.1.2 |
| Segurança | Spring Security + OAuth2 Resource Server (JWT RSA) |
| Persistência | Spring Data JPA + Hibernate (ddl-auto=validate) |
| Banco de Dados e Migrations | MySQL 8 + Flyway |
| Documentação da API | SpringDoc OpenAPI (3.2.0) / Swagger UI |
| Testes e Cobertura | JUnit 5 + Mockito + H2 (testes) + JaCoCo 0.8.12 (100%) |
- Abra a pasta
geekhub-apino VS Code com a extensão Dev Containers (ou inicie um GitHub Codespace). - Selecione Reopen in Container. O ambiente instala Java 21, Maven e MySQL 8 e executa
.devcontainer/init-mysql.shpara criar o bancoecommercee o usuáriogeekhub. - Entre na pasta
geekhub/e inicie a aplicação:cd geekhub ./mvnw spring-boot:run
- Instale Java 21 e MySQL 8 em execução na porta
3306. - Crie o banco
ecommercee o usuáriogeekhub(senhageekhub), conforme configurado emgeekhub/src/main/resources/application.properties. - Entre na pasta
geekhub/e execute a aplicação:# Windows .\mvnw.cmd spring-boot:run # Linux / macOS ./mvnw spring-boot:run
A API inicia em http://localhost:8080. Em desenvolvimento, o FlywayConfig limpa o banco e reaplica as migrations V1 e V2 a cada inicialização.
| Perfil | Senha | Permissões | |
|---|---|---|---|
| Administrador | admin@geekhub.com |
123456 |
ADMIN, USUARIO |
| Usuário Comum | usuario@geekhub.com |
123456 |
USUARIO |
Vendedor (V2) |
vendedor@geekhub.com |
123456 |
USUARIO |
- Documentação da API (Swagger e endpoints): docs/documentacao-api.md
- Diagrama da Arquitetura em Camadas: docs/arquitetura-camadas.svg
- Diagrama do Banco de Dados (DER): docs/diagrama-db.svg
- Diagramas de Sequência (Cadastro e Login): docs/diagramas-sequencia-auth.md
- Coleção Postman (com variáveis e respostas salvas): postman/geekhub.postman_collection.json
Para visualizar a documentação completa (parâmetros, DTOs, autenticação JWT e códigos de resposta), inicie a API e acesse o Swagger (detalhes em docs/documentacao-api.md):
- Swagger UI (interativo):
http://localhost:8080/swagger-ui.html - Contrato OpenAPI JSON:
http://localhost:8080/v3/api-docs
Recursos disponíveis: /login, /usuarios, /categorias, /anuncios, /carrinho, /pedidos e /avaliacoes.
Os testes usam banco H2 em memória (geekhub/src/test/resources/application-test.properties). Execute dentro da pasta geekhub/:
# Windows
.\mvnw.cmd test
# Linux / Dev Container
./mvnw testO build exige 100% de cobertura de instruções, branches, linhas e métodos para as camadas de regra de negócio e conversão (service, validator, mapper e GlobalExceptionHandler). O pom.xml exclui da métrica apenas classes estruturais e de framework (GeekhubApplication, config, openapi, repository, domain, controller/DTOs e *Exception), embora controller, domain e repository também possuam testes dedicados.
Após executar os testes, o relatório completo é gerado localmente em geekhub/target/site/jacoco/index.html e geekhub/target/site/jacoco/jacoco.csv.
| Nome Completo | RA | GitHub |
|---|---|---|
| Bryan Alvarenga | 272426 |
@bryan-coursework |
| Igor Bassetto Menon | 274582 |
@Igor-menon |
| Juan Pedrozo | 273889 |
@juanpedrozo |
| Kauã Gustavo da Fonseca Rodrigues | 273722 |
@uaikauaa |
| Rafael Dias Garcia | 272207 |
@diasgarcia |
| Vitor Yago Ferreira dos Santos | 272261 |
@Cuidoka |
- Guia de contribuição e fluxo Git: CONTRIBUTING.md
- Regras arquiteturais do projeto: AGENTS.md
- Licença: GNU General Public License v3.0 (GPL-3.0)