Sportware — Documentación del Producto

Sportware es una plataforma SaaS multi-tenant para la gestión integral de clubes de pádel: torneos, inscripciones, clasificaciones, facturación y sitios web propios para cada club.

URL: https://sportware.dev

Tabla de Contenidos

Visión General del Producto
Módulos Principales
Roles y Accesos
Flujo Típico de Uso
Documentación Detallada

Visión General del Producto

Sportware resuelve la gestión completa de un club de pádel desde una sola plataforma:

Para los administradores: gestión de torneos, inscripciones, partidos, clasificaciones, facturación y el sitio web del club
Para los jugadores: inscripción online, seguimiento de partidos y resultados desde web o app móvil
Para el público: sitio web propio del club con información en tiempo real, torneos y tienda

Características Clave

Característica	Descripción
Multi-tenant	Cada club tiene su espacio aislado; un admin puede gestionar múltiples clubes
Sitio web por club	Cada club tiene su propio sitio en `slug.sportware.dev` o dominio propio
3 formatos de torneo	Round robin, eliminación directa, grupos + eliminación
Inscripciones online	Los jugadores se inscriben directamente desde la web o la app
Clasificaciones en vivo	Resultados y standings actualizados al instante
Modo TV	Pantalla de resultados en tiempo real para mostrar en el club
API REST + App móvil	Aplicación nativa iOS/Android con todas las funcionalidades
Facturación integrada	Gestión de facturas y pagos de membresías por club

Módulos Principales

1. Sitio Público

Presentación del producto, documentación, páginas legales y contacto. → Ver documentación

2. Torneos Públicos

Cualquier visitante puede consultar torneos, equipos, partidos, resultados y clasificaciones sin necesidad de cuenta. → Ver documentación

3. Panel de Administración

Centro de control para administradores de clubs y staff. Gestión completa de torneos, inscripciones, jugadores, facturación y configuración del club. → Ver documentación

4. Sitios de Clubes

Cada club tiene su propio sitio web público con torneos, contacto y tienda. → Ver documentación

5. API Móvil

API REST para la aplicación móvil y terceros. → Ver documentación

6. Ranking de Jugadores

Sistema de ranking interno de Sportware y ranking de temporada por puntos (AAP, FIP, Premier Padel). Actualmente visible solo en el panel de administración; diseñado para ser público en el futuro. → Ver documentación

Roles y Accesos

Rol	URL de Acceso	Qué puede hacer
Administrador completo (`full_admin`)	`/admin`	Gestiona toda la plataforma: todos los clubes, torneos, usuarios, facturación global
Staff de club (`club_staff`)	`/admin`	Gestiona únicamente su(s) club(s): torneos, inscripciones, jugadores
Jugador (`player`)	App móvil / API	Consulta torneos, se inscribe, ve sus partidos y resultados
Visitante	`/` y `/public/`	Navega el sitio público y los sitios de clubes sin necesidad de cuenta

Login único: https://sportware.dev/session/new enruta automáticamente al panel correcto según el rol.

Flujo Típico de Uso

Para un Club (nuevo cliente)

1. Sportware crea el club en la plataforma
2. El club recibe acceso de staff
3. El staff configura:
   - Datos del club (nombre, dirección, contacto, redes)
   - Pistas disponibles
   - Temporadas activas
4. El staff crea un torneo:
   - Define nombre, fechas, formato (round robin / eliminación / grupos)
   - Crea categorías (masculino, femenino, mixto, niveles)
   - Abre período de inscripción
5. Los jugadores se inscriben online (web o app)
6. El staff aprueba inscripciones y genera el cuadro de partidos
7. Durante el torneo: el staff registra resultados partido a partido
8. Las clasificaciones se actualizan automáticamente en tiempo real
9. El público puede seguirlo desde el sitio del club o el modo TV

Para un Jugador (nuevo usuario)

1. Entra en sportware.dev o en el sitio de su club
2. Ve los torneos disponibles
3. Se registra con su número de teléfono (OTP)
4. Busca torneo y selecciona categoría
5. Indica su pareja y envía solicitud de inscripción
6. Recibe confirmación cuando el staff aprueba
7. Ve su calendario de partidos en el portal o la app
8. Sigue sus resultados y clasificación en tiempo real

Documentación Detallada

Documentación actualizada el 1 de junio de 2026.