Especificación Técnica
Catálogo público y versionado de los requisitos funcionales y no funcionales de la plataforma Torneyo, citable en estudios técnicos y pliegos.
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.10.06 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 — 14 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
- Tres tipos de grupo, que ajustan la nomenclatura y las pantallas: escuela (escuela deportiva con clases, franjas de edad y responsables), clase suelta y partido entre amigos; conversión de una clase suelta o un partido entre amigos en escuela completa sin perder alumnos ni historial.
- Clases con profesor, franja de edad, límite de plazas y horario propio para cada día de la semana; vínculo opcional de la clase con un equipo de competición.
- Invitación por enlace (enlace abierto o invitaciones individuales por correo, con validez y número máximo de usos, revocables): quien entra queda matriculado en el momento, si hay plaza, o pasa a la lista de espera, con su posición informada.
- Lista de espera con promoción automática: al liberarse una matrícula, el primero de la lista es matriculado y avisado; promoción y retiro manuales por el gestor.
- Configuración de matrícula: validez en meses, aviso previo de vencimiento, tolerancia en días antes del bloqueo de la participación, límite de actividades por alumno y exigencia opcional de PAR-Q aprobado para matricular.
- Pase de lista electrónico, incluso sin conexión en la aplicación móvil (registro local con sincronización automática al restablecerse la conexión).
- Encuentros con confirmación de asistencia por enlace: el gestor abre el encuentro (fecha, horario y plazo de respuesta) y los participantes responden “voy” o “no voy” por un enlace público, sin iniciar sesión.
- Rankings de la clase por mes, año o todo el período: asistencia (días de pase de lista con presencia) y cumplimiento de la confirmación (confirmó y asistió / confirmó y faltó).
- En la clase suelta y el partido entre amigos: evaluación entre participantes (nota de 1 a 5, un voto por compañero por mes), sorteo de equipos equilibrados a partir de las evaluaciones y la asistencia reciente, con historial de sorteos, y reparto de gastos puntuales entre los presentes, con control de quién pagó.
- Ficha de inscripción del alumno en PDF; evaluaciones técnicas del alumno; suspensión de la clase de un día, con el motivo registrado.
- Área del atleta: el participante matriculado consulta sus clases, los próximos encuentros, los sorteos, los rankings y sus propias cuotas.
- Cuotas mensuales, becas de descuento y recordatorios de cobro (ver Finanzas).
Formularios, PAR-Q y ficha médica
- Cuestionario PAR-Q (Physical Activity Readiness Questionnaire) con las 7 preguntas oficiales, ampliable con hasta 10 preguntas propias de la organización.
- Ficha médica estándar (tipo de sangre, alergias, medicamentos de uso continuo, condiciones de salud, seguro médico y contacto de emergencia) y formularios personalizados, con preguntas de respuesta Sí/No o texto libre, obligatorias u opcionales.
- Respuestas registradas en la ficha del alumno y vinculadas al atleta, aplicables a la matrícula en clases; exigencia configurable de PAR-Q aprobado y vigente para matricular y para promover desde la lista de espera.
- Control de validez de las respuestas, con aviso de vencimiento por correo.
- Adjunto del formulario firmado (digitalizado) y flujo de aprobación o rechazo motivado por la organización.
- La ficha médica aprobada y vigente se incluye en la ficha de inscripción del alumno en PDF, con el contacto de emergencia destacado.
Reserva de espacios
- Registro de lugares y espacios (canchas, campos, salas) con fotos, modalidades, horario de funcionamiento por día de la semana y página pública.
- Precio por período (duración del período configurable), antelación mínima y máxima, límite de reservas activas por usuario y reserva gratuita cuando no hay precio.
- Autoservicio en el sitio, sin registro: elección del día y del horario libre y confirmación con un código de verificación enviado por correo; también por la plataforma web y la aplicación, con seguimiento de las propias reservas.
- Aprobación manual o automática de las reservas gratuitas, según la configuración de la organización; pago en línea con tarjeta al reservar los espacios de pago, con plazo de pago y liberación automática del horario no pagado.
- Reservas cargadas por el gestor, incluida la reserva fija semanal; rechazo automático de reservas fuera del horario de funcionamiento, fuera de la antelación permitida o en conflicto con un partido, una clase u otra reserva.
- Cancelación por quien reservó (hasta la antelación configurada) o por el gestor, con reembolso automático del importe pagado; avisos por correo y recordatorio antes del horario reservado.
- Ficha de reserva en PDF con código QR, validable en la portería con la lectura del código en la aplicación móvil.
Agenda institucional
- Eventos institucionales (competición, reunión, capacitación, evento público, mantenimiento y otros), de día completo o con horario, de varios días si hace falta y con vínculo opcional a un lugar, un campeonato y una clase.
- Vista consolidada en un solo calendario de eventos, partidos programados, reservas confirmadas y clases, en las vistas mes y lista, con filtros por origen y por tipo de evento y búsqueda.
- Calendario público en el sitio de la organización, con los eventos marcados para publicación y los campeonatos públicos.
- Exportación en iCalendar (.ics) del mes, para importar en Google Calendar, Outlook y otras aplicaciones de calendario.
Almacén
- Registro de materiales con categoría, unidad de medida, talla, color, marca, modelo, SKU y stock mínimo, y de ubicaciones de almacenamiento con responsable.
- Movimientos (entrada, salida, transferencia, ajuste, pérdida, préstamo y devolución), con el saldo calculado a partir de ellos, bloqueo de saldo negativo y ubicaciones bloqueadas para retiro.
- Préstamos a atletas con fecha prevista de devolución e indicación de atraso.
- Control por número de serie, con la condición y la ubicación de cada unidad.
- Registro de proveedores, con factura/compromiso y valor en las entradas.
- 4 informes: inventario por ubicación, movimientos, préstamos por persona y entradas por proveedor.
Finanzas
- Cobro de inscripciones de equipos y atletas.
- Cuotas mensuales por escuela: generación de las cuotas del mes (una por alumno activo, sin duplicar), actualización automática de la situación (pendiente, atrasada, vencida) y multa, intereses diarios y descuento por pago puntual aplicados según la fecha del pago.
- Becas de descuento por alumno (integral, parcial, porcentual o valor fijo) con período de validez; segunda vía del enlace de pago; recordatorios de cobro al responsable antes y después del vencimiento; portal del responsable para consulta y pago en línea; panel de morosidad con exportación a planilla.
- Pagos en línea vía pasarela con transferencia directa a la cuenta conectada de la organización (la plataforma no retiene valores de terceros), además de registro manual de pagos.
- Control de transacciones, suscripciones de planes y límites por plan contratado.
Beca Atleta
- Registro de becas pagadas por la organización al atleta: programa, modalidad, valor mensual, vigencia y asistencia mínima exigida.
- Rendición de cuentas mensual con asistencia calculada automáticamente a partir del pase de lista de las clases del propio atleta (o informada manualmente) y comprobante adjunto, con aprobación o rechazo motivado.
- Registro y confirmación de pagos por período de referencia, con cola de aprobación y separación entre quien registra y quien aprueba.
- Suspensión automática de la beca por asistencia inferior a la mínima, aviso de fin de vigencia y expiración automática.
- Informe de rendición de cuentas mensual por becario, con totales.
Informes
- 18 plantillas listas: goleadores, mejor defensa, clasificación, equipos registrados, atletas por categoría/equipo/campeonato, tarjetas, resumen del campeonato, partidos, agenda de partidos, demografía, rendición de cuentas de la Beca Atleta, los 4 informes del almacén 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.
- Portabilidad: exportación integral de los datos de la organización, solicitada por el propietario en cualquier momento, en formato abierto (CSV, JSON y XML, con diccionario de datos).
- 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 de acceso por organización: propietario, administrador, gestor, operador y financiero, con permisos definidos por perfil — ver Organizaciones, miembros y permisos.
- API de datos con claves de acceso por alcance (organización, campeonatos, goleadores y estadísticas, equipos y atletas, escuelas y agenda), creadas y revocadas por la 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.10.06. 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.10.06.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 (el de la versión 2026.08.18 sigue en /downloads/especificacao-tecnica-v2026.08.18.pdf).
Historial de revisiones
| Versión | Fecha | Cambios |
|---|---|---|
| 2026.10.06 | 06/10/2026 | Nuevos grupos Agenda institucional, Almacén y Beca Atleta. Escuelas y clases: tipos (escuela, clase suelta, partido entre amigos), invitación por enlace, horario por día de la semana, encuentros con confirmación, rankings, sorteo de equipos, evaluación entre participantes, reparto de gastos y área del atleta. Cuotas: multa, intereses y descuento por pago puntual, becas, segunda vía, recordatorios y portal del responsable. Reserva de espacios: autoservicio sin registro, aprobación y reembolso. Formularios: corrige los tipos de respuesta (Sí/No y texto libre) y el alcance (matrícula en clases) e incluye la ficha médica. Informes: 18 modelos. No funcionales: perfiles de acceso, exportación integral y API con claves por alcance (PDF solo en portugués). |
| 2026.08.18 | 18/08/2026 | Versión inicial del documento (PDF solo en portugués). |