# Manual de Usuario Oficial - SkateScore Pro
**Sistema Integral de Juzgamiento y Gestión de Patinaje Artístico sobre Ruedas (World Skate)**

---

## 📋 Índice General
1. [Introducción y Arquitectura del Sistema](#1-introducción-y-arquitectura-del-sistema)
2. [Guía para el Organizador (Administrador del Evento)](#2-guía-para-el-organizador)
   - [2.1 Registro, Selección de Plan y Pago (Mercado Pago)](#21-registro-selección-de-plan-y-pago)
   - [2.2 Configuración del Torneo y Creación de Credenciales / PINs](#22-configuración-del-torneo)
   - [2.3 Configuración de Reglas, Factores PCS y Deducciones](#23-configuración-de-reglas-factores-pcs-y-deducciones)
3. [Guía para el Operador de Datos (Data Operator)](#3-guía-para-el-operador-de-datos)
   - [3.1 Carga de Lista de Buena Fe y Cronograma](#31-carga-de-lista-de-buena-fe-y-cronograma)
   - [3.2 Control de Pista y Navegación entre Patinadores](#32-control-de-pista-y-navegación-entre-patinadores)
4. [Guía para el Panel de Jueces (Juez 1 al Juez 9)](#4-guía-para-el-panel-de-jueces)
   - [4.1 Acceso Rápido mediante PIN / Código QR](#41-acceso-rápido-mediante-pin--código-qr)
   - [4.2 Evaluación Técnica (TES): Elementos y Niveles](#42-evaluación-técnica-tes-elementos-y-niveles)
   - [4.3 Evaluación Artística (PCS): Componentes Programáticos](#43-evaluación-artística-pcs-componentes-programáticos)
   - [4.4 Envío y Confirmación de Planilla](#44-envío-y-confirmación-de-planilla)
5. [Guía para el Árbitro Principal (Referee)](#5-guía-para-el-árbitro-principal)
   - [5.1 Supervisión de Votos y Promedio Recortado (Trimmed Mean)](#51-supervisión-de-votos-y-promedio-recortado)
   - [5.2 Panel de Deducciones en Tiempo Real](#52-panel-de-deducciones-en-tiempo-real)
   - [5.3 Validación Final y Publicación del Puntaje](#53-validación-final-y-publicación-del-puntaje)
6. [Guía para Live Display y OBS Overlay (Transmisión)](#6-guía-para-live-display-y-obs-overlay)
7. [Matriz de Solución de Problemas Frecuentes (Troubleshooting)](#7-matriz-de-solución-de-problemas-frecuentes)

---

## 1. Introducción y Arquitectura del Sistema

**SkateScore Pro** es una plataforma web de alto rendimiento diseñada bajo los **reglamentos mundiales oficiales actualizados (World Skate)**. Su propósito es automatizar y simplificar el proceso de evaluación en torneos de patinaje artístico sobre ruedas, garantizando precisión en el cálculo, velocidad en los resultados y transparencia total.

### Perfiles de Usuario
El sistema opera mediante 4 roles perfectamente diferenciados:
* **Organizador:** Administra la suscripción, crea eventos, configura la mesa de jueces y define parámetros de reglas.
* **Operador de Datos:** Gestiona el orden de salida, los deportistas en pista y el flujo de la competencia.
* **Jueces (Hasta 9 por panel):** Evalúan los elementos técnicos (TES) y los componentes artísticos (PCS) desde cualquier dispositivo móvil o tablet.
* **Árbitro Principal (Referee):** Revisa y valida las planillas, aplica deducciones (caídas, tiempo, vestuario) y aprueba la publicación del resultado.

---

## 2. Guía para el Organizador

### 2.1 Registro, Selección de Plan y Pago
1. Ingrese a la plataforma y presione **"Iniciar sesión"** o **"Registrate"**.
2. Seleccione la pestaña **Organizador** e inicie sesión con su casilla de correo institucional o mediante **Continuar con Google**.
3. Si su cuenta no registra un pago activo, el sistema restringirá el acceso al panel y desplegará la pantalla de selección de planes:
   - **Plan Por Torneo ($75.000 ARS el primer día + $45.000 ARS por día adicional):** Ideal para eventos zonales o de un día. Permite ajustar la cantidad de jornadas.
   - **Plan Anual Ilimitado ($650.000 ARS / año):** Diseñado para clubes, ligas y eventos con múltiples competencias anuales.
4. Presione **"Pagar con Mercado Pago"**. Será redirigido a la pasarela segura. Una vez acreditado el pago en Pesos Argentinos, la cuenta se activará automáticamente y podrá ingresar.

### 2.2 Configuración del Torneo
1. Diríjase a **"Panel de Control" > "Nuevo Torneo"**.
2. Complete el nombre de la competencia, fecha, lugar y liga organizadora.
3. Defina el tamaño del panel de jueces (Soporta desde **1 hasta 9 jueces** en simultáneo).
4. El sistema generará automáticamente un **PIN de Torneo** y un **Código QR de acceso directo** para los jueces y autoridades.

### 2.3 Configuración de Reglas, Factores PCS y Deducciones
1. En el menú superior, ingrese a **"Reglas del Torneo"**.
2. **Factores PCS:** Establezca el multiplicador para las 4 notas artísticas (*Habilidades de Patinaje*, *Transiciones*, *Presentación*, *Coreografía*) según la categoría (ej. Senior = 1.6, Cadet = 1.0).
3. **Valor de Caída:** Seleccione el valor reglamentario para las penalizaciones por caída (`-1.0` punto para categorías nacionales/internacionales o `-0.5` para categorías promocionales/formativas).

---

## 3. Guía para el Operador de Datos

### 3.1 Carga de Lista de Buena Fe y Cronograma
1. Ingrese al panel con su credencial o PIN de Operador asignado.
2. Cargue a los patinadores manualmente o mediante importación de archivo CSV/Excel con las siguientes columnas: `Nombre`, `Club/País`, `Categoría`, `Disciplina`, `Programa (Corto/Largo/Único)`.

### 3.2 Control de Pista
1. En la pantalla **"Mesa de Control"**, visualizará el orden de salida.
2. Para llamar a un deportista a pista, presione **"Llamar a Pista"**. Este cambio actualizará de inmediato las pantallas de todos los jueces, del árbitro y del Live Display.
3. Una vez finalizada la rutina y aprobado el resultado por el árbitro, presione **"Siguiente Patinador"**.

---

## 4. Guía para el Panel de Jueces

### 4.1 Acceso Rápido mediante PIN / Código QR
1. Desde la tablet o teléfono móvil del juez, escanee el **Código QR** provisto por la organización o ingrese a la web y elija la pestaña **"Juez (PIN / QR)"**.
2. Ingrese el PIN de la competencia y seleccione el número de juez asignado (ej. **Juez 3**). No requiere contraseña ni registro previo.

### 4.2 Evaluación Técnica (TES)
1. En la pantalla principal observará la lista de elementos según la disciplina configurada (Cuartetos, Libre, Solo Dance, Parejas, Precisión).
2. Seleccione el elemento ejecutado (ej. *Tr - Travelling* o *1A - Single Axel*).
3. Seleccione el **Nivel otorgado** (Base, Level 1, Level 2, Level 3, Level 4) o la bonificación/penalización por calidad de ejecución (**GOE de -3 a +3**).
4. El sistema calculará en tiempo real el valor base + ajuste según el catálogo oficial World Skate 2026.

### 4.3 Evaluación Artística (PCS)
1. Ingrese a la pestaña **"Componentes Programáticos"**.
2. Evalúe de **0.25 a 10.00** (en incrementos de 0.25) los cuatro criterios internacionales:
   - **Habilidades de Patinaje (Skating Skills)**
   - **Transiciones (Transitions)**
   - **Presentación / Ejecución (Performance)**
   - **Coreografía / Composición (Choreography)**

### 4.4 Envío de Planilla
Una vez completada la rutina, verifique los datos y presione el botón verde **"Enviar Planilla"**. El estado cambiará a *"Enviado"* y quedará bloqueado a la espera de la revisión del árbitro.

---

## 5. Guía para el Árbitro Principal (Referee)

### 5.1 Supervisión de Votos y Promedio Recortado (Trimmed Mean)
1. Abra la consola de **Árbitro (Referee Panel)**.
2. Visualizará en tiempo real los votos individuales emitidos por los jueces (del Juez 1 al 9).
3. **Cálculo Automático (Trimmed Mean):** Cuando el panel cuenta con 7 o 9 jueces, el motor de SkateScore Pro descarta automáticamente la nota más alta y la más baja de cada criterio antes de promediar, evitando distorsiones en el resultado final.

### 5.2 Panel de Deducciones
Aplique los ajustes reglamentarios directamente desde los botones de acceso rápido:
- **Caída (Fall):** Aplica la penalización configurada (`-1.0` o `-0.5` por clic).
- **Exceso / Falta de Tiempo:** `-1.0` pto.
- **Vestuario / Equipamiento:** `-1.0` pto.
- **Infracción Musical / Patrón / Falta:** Ajustes configurables según el reglamento de la categoría.

### 5.3 Validación y Publicación
1. Revise el desglose en vivo: `Total = TES + PCS - Deducciones`.
2. Presione **"Validar y Autorizar Puntaje"**. Los resultados se consolidan y se transmiten automáticamente al Live Display y a las planillas oficiales.

---

## 6. Guía para Live Display y OBS Overlay

### 6.1 Display Presencial en Pista (`/live-display`)
Abra la dirección `/live-display` en la computadora conectada a la pantalla gigante o proyector del gimnasio. La pantalla mostrará de forma transparente y elegante la información del deportista en pista y los puntajes oficiales apenas sean validados.

### 6.2 Overlay Transparente para Transmisiones OBS / vMix (`/live-overlay`)
1. Para transmisiones en vivo vía YouTube, Twitch o Facebook Live, copie la URL `/live-overlay` desde el panel de control.
2. En **OBS Studio**, agregue una nueva fuente tipo **Navegador (Browser Source)**.
3. Pegue la URL del overlay y configure la resolución a `1920x1080`.
4. active la casilla **"Fondo Transparente"**. Los zócalos de puntaje y el desglose de notas aparecerán automáticamente sobre la imagen de la cámara en tiempo real.

---

## 7. Matriz de Solución de Problemas Frecuentes

| Problema | Causa Probable | Solución Paso a Paso |
| :--- | :--- | :--- |
| **El Organizador no puede ingresar.** | La suscripción no está activa o expiró. | Diríjase a la sección de planes, seleccione Mercado Pago y complete el pago en pesos para habilitar el acceso. |
| **Un Juez no visualiza la pantalla de votación.** | Seleccionó un número de juez equivocado o perdió conexión. | Verifique que no haya dos tablets con el mismo número de Juez. Refresque la pantalla; los datos guardados no se pierden. |
| **El Live Display no actualiza los resultados.** | El Árbitro no ha presionado "Validar Puntaje". | El Live Display solo muestra resultados confirmados por la autoridad del torneo para evitar mostrar notas preliminares. |
| **El valor del elemento no coincide con el esperado.** | Se aplicó una regla de categoría distinta o nivel base. | Revise en el panel de "Reglas" que el factor de la categoría activa corresponda al reglamento de la disciplina. |

---
*SkateScore Pro - Sistema Oficial de Juzgamiento Deportivo.*