Tournament Manager

Gestor de torneos de padel con arquitectura fullstack:

• frontend/: Next.js + TypeScript
• backend/: Node.js + Express + TypeScript
• db: PostgreSQL

Funcionalidades

• Crear torneo
• Inscribir jugadores
• Ver tabla de posiciones por torneo
• Ver ranking global de jugadores

Endpoints backend

• POST /tournaments
• GET /tournaments
• POST /players
• GET /players
• POST /registrations
• GET /registrations
• GET /tournaments/:id/standings
• GET /players/ranking

Swagger

• Backend Swagger UI: http://localhost:4000/api-docs
• Frontend docs page (embeds Swagger): http://localhost:3000/docs

Rutas frontend

• GET /
• GET /tournaments
• GET /tournaments/new
• GET /tournaments/:id/standings
• GET /players
• GET /players/new
• GET /players/ranking
• GET /registrations
• GET /registrations/new
• GET /docs

Postman

• Backend collection: postman/tournament-manager.postman_collection.json
• Frontend routes collection: postman/tournament-manager-frontend.postman_collection.json
• Recommended backend execution order:
  1. POST /players (sets playerId)
  2. POST /tournaments (sets tournamentId)
  3. POST /registrations
  4. GET /tournaments/:id/standings
  5. GET /players/ranking

Correr con Docker (recomendado)

Desde la raiz:

docker compose up --build

Aplicaciones:

• Frontend: http://localhost:3000
• Backend: http://localhost:4000

Correr local sin Docker

1. Instalar dependencias en la raiz:

npm install

2. Crear variables:

• backend/.env usando backend/.env.example
• frontend/.env.local usando frontend/.env.example

3. Correr backend:

npm run dev:backend

4. Correr frontend:

npm run dev:frontend

Tests

Backend (Jest + Supertest):

npm run test:backend

Frontend (React Testing Library):

npm run test:frontend