WellPlayed: Especificación

Propuesta y especificación del proyecto para Desarrollo de Software

Repositorio web de reseñas e información de videojuegos

Grupo

Integrantes

• 50349 - Anmuth, Matías
• 51537 - Cabanellas, Miguel
• 51085 - Casado, Luciano Agustín
• 44771 - Salvia, Ricardo Tomas

Repositorios

• Frontend app
• Backend app
• Backend app (Java)

Tema

Descripción

Un repositorio de reseñas de videojuegos. Un usuario puede opinar sobre un juego dándole una puntuación en una escala de 0 a 5 estrellas, con opción a dejar un comentario escrito sobre un título. Los usuarios pueden crear listas de juegos relacionados a su parecer (similar a una playlist). El sistema también hace recomendaciones automatizadas basándose en etiquetas asociadas a los juegos. Finalmente, la web muestra información sobre los juegos como las plataformas soportadas y tiendas donde se encuentran.

Modelos

Diagrama de clases

Alcance funcional

Alcance mínimo

Req	Detalle
CRUD simple	1. CRUD Usuario
	2. CRUD Etiqueta
	3. CRUD Plataforma
	4. CRUD Tienda
CRUD dependiente	1. CRUD Juego (depende de CRUDs Etiqueta, Estudio, Tienda y Plataforma)
	2. CRUD Franquicias (depende de CRUD Juego)
Listado + detalle	1. Listar juegos por plataformas/etiquetas/desarrollador/publisher/franquicia, muestra nombre y puntuación promedio
	2. Listado de juegos filtrado por nombre, muestra nombre y puntuación promedio (búsqueda de juegos)
	3. Listado de juegos filtrado por rango de fecha y rango de puntuación promedio, muestra nombre, fecha lanzamiento, puntuación promedio, ordenado por puntaje
	4. Listado de reseñas de un juego filtrado por rango de puntajes
CUU/Epic	1. Escribir una reseña
	2. Crear una playlist

Adicionales para Aprobación Directa

Req	Detalle
CRUD	1. CRUD Estudio
CUU/Epic	1. El sistema ofrece recomendaciones de juegos al usuario en base a las etiquetas relacionadas y sus gustos

Aplicación

Instrucciones de Instalación

Las instrucciones asumen que tenés instalado un servidor SQL (como MariaDB) y que usás pnpm como gestor de paquetes de node

Cloná los dos repositorios siguientes:

mkdir wellplayed
git clone https://github.com/Maig0l/utn-dsw-back wellplayed/backend
git clone https://github.com/Maig0l/utn-dsw-front wellplayed/frontend

Instalá las dependencias e inicializá el archivo de configuración del backend:

cd wellplayed/backend
pnpm install
pnpm initConfig

En el archivo .env que se creó, ingresá el usuario y contraseña del motor SQL en dbUser y dbPasswd. En dbName ingresá un nombre para el schema de la aplicación (por ejemplo, wellplayed). Este será creado automáticamente cuando se inicie el servidor. En caso de ser necesario, también podés cambiar el host y puerto donde se encuentra el motor con dbHost y dbPort.

Podés cambiar el puerto donde escucha la API con la variable port.

---

En una nueva terminal, instala las dependencias del frontend:

cd wellplayed/frontend
pnpm install

Si desplegaste el backend en un puerto distinto del default (8080), edita la variable API_PORT en el archivo src/environment/environment.ts para que coincida con el puerto del backend (y API_HOST si la API no está en la misma máquina).

Iniciá el frontend:

pnpm start

La aplicación está desplegada. Ingresá a http://localhost:4200/log-in con las credenciales:

• Username: Admin
• Contraseña: Admin_init1

Documentación de la API

Todavía está pendiente generar la documentación y colgarla en GitHub Pages

La documentación en formato Swagger de la API puede encontrarse acá. (Todavía no existe.)