Comparador de precios de videojuegos para PC

📋 Descripción del Proyecto

Quest‑Hub es una plataforma web que permite a los usuarios buscar videojuegos y comparar sus precios entre diferentes tiendas digitales.
La aplicación combina datos obtenidos en tiempo real desde APIs externas con la información almacenada en la base de datos para ofrecer resultados rápidos y actualizados.

Quest‑Hub recopila:

• Ofertas actuales mediante la API de CheapShark
• Información detallada de videojuegos desde Steam API
• Datos persistentes en PostgreSQL (videojuegos, géneros, tiendas, ofertas, etc...)

El objetivo es ayudar a los jugadores a encontrar el mejor precio disponible en cada momento.

🛠️ Stack Tecnológico

Frontend

• React
• Vite
• CSS
• JavaScript
• TypeScript

Backend

• Spring Boot
• Java
• PostgreSQL

APIs Externas

• CheapShark: https://apidocs.cheapshark.com/

• Steam: https://steamcommunity.com/dev

📦 Base de Datos

Quest‑Hub almacena:

• Usuarios
• Videojuegos
• Bundles
• Géneros
• Tiendas
• Ofertas actuales
• Wishlist por usuario
• Relaciones entre las distintas entidades
• Ofertas asociadas a su Tienda correspondiente
• Videos/Imagenes asociados a cada juego

❗ El proyecto no almacena historial de precios ni genera gráficos de tendencias de momento. Solo guarda las ofertas actuales y las actualiza periódicamente.

🗄️ Esquema de Base de Datos

Incluye tablas como:

• usuario
• videojuego y bundle
• genero y genero_videojuego
• tienda
• oferta
• wishlist y wishlist_item
• movie
• capturas

🔄 Flujo de Datos

CheapShark API ───┐
Steam API ────────┤
                  ↓
┌──> Backend (Spring Boot) ──> PostgreSQL
│                                   │
│                                   │
└────────────── React Frontend <────┘

Lógica del flujo:

1. El frontend solicita datos al backend.
2. El backend consulta la base de datos:
   • Si los datos existen y están actualizados → se devuelven.
   • Si no existen o están desactualizados → se consulta a las APIs externas.
3. Los datos obtenidos se guardan/actualizan en la base de datos.
4. El backend envía la respuesta al frontend.

📝 Características Principales

• 🔍 Búsqueda de ofertas de videojuegos
• 💸 Comparación de precios entre tiendas digitales
• 📄 Información detallada de cada juego
• 🏷️ Ofertas actualizadas periódicamente (aprox. 8h)
• 👤 Registro y sesiones de usuarios
• ⭐ Wishlist por usuario
• 🎬 Trailers y vídeos asociados a cada juego
• 📮 Notificaciones de descuentos: En desarrollo
• 🎚️ Filtros avanzados (precio, tienda, género, valoración…)

📚 Documentación Completa de la API

🎮 Videojuegos y Bundles

GET /api/{id} — Obtener detalles de videojuego o bundle

Obtiene la información detallada de un videojuego o bundle con todas sus ofertas asociadas.

Parámetros:

• Path Parameter:
  • id (long) — ID del videojuego o bundle (requerido)

🏪 Tiendas

GET /api/tiendas — Obtener todas las tiendas digitales

Lista todas las tiendas digitales disponibles con sus logos e iconos.

Parámetros:

• Ninguno

💰 Ofertas y Precios

GET /api/mayorPrecio — Obtener precio máximo disponible

Retorna el precio más alto registrado entre todas las ofertas activas.

Parámetros:

• Ninguno

GET /api/ofertas — Listado paginado de ofertas con filtros

Obtiene un listado paginado de ofertas con soporte para filtros avanzados y ordenamiento.

Parámetros de Query:

Paginación (Spring Data):

• page (int, default: 0) — Número de página (0-indexed)
• size (int, default: 20) — Cantidad de items por página
• sort (string) — Campo y dirección de ordenamiento. Ej: sort=precioOferta,desc o sort=ahorro,asc

Filtros (FiltrosOfertas):

