LigaPro — plataforma para ligas deportivas amateur

Creado por CMD Tech. Prototipo funcional de una plataforma tipo "Liga del Rey / Zione", pero pensada como producto white-label: cada liga cliente tiene su propia marca (nombre, colores, logo), puede organizar varias divisiones y torneos con distintos sistemas de competencia, y el historial de cada jugador y equipo viaja con ellos a través de divisiones, torneos e incluso otras ligas de la plataforma — algo que las plataformas de referencia no ofrecen (su historial vive aislado dentro de cada liga/torneo).

Qué incluye este prototipo

• Multi-tenant real: cada liga vive en su propia ruta (/guadalupe, /centenario, ...) con sus colores y logo aplicados a toda la interfaz.
• Divisiones: cada liga puede tener varias divisiones (Primera, Segunda, ...), cada una con sus propios equipos y torneos.
• Torneos configurables por división: nombre, sistema (liga todos-contra- todos, fase de grupos, o eliminación directa) y cupo máximo de equipos. Los grupos se crean y se asignan equipos desde el panel admin.
• Tabla de posiciones y goleo calculados automáticamente por torneo (y por grupo, si el torneo usa fase de grupos).
• Estadísticas acumuladas a nivel de división y de liga completa (goles totales, partidos jugados, equipos y jugadores), sin importar en qué torneo o división hayan ocurrido.
• Jugadores y equipos globales: un jugador puede jugar en varios equipos a lo largo del tiempo, incluso en divisiones o ligas distintas, y su perfil (/jugador/[id]) suma su historial completo automáticamente.
• Panel de administración (/admin/<slug-de-tu-liga>) por liga, protegido con contraseña:
  • Editar marca (nombre, ciudad, logo, colores) con vista previa instantánea.
  • Crear divisiones y torneos (definiendo su sistema y cupo de equipos).
  • Crear equipos, cargar jugadores nuevos o sumar uno que ya juega en otro equipo de la misma liga (sin perder su historial).
  • Inscribir equipos a un torneo (y asignarlos a un grupo si aplica).
  • Programar partidos y capturar resultados, goleadores y convocatoria.
  • Logos, escudos y fotos se suben como archivo real (Vercel Blob), no como URL.
• Landing de la plataforma (/) con un formulario de "Solicitá tu liga" para clientes nuevos, y un panel privado (/admin/solicitudes) para ver esas solicitudes. /admin (sin liga) ya no lista las ligas existentes — solo pide el identificador de la que querés administrar, para no exponer qué clientes reales usan la plataforma.

Stack

• Next.js 16 (App Router, Server Actions) + TypeScript + Tailwind CSS
• Prisma ORM sobre PostgreSQL (Neon)

Cómo correrlo localmente

npm install
cp .env.example .env   # agrega tu propia cadena de conexión de Postgres
npx prisma migrate dev
npm run db:seed        # crea 2 ligas de ejemplo con divisiones, torneos y partidos
npm run dev

Abre http://localhost:3000.

• Ligas de ejemplo: /guadalupe (2 divisiones) y /centenario (1 división con fase de grupos).
• Admin de cada liga: /admin/guadalupe o /admin/centenario, contraseña demo1234 (definida por liga en el modelo League.adminPassword; en producción debe reemplazarse por autenticación real y contraseñas hasheadas).
• Panel de CMD Tech (solicitudes de clientes + alta de ligas nuevas): /admin/solicitudes, contraseña cmdtech2026 (o la que definas en la variable PLATFORM_ADMIN_PASSWORD). Ahí se crea cada liga cliente (identificador, contraseña) — es el único lugar para dar de alta una liga nueva, no hay otra forma de crearla desde la web.
• La primera vez que un admin de liga entra a su panel, ve un tour corto de bienvenida (se puede saltar); no vuelve a aparecer después.

Despliegue

El proyecto está desplegado en Vercel apuntando a una base de datos Postgres en Neon. Para que el build y el runtime funcionen ahí, configura en el proyecto de Vercel (Settings → Environment Variables) una variable DATABASE_URL con la cadena de conexión (pooled) de Neon.

La carga de logos, escudos y fotos usa Vercel Blob. Hace falta un Blob store conectado al proyecto (Storage → Create Database → Blob, acceso Public, con la opción "Add a read-write token env var to this connection" tildada) para que quede configurada la variable BLOB_READ_WRITE_TOKEN.

Cada solicitud del formulario "Solicitá tu liga" queda guardada en la base (visible en /admin/solicitudes) y, si está configurada la variable RESEND_API_KEY (cuenta en resend.com), además se envía un email de aviso a [email protected] (o a la dirección que definas en CONTACT_NOTIFY_EMAIL), enviado desde [email protected] (dominio verificado en Resend; se puede cambiar con RESEND_FROM_EMAIL).

Próximos pasos sugeridos para llevarlo a producción

• Autenticación real (hash de contraseñas, roles por liga, múltiples admins).
• Subdominios por liga (guadalupe.tuplataforma.com) en vez de /guadalupe.
• Registro de tarjetas (amarillas/rojas) y sanciones desde el panel admin.
• Generación automática de llaves/brackets para el formato de eliminación directa (hoy los partidos de cada etapa se programan manualmente).
• App/vista optimizada para móvil o app nativa, como la competencia.
• Roles: super-admin de la plataforma (tú) vs. admin de cada liga (tu cliente).