Skip to content

About

ChallengeHub es una API REST desarrollada con Spring Boot que permite a los usuarios participar en retos, registrar su progreso, ganar puntos, subir de nivel y obtener insignias, utilizando autenticación JWT y control de acceso por roles.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

Repository files navigation

ChallengeHub

Descripción

ChallengeHub es una aplicación de gestión de retos y badges donde los usuarios pueden completar desafíos y obtener recompensas. Implementa Spring Boot, JPA, PostgreSQL y seguridad con JWT.

Tecnologías

  • Java 25
  • Spring Boot 4.0.1
  • Spring Security con JWT
  • PostgreSQL
  • MapStruct
  • Lombok

Estructura del proyecto

  • entities/ → Clases de modelo (User, Challenge, Badge, Progress, UserBadge)
  • dto/ → Objetos de transferencia de datos
  • repositories/ → Interfaces JPA Repository
  • services/ → Lógica de negocio
  • controllers/ → Endpoints REST
  • config.security/ → Configuración de JWT y Spring Security
  • mapper/ → MapStruct para convertir Entity <-> DTO

Endpoints principales

  • Usuarios

    • POST /api/users → Crear usuario
    • GET /api/users → Listar usuarios (admin)
    • PUT /api/users/{id} → Actualizar usuario
    • DELETE /api/users/{id} → Eliminar usuario (admin)
  • Auth

    • POST /api/auth/login → Login y obtención de JWT
  • Challenges

    • GET /api/challenges → Obtener todos los retos
    • POST /api/challenges → Crear reto (admin)
    • PUT /api/challenges/{id} → Editar reto (admin)
    • DELETE /api/challenges/{id} → Eliminar reto (admin)
  • Badges

    • GET /api/badges → Listar badges
    • POST /api/badges → Crear badge (admin)
    • PUT /api/badges/{id} → Actualizar badge (admin)
    • DELETE /api/badges/{id} → Eliminar badge (admin)
  • Progress

    • POST /api/progress/mark → Marcar progreso (usuario logueado)
    • GET /api/progress/challenge/{challengeId} → Obtener progreso de un reto (admin)
  • UserBadge

    • GET /api/user-badges → Obtener badges de usuarios (admin)

Configuración

  • Base de datos: PostgreSQL
  • JWT secret: en application.properties como security.jwt.secret-key
  • JWT expiration: en application.properties como security.jwt.expiration-minutes

Instalación

git clone https://github.com/adrian0511/challengehub.git
cd challengehub
./mvnw spring-boot:run

About

ChallengeHub es una API REST desarrollada con Spring Boot que permite a los usuarios participar en retos, registrar su progreso, ganar puntos, subir de nivel y obtener insignias, utilizando autenticación JWT y control de acceso por roles.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages