BoxBox

Fantasy League de Fórmula 1 — Trabajo Práctico para Desarrollo de Software (UTN FRRO).

Descripción

BoxBox es una aplicación web de Fantasy League de Fórmula 1. Los usuarios crean o se unen a ligas privadas, participan en un draft en vivo con formato snake para armar su equipo, y compiten a lo largo de toda la temporada. Los resultados reales de cada Gran Premio se obtienen automáticamente desde APIs públicas de F1 para calcular puntajes.

Funcionalidades principales

• Ligas privadas: creá una liga e invitá amigos con un código de invitación (máximo 11 jugadores)
• Snake Draft en vivo: draft en tiempo real con timer por pick. Cada jugador arma su equipo: 2 pilotos titulares, 1 reserva y 1 escudería
• Scoring automático: los resultados de cada carrera se procesan automáticamente usando datos reales de F1
• Predicciones: antes de cada carrera, predecí el ganador, la pole y el equipo con más puntos para sumar bonus
• Recaps de carrera: después de cada GP, revisá cómo rindió tu equipo con un desglose detallado
• Gestión de lineup: intercambiá tu piloto reserva por un titular antes de la clasificación

Stack Técnico

Capa	Tecnología
Frontend	React + TypeScript + Tailwind CSS
Backend	Express + TypeScript
Base de datos	PostgreSQL + Prisma ORM
WebSocket	Socket.io (draft en vivo)
Testing	Vitest + Playwright
Deploy	Vercel (frontend) + Railway (backend + DB)
APIs externas	Jolpica-F1 + OpenF1

Instalación

Prerrequisitos

• Node.js 20+
• PostgreSQL 15+
• npm o pnpm

Setup

# Clonar el repositorio
git clone https://github.com/TomasPinolini/boxbox.git
cd boxbox

# Backend
cd backend
cp .env.example .env    # Configurar variables de entorno
npm install
npx prisma migrate dev  # Crear tablas en la base de datos
npm run dev              # Iniciar servidor en http://localhost:3000

# Frontend (en otra terminal)
cd frontend
cp .env.example .env    # Configurar variables de entorno
npm install
npm run dev             # Iniciar app en http://localhost:5173

Variables de entorno

Se incluyen archivos .env.example en cada directorio (/backend y /frontend) con las variables necesarias. Copiar a .env y completar con los valores correspondientes.

Backend: URL de la base de datos, secretos JWT, URLs de APIs externas (Jolpica, OpenF1), puerto del servidor.

Frontend: URL de la API del backend, URL del WebSocket.

Documentación

La documentación del proyecto se encuentra en el directorio /docs:

• Propuesta del TP
• Modelo de datos (Mermaid)
• Endpoints de la API
• Minutas de reunión

Integrantes

Legajo	Nombre
XXXXX	Apellido(s), Nombre(s)
XXXXX	Apellido(s), Nombre(s)

Gestión del Proyecto

• Metodología: Kanban
• Herramienta de tracking: GitHub Projects
• Repositorio: github.com/TomasPinolini/boxbox