Glosario de términos canónicos¶
Qué es y por qué existe¶
Este documento es la fuente de verdad terminológica del ecosistema Open-TT. Todo término que se use en documentos de dominio, features o código debe estar definido aquí con un significado único y sin ambigüedad.
Si un término no está en este glosario, no se usa en documentos. Si se necesita un término nuevo, se añade aquí primero.
Términos¶
Conceptos del ecosistema¶
| Término | Definición |
|---|---|
| Open-TT | Ecosistema digital diseñado para la comunidad del tenis de mesa, compuesto por cinco pilares. |
| Pilar | Cada una de las cinco áreas funcionales del ecosistema: Gestión de Competiciones, Red Social, Contenido Experto, Marketplace y Reserva de Mesas. |
Gestión de Competiciones¶
| Término | Definición |
|---|---|
| Torneo | Evento competitivo acotado en el tiempo — con fecha de inicio y fecha de fin — que enfrenta a jugadores individuales o parejas de dobles, produce una clasificación final con al menos un ganador, y se celebra en una sede. Puede ser independiente o estar adscrito a un circuito. |
| Elo | Valor numérico que refleja el nivel competitivo de un jugador, recalculado tras cada partido. |
| Circuito | Estructura competitiva de largo plazo que agrupa torneos y gestiona temporadas sucesivas bajo una misma identidad y reglamento. Se mantiene activo indefinidamente. |
| Temporada | Instancia temporal dentro de un circuito, con fechas de inicio y fin, que define el sistema de puntuación y ranking para ese período. También denominada "edición". |
| Edición | Sinónimo de temporada. Término usado en la interfaz de la aplicación. |
| Segmento de torneos | Criterio que limita qué torneos computan para el ranking general de un circuito. Puede definirse por período de tiempo o por número de torneos recientes. |
| Simulador de puntuación | Herramienta de la plataforma que permite probar diferentes configuraciones de puntuación antes de aplicarlas a una temporada. |
| Ranking | Clasificación ordenada de jugadores basada en resultados o puntuación dentro de un contexto (circuito, torneo, global). |
| Factor K | Parámetro del sistema Elo que determina la magnitud máxima de variación del Elo tras un partido. Su valor disminuye a medida que el jugador acumula más partidos. |
| Marcador digital | Herramienta que registra los puntos y resultados de un partido en tiempo real. |
| Pareja de dobles | Entidad formada por dos jugadores que compite como una unidad en la modalidad de dobles, con su propio Elo independiente. Tiene dos estados: activa (puede inscribirse en torneos) e inactiva (conserva historial y Elo pero no puede competir). |
| Partido | Unidad atómica de competición. Enfrentamiento entre dos jugadores (o parejas de dobles) dentro de un torneo, compuesto por juegos. Se juega al mejor de X juegos (X impar, ≥ 3). → DOM-GC-007 |
| Sede | Ubicación física registrada en la plataforma donde se celebran torneos o se dispone de mesas. Puede ser pública (espacio abierto, cualquiera puede organizar torneos) o privada (requiere declaración de potestad del organizador). Incluye datos descriptivos como número de mesas disponibles. La gestión logística del espacio es responsabilidad del organizador del evento y ajena a la plataforma. Cualquier usuario puede crear una sede; requiere aprobación del administrador de plataforma. |
| Lista de espera | Conjunto de jugadores inscritos como reservas cuando se alcanza el máximo de participantes de un torneo. Ocupan un lugar en caso de baja. |
| Recepción | Estado del torneo en el que el organizador confirma la asistencia presencial de los jugadores inscritos antes de comenzar la competición. |
| Fase | Etapa de un torneo con su propio formato (grupos o cruces eliminatorios). Un torneo se compone de una o más fases secuenciales. |
| Cabeza de serie | Jugador posicionado estratégicamente en el cuadro o distribuido entre grupos por su Elo o clasificación previa, con el fin de equilibrar la competición. |
| Bye | Pase automático a la siguiente ronda en una fase de cruces eliminatorios cuando no hay rival asignado, típicamente porque el número de jugadores no es potencia de 2. |
| Cuadro | Estructura de emparejamientos en una fase de cruces eliminatorios. |
| Desempate | Conjunto de criterios ordenados para resolver empates de victorias en fase de grupos. |
| Juego | Unidad de puntuación dentro de un partido. Se gana al alcanzar 11 puntos con al menos 2 de diferencia. → DOM-GC-007 |
| Entrada manual | Modalidad de registro de resultados en la que los tanteos de cada juego se anotan fuera de la aplicación y se introducen después. No genera estadísticas detalladas. → DOM-GC-007 regla 3.2 |
| Racha | Cantidad de puntos consecutivos que un jugador gana sin que su oponente anote. |
| Remontada | Situación en la que un jugador supera una desventaja en el marcador y toma la delantera. |
| Ventana de Elo | Rango de Elo (mínimo y máximo) que define un torneo como requisito de inscripción. Es obligatoria en la configuración de todo torneo. |
| Servicio | Acción de poner la pelota en juego al inicio de cada punto. Alterna entre jugadores cada dos puntos (cada punto en situación 10-10). → DOM-GC-007 regla 2.2 |
| Tiempo muerto | Pausa reglamentaria durante un partido que puede solicitar cada jugador (una por partido). |
Marketplace¶
| Término | Definición |
|---|---|
| Agregador de inventario | Herramienta de la plataforma que centraliza la disponibilidad y precios de material de tenis de mesa en tiendas externas. No vende directamente — redirige al usuario a la tienda. |
| Catálogo de productos | Base de datos de productos de material de tenis de mesa mantenida por la plataforma, independiente de las tiendas. Cada producto tiene ficha técnica propia. |
| Tienda externa | Comercio (online o físico) ajeno a la plataforma que provee inventario al agregador y vende el producto al usuario final. |
| Fabricante | Empresa que produce material de tenis de mesa. Proporciona información técnica de producto al catálogo, de forma activa o pasiva. |
Actores¶
| Término | Definición |
|---|---|
| Jugador | Actor central del ecosistema. Compite en torneos, socializa, consume contenido, compra material y reserva mesas. |
| Entrenador | Actor que forma jugadores, ofrece mentorías y publica contenido experto. |
| Club | Entidad que organiza competiciones, gestiona mesas y agrupa jugadores. |
| Organizador | Cualquier usuario que crea un torneo asume el rol de organizador de ese torneo. Gestiona el ciclo de vida del torneo. En sedes privadas, declara que tiene potestad para organizar allí. |
| Administrador de sede | Usuario que gestiona los datos de una sede. El creador de la sede es su primer administrador y puede designar otros. En sedes privadas, puede suspender torneos no autorizados. |
| Administrador de plataforma | Rol con permisos globales sobre la plataforma. Aprueba sedes pendientes de validación y gestiona sedes huérfanas. |
| Árbitro | Actor que supervisa el desarrollo de partidos en un torneo. |
| Experto en material | Actor que publica reviews de equipamiento de tenis de mesa. |
| Vendedor profesional | Actor que opera en el marketplace ofreciendo material o servicios. |
| Espectador | Actor que consume contenido público sin participar activamente. |
| Tienda externa | Comercio ajeno a la plataforma que provee inventario al agregador y vende el producto al usuario final. |
| Fabricante | Empresa que produce material de tenis de mesa y proporciona información técnica de producto. |
Cuentas y perfiles¶
| Término | Definición |
|---|---|
| Cuenta de usuario | Identidad digital de una persona en la plataforma, compuesta por nombre, correo electrónico y contraseña. Independiente del perfil de jugador. |
| Perfil de jugador | Entidad asociada a una cuenta de usuario que habilita a una persona para participar en torneos. Contiene datos deportivos y de contacto. |
| Nickname | Identificador opcional y único del perfil de jugador, visible públicamente. Una vez que el jugador ha participado en un torneo, no se puede cambiar salvo solicitud excepcional a soporte. |
Otros conceptos¶
| Término | Definición |
|---|---|
| Marketplace | Pilar del ecosistema que agrupa todo lo relacionado con la adquisición de material y servicios de tenis de mesa, tanto dentro como fuera de la plataforma. Comprende tres sub-dominios: agregador de inventario, marketplace interno y servicios profesionales. |
| Mentoría | Relación de formación entre un jugador experimentado o entrenador y un jugador menos experimentado. |
Convenciones de uso¶
- Cuando un término del glosario aparece por primera vez en un documento, se escribe en negrita.
- Si alguien usa un sinónimo o término no canónico (ej: "puntuación" en lugar de "Elo", "competición" en lugar de "torneo"), se debe corregir al término canónico.
- Los términos se añaden al glosario antes de usarlos en documentos de dominio.
Referencias¶
- FND-001 — Visión del Ecosistema
- DOM-GC-001 — Sistema Elo
- DOM-GC-002 — Torneos: creación, configuración y ciclo de vida
- DOM-GC-003 — Torneos: fases, formatos y estructura competitiva
- DOM-GC-004 — Torneos: inscripción, bajas y recepción
- DOM-GC-005 — Circuitos y temporadas
- DOM-GC-006 — Marcador digital
- DOM-GC-007 — El partido: estructura y reglas
- DOM-MK-001 — Agregador de inventario
- DOM-TX-001 — Cuentas, perfiles y roles
- DOM-TX-002 — Sedes