⚽ StreetPlayer
Red social deportiva para jugadores de calle: organiza pichangas, sube XP,
forma equipos, lanza retos y domina el ranking de tu ciudad.
Stack: Node.js + Express + PostgreSQL + Socket.IO · React 18 + Vite + Tailwind
Estructura
streetplayer/
├── backend/ API REST + WebSockets + crons (Express, puerto 4000)
│ └── src/
│ ├── controllers/ Lógica de cada dominio (auth, eventos, torneos…)
│ ├── routes/ Rutas + validación (express-validator)
│ ├── middleware/ auth (JWT), validate, asyncHandler
│ ├── services/ XP, medallas, notificaciones, mailer, crons
│ ├── db/ schema.sql + migraciones (corren solas al arrancar)
│ └── config/ env (validación), cors, database (pool pg)
└── frontend/ SPA React (Vite, puerto 5173)
└── src/
├── pages/ Una carpeta por dominio; /admin = panel completo
├── components/ UI compartida (AuthShell, Avatar, UploadFoto…)
├── services/ api (axios + renovación de tokens), socket, authStorage
├── context/ AuthContext (sesión)
└── styles/ brand.js (tokens de marca) + Tailwind
Desarrollo local
Requisitos: Node 18+, PostgreSQL 14+ corriendo.
# 1. Instalar todo
npm run install:all
# 2. Configurar variables (copiar y editar)
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
# 3. Levantar backend + frontend juntos
npm run dev
- App: http://localhost:5173 · Panel admin: http://localhost:5173/admin
- Las migraciones de BD corren automáticamente al arrancar el backend.
- El usuario admin se crea/actualiza al arrancar con
ADMIN_EMAIL / ADMIN_PASSWORD.
- Sin SMTP configurado, los emails (recuperación de contraseña) se imprimen en consola.
- Sin Cloudinary configurado, las fotos se guardan en
backend/uploads/ (solo desarrollo).
Autenticación
- Access token JWT (15 min) + refresh token opaco rotativo (30 días), hasheado en BD.
- Renovación silenciosa vía interceptor de axios; logout revoca el refresh token.
- Recuperación de contraseña: código de 6 dígitos por email, 15 min, un solo uso;
al cambiarla se revocan todas las sesiones.
- Login con Google/Facebook vía Firebase (requiere
FIREBASE_* en backend y VITE_FIREBASE_* en frontend).
- Anti fuerza bruta: 10 intentos/15 min en endpoints de credenciales (solo producción).
Despliegue
| Pieza | Plataforma | Notas |
|---|
| Backend | Render (render.yaml) | Health check en /health. Variables requeridas en producción: DATABASE_URL, JWT_SECRET, ADMIN_PASSWORD, ALLOWED_ORIGINS. Recomendadas: FIREBASE_*, SMTP_*, CLOUDINARY_* (sin Cloudinary las fotos se pierden en cada deploy: el disco de Render es efímero). |
| Frontend | Vercel (frontend/vercel.json) | Definir VITE_BACKEND_URL y VITE_FIREBASE_*. |
| Base de datos | Neon / Render PostgreSQL | Las migraciones son idempotentes y corren al arrancar. |
⚠️ El backend asume una sola instancia (crons in-process y Socket.IO en memoria).
Antes de escalar horizontalmente: adapter de Redis para Socket.IO y mover crons a un worker.