• titulo (string, opcional) — Nombre del juego a buscar
• minPrecio (double, opcional) — Precio mínimo en USD
• maxPrecio (double, opcional) — Precio máximo en USD
• minAhorro (double, opcional) — Descuento mínimo en porcentaje
• tiers (string[], opcional) — Géneros del juego. Ej: tiers=Action&tiers=RPG
• reviews (string[], opcional) — Filtro por rating. Ej: reviews=Overwhelmingly Positive&reviews=Positive
• inicioOferta (LocalDateTime, opcional) — Fecha mínima de oferta. Formato: 2026-05-16T10:00:00
• tiendaIds (long[], opcional) — IDs de tiendas. Ej: tiendaIds=1&tiendaIds=2

Ejemplo de Solicitud:

GET /api/ofertas?page=0&size=10&sort=precioOferta,asc&titulo=Counter&minPrecio=5.99&maxPrecio=29.99&tiers=Action&tiendaIds=1

👤 Usuarios

POST /api/usuarios/sincronizar — Sincronizar usuario

Sincroniza un nuevo usuario en el sistema o actualiza su registro existente.

Body (JSON):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "usuario@gmail.com"
}

DELETE /api/usuarios/eliminar — Eliminar cuenta

Elimina la cuenta del usuario autenticado y todos sus datos asociados (wishlist, preferencias, etc).

Headers:

• Authorization (string, requerido) — Token JWT. Formato: Bearer eyJhbGc...

GET /api/usuarios/preferencias — Obtener preferencias de notificaciones

Obtiene el estado actual de preferencias de notificaciones del usuario.

Parámetros:

• Query Parameter:
  • id (UUID, requerido) — ID del usuario

PATCH /api/usuarios/preferencias — Actualizar preferencias

Actualiza las preferencias de notificaciones del usuario.

Body (JSON):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "preferencia": true
}

⭐ Wishlist / Favoritos

POST /api/wishlist/toggle — Añadir/Eliminar de wishlist

Alterna un videojuego o bundle entre la wishlist del usuario (añade si no existe, elimina si existe).

Headers:

• Authorization (string, requerido) — Token JWT. Formato: Bearer eyJhbGc...

DELETE /api/wishlist/eliminar/{itemId} — Eliminar de wishlist

Elimina un item específico de la wishlist del usuario autenticado.

Headers:

• Authorization (string, requerido) — Token JWT. Formato: Bearer eyJhbGc...

Path Parameter:

• itemId (long, requerido) — ID del videojuego o bundle a eliminar

GET /api/wishlist/mis-favoritos — Obtener wishlist del usuario

Obtiene la lista completa de videojuegos y bundles en la wishlist del usuario autenticado.

Headers:

• Authorization (string, requerido) — Token JWT. Formato: Bearer eyJhbGc...

🔧 Testing (Endpoints de prueba)

GET /test/sync-ofertas — Forzar sincronización de ofertas

Inicia manualmente la sincronización de ofertas desde CheapShark.

GET /test/sync-stores — Forzar sincronización de tiendas

Inicia manualmente la sincronización de tiendas.

GET /test/panic — Sincronización completa

Inicia la sincronización total de toda la base de datos.

🚀 Instalación y Configuración

Requisitos Previos

• Java 11+ para el backend
• Node.js 16+ y npm para el frontend
• PostgreSQL 12+ para la base de datos
• Git para clonar el repositorio

Backend (Spring Boot)

1. Navega a la carpeta del backend:

cd Backend

2. Configura la conexión a PostgreSQL en application.properties:

spring.datasource.url=jdbc:postgresql://localhost:5432/videogames_db
spring.datasource.username=tu_usuario
spring.datasource.password=tu_contraseña
spring.jpa.hibernate.ddl-auto=update

3. Compila e inicia la aplicación:

mvn spring-boot:run

El servidor estará disponible en http://localhost:8080

Frontend (React + Vite)

1. Navega a la carpeta del frontend:

cd Front

2. Instala las dependencias:

npm install

3. Inicia el servidor de desarrollo:

npm run dev

4. Construye para producción:

npm run build

La aplicación estará disponible en http://localhost:5173

👤 Autores

A1ebyte - Freddy De Andrade Bernabeu
KerinR432 - Kerin Aguilera
MoBaSell - Mohamed Bada Sellami

🎯 Estado del Proyecto

Estado: En desarrollo 🔧

Última actualización: 2026-05-21