Especificación Técnica

Este documento describe, de forma pública, abierta y versionada, las capacidades funcionales y no funcionales de la plataforma Torneyo (torneyo.com y app.torneyo.com). Puede citarse en estudios técnicos preliminares, términos de referencia, estudios de mercado y procesos de contratación: cualquier interesado tiene acceso al mismo contenido, en las mismas condiciones, sin registro. Cada versión publicada tiene un PDF inmutable en una URL permanente (ver Versionado).

Nota: el PDF de la versión 2026.08.18 está disponible solo en portugués. La página web que estás leyendo se mantiene en portugués, inglés y español.

Visión general de la solución

• Software como servicio (SaaS) 100% web, alojado en la nube, sin instalación local, accesible desde el navegador en computadoras, tablets y smartphones (interfaz responsiva).
• Aplicación móvil (Android e iOS) para operar en cancha: agenda, acta, pase de lista — incluso sin conexión, con sincronización automática — cuotas, clases y validación de reservas.
• Multi-tenant por organización: cada organización tiene sus propios datos, miembros, perfiles y permisos de acceso; un mismo usuario puede pertenecer a varias organizaciones.
• La interfaz en los tres frentes (web de gestión, sitio público y aplicación) está disponible en portugués, inglés y español.

Requisitos funcionales

Gestión de competiciones

• Creación y gestión de campeonatos en múltiples deportes (deportes colectivos, individuales, pruebas de tiempo/marca y esports), con categorías por sexo y franja etaria.
• Formatos de competición: fase de grupos, todos contra todos, eliminación simple, eliminación doble, sistema suizo, formato GSL, divisiones dentro de una misma fase (p. ej. Oro/Plata/Bronce) y torneo relámpago (creación rápida en un día).
• Sorteo y cuadro (bracket): sorteo de grupos y asignación de equipos, generación automática de llaves, con posibilidad de reiniciar el sorteo antes del inicio.
• Fixture automático: generación de jornadas y partidos, grilla de horarios por sede y detección de conflictos de agenda.
• Clasificación en tiempo real, con criterios de desempate configurables por fase — 11 criterios ordenables por prioridad (puntos, victorias, diferencia de goles, goles a favor, enfrentamiento directo, disciplina, sorteo, entre otros).
• Acta digital con plantillas configurables (acta de eventos, marcador simple y formulario en blanco para llenado manual), registro de goles, tarjetas, sustituciones y alineaciones; carga del acta firmada escaneada, con descarga disponible en la página pública del partido.
• Goleadores, ranking de tarjetas y estadísticas por atleta y por equipo.
• Sanciones y suspensiones: registro de sanciones disciplinarias y suspensión automática por acumulación de tarjetas o expulsión, con bloqueo del atleta suspendido en la alineación.
• Simulador de resultados: proyección de la clasificación a partir de marcadores hipotéticos, sin alterar los resultados oficiales — disponible también en la página pública.
• Arbitraje: registro de árbitros y designaciones por partido.
• Transmisiones: vínculo de transmisiones en vivo a los partidos (YouTube, Twitch, Kick, Instagram y Facebook) y galería de videos.
• Pruebas de tiempo y marca (atletismo, natación y afines): pruebas con series y carriles, inscripción por prueba, registro de resultados por carril, detección automática de récords (tiempo, distancia, peso y puntos) y clasificación por prueba.
• Medallero calculado automáticamente por categoría y por prueba, con podio y premiaciones (trofeos, medallas y otras).

Registros e inscripciones

• Registro centralizado de atletas con documento de identificación único, foto, historial de participación y perfil consultable.
• Documentos del atleta con flujo de aprobación (envío, revisión y aprobación/rechazo por tipo de documento).
• Registro de equipos con plantel por categoría, cuerpo técnico con funciones y escudo.
• Inscripción en línea de equipos y atletas con flujo de aprobación (aceptación o rechazo por la organización) e invitaciones de inscripción.
• Credencial (carnet) con código QR por atleta y check-in de partido desde la plataforma web, con verificación pública de la credencial.

Escuelas deportivas y clases

• Gestión de escuelas deportivas: clases con profesor, franja etaria y límite de cupos.
• Pase de lista electrónico, incluso sin conexión en la aplicación móvil (registro local con sincronización automática al recuperar la conexión).
• Lista de espera con promoción automática: al liberarse un cupo, el siguiente de la fila es promovido y el responsable recibe una notificación.
• Configuración de matrícula: validez en meses, aviso previo de vencimiento, tolerancia en días antes del bloqueo de participación y límite de actividades por alumno.
• Ficha de inscripción del alumno en PDF.
• Evaluaciones técnicas del alumno y suspensiones de clase.
• Cuotas con recurrencia configurable, becas y descuentos (ver Finanzas).

Formularios y PAR-Q

• Cuestionario PAR-Q (Physical Activity Readiness Questionnaire) con las preguntas oficiales, ampliable con preguntas propias de la organización.
• Formularios personalizados con tipos de respuesta variados, aplicables a la matrícula y a la inscripción.
• Control de validez de las respuestas y exigencia configurable (p. ej. PAR-Q obligatorio en la matrícula).
• Adjunto del formulario firmado (escaneado) con flujo de aprobación por la organización.

Reserva de espacios

• Registro de sedes y espacios (canchas, campos, salas) con fotos, horarios de funcionamiento y página pública.
• Agenda integrada con prevención de conflictos entre reservas, partidos y demás compromisos del espacio.
• Autoservicio: reserva en línea por el propio interesado, con pago en línea al reservar (ver pasarelas en Finanzas) o reserva gratuita, según configuración.
• Comprobante de reserva en PDF con código QR, validable en portería leyendo el código con la aplicación móvil.

Portal público y difusión

• Sitio público de resultados por campeonato y por organización, con URL personalizada (slug) verificable, sin necesidad de iniciar sesión para consultar.
• Fixture, clasificación, goleadores, estadísticas, medallero y récords publicados automáticamente a partir de la operación.
• Noticias, galería de fotos y videos y encuestas con votación pública.
• Tarjetas para redes sociales generadas automáticamente (jornada, resultado, clasificación, inscripciones abiertas, campeón, agenda, equipos), listas para publicar.
• API pública en JSON para campeonatos, clasificación, partidos, goleadores y estadísticas; widgets embebibles de clasificación, partidos y goleadores con código de incrustación generado por la plataforma; API autenticada por clave con alcances de acceso para integraciones externas.
• Metadatos de compartición (Open Graph) en las páginas públicas.

Finanzas

• Cobro de inscripciones de equipos y atletas.
• Cuotas mensuales con recurrencia configurable, becas y descuentos por alumno.
• Pagos en línea vía pasarela con transferencia a la organización (cuenta conectada) o cobro por la cuenta de la plataforma, además de registro manual de pagos.
• Control de transacciones, suscripciones de planes y límites por plan contratado.

Informes

• 12 plantillas listas: goleadores, mejor defensa, clasificación, equipos registrados, atletas por categoría/equipo/campeonato, tarjetas, resumen del campeonato, partidos, agenda de partidos e informe personalizado (constructor con selección libre de campos).
• Exportación a PDF, CSV, XLSX, HTML y PNG.

Requisitos no funcionales

• Nivel de servicio: SLA formal público con clasificación de severidades (S1–S4), plazos de respuesta y de solución — ver el Acuerdo de Nivel de Servicio.
• Disponibilidad objetivo del 99,0% mensual, medida por monitoreo externo independiente con historial público y auditable en la página de estado: torneyo.com/status.
• Protección de datos (LGPD): tratamiento de datos personales a lo largo de su ciclo de vida, con desactivación lógica de registros (soft delete) — ningún dato se destruye de forma irrecuperable por una operación común de eliminación — y marcas de fecha de creación y actualización en todos los registros.
• Autenticación y seguridad: autenticación por token JWT; inicio de sesión social OAuth2 (Google); doble factor de autenticación por aplicación de autenticación (TOTP) o código por correo, con códigos de respaldo; perfiles y permisos por organización.
• Registro de auditoría: registro de eventos de auditoría (creación, actualización, desactivación, exportación, inicio/cierre de sesión) con consulta por administradores.
• Copias de seguridad periódicas de la base de datos y almacenamiento de archivos en un servicio de objetos redundante.
• Documentación de API abierta (OpenAPI/Swagger): app.torneyo.com/swagger-ui.html.
• Infraestructura en la nube con publicación continua de actualizaciones, sin ventana de parada para actualizaciones rutinarias.
• Notificaciones multicanal: correo electrónico, push en la aplicación, notificaciones en el sistema y WhatsApp (API oficial), según configuración de la organización.

Versionado de este documento

Este documento sigue un versionado editorial en formato AAAA.MM.DD — la fecha de publicación de la revisión del documento. La versión vigente es la 2026.08.18. La plataforma evoluciona continuamente; esta especificación describe el conjunto de capacidades garantizado en la fecha de la revisión. Cada versión publicada genera un PDF inmutable en una URL permanente — el archivo de esta versión está en /downloads/especificacao-tecnica-v2026.08.18.pdf y no se altera después de la publicación, lo que permite citar la versión exacta consultada en un estudio técnico o pliego. Los cambios de contenido generan una nueva versión, registrada en el historial de abajo, sin eliminar los PDF anteriores.

Historial de revisiones

Versión	Fecha	Cambios
2026.08.18	18/08/2026	Versión inicial del documento (PDF solo en portugués).