# Lanzamiento de una nueva aplicación para carreras

El RUFUS Race App se crea y se gestiona desde **RUFUS Cloud**. Cada instancia de la aplicación de carrera se comporta como un dispositivo virtual, con su propio ID de aplicación, token de acceso, ventana de caducidad e historial de sesiones.

Este artículo explica cómo lanzar una nueva aplicación de Race, gestionar su acceso y entender cómo funcionan las sesiones y la rotación de tokens.

## Dónde crear una aplicación para carreras

Las aplicaciones de carreras se crean a partir de:

**RUFUS Cloud → Panel de dispositivos**

En la vista Dispositivos, encontrarás la sección **Lanzar aplicación de carrera**.

![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_24b06de81c2c431a8aa7ec56ca107ef1/imported.png)
_Lanzar la tarjeta de la aplicación de carreras_

El lanzamiento de una aplicación de carreras crea:

* Un registro de dispositivo virtual
* Un ID de aplicación único
* Un token de acceso
* Caducidad de un token (TTL)
* Un registro de auditoría a nivel de la nube

## Lanzamiento de una nueva aplicación para carreras

Para crear una aplicación de carrera:

1. Haz clic en **Iniciar aplicación de carreras**
2. Introduzca un alias (nombre del dispositivo)
3. Seleccione el **TTL del token de acceso** (ventana de caducidad)

![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_34b8fec5ba5f4d9eba337af0de229431/imported.png)
_Tarjeta de información de acceso a la aplicación de la carrera_

Una vez creado, Cloud genera:

* **ID de la aplicación**
`race-app.runonrufus.com/<AppId>`
* **Token de acceso** (formato `JUDGE-XXXXX-YYYYY`)
* **Tiempo de caducidad** (`race_app_token_until`)

La aplicación Race ahora aparece en la lista de dispositivos como un dispositivo virtual de la aplicación Race.

![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_169e082abf0e4d34a2d51b2a67e39b82/imported.png)
_Tarjeta de la aplicación de la carrera_

## Comprender el TTL del token de acceso

El TTL del token de acceso define cuánto tiempo permanece válido el token.

Cuando el TTL caduca:

* El token deja de funcionar.
* Los jueces ya no pueden iniciar sesión.
* Se debe generar un nuevo token.

Mejor práctica:
Establezca el TTL con una duración suficiente para cubrir:

* Tiempo de configuración
* Ventana de carrera completa
* Margen posterior a la carrera

Si es necesario, puede actualizar (rotar) el token en cualquier momento.

## Compartir el acceso con los jueces

Para dar acceso a un juez, debe proporcionar:

* Enlace de la aplicación (`race-app.runonrufus.com/<AppId>`)
* El token de acceso

Ambos son obligatorios.

Al iniciar sesión, el juez también debe introducir:

* Su nombre (utilizado para la identificación y la auditoría)

**Importante:**
Solo un juez activo puede usar el token a la vez. Si otro juez inicia sesión con el mismo token, se hará cargo de la sesión.

## Detalles del dispositivo (tarjeta del dispositivo de la aplicación de la carrera)

![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_c5e2c8606b2047e9a7b07e36641b5fb4/imported.png)
_Detalles de la aplicación de la carrera_

Al abrir la tarjeta del dispositivo de la aplicación Race en la nube, podrá ver:

* ID de la aplicación
* Enlace directo a la aplicación
* Token de acceso actual
* Tiempo de caducidad del token
* Sesiones vinculadas a este token
* Fallecimientos registrados
* Acciones de carrera registradas
* Ubicación actual de la aplicación (si la ubicación está habilitada en el móvil)

Esto proporciona una vista de auditoría administrativa a nivel de la nube.

**Recuerda:**
La nube es la capa de control administrativo. Las operaciones de la carrera se gestionan dentro de Race Manager.

## Sesiones explicadas

Una sesión está vinculada al token de acceso activo.

Una sesión se vuelve activa cuando:

* Se utiliza el token de la aplicación Race.
* El dispositivo está asignado a un evento en el Race Manager.

Comportamientos importantes:

* Solo un juez activo por token.
* Cerrar la sesión no borra el historial de la sesión.
* La actividad en directo y el chat de equipo siguen estando disponibles con el mismo token.
* Solo se crea una sesión completamente nueva cuando se actualiza el token.

Si otro juez inicia sesión con el mismo token:

* El juez anterior cierra la sesión automáticamente.
* El nuevo juez continúa dentro de la misma sesión de token.

## Rotación de tokens (reinicio completo)

El botón **Actualizar token de acceso** genera un token completamente nuevo.

Al girar el token:

* El token anterior se invalida inmediatamente.
* Cualquier sesión activa del juez se cierra
* Comienza un nuevo ciclo de vida de la sesión.

Utilice la rotación de tokens cuando:

* El acceso se compartió incorrectamente.
* Un juez ya no debería tener acceso
* Necesitas un reinicio operativo limpio.

Después de la rotación:
Debe comunicar el nuevo token al juez. El anterior dejará de funcionar inmediatamente.

## Asignar la aplicación Race a un evento

Al iniciar la aplicación Race en la nube, no se conecta automáticamente a un evento.

Dentro de **RUFUS Race Manager**:

1. Abrir el evento
2. Ir a Dispositivos
3. Asigna el dispositivo de la aplicación de carreras a:
* El evento
* Uno o más puntos de control

![](https://rufus-serverless-v1-shopmediabucket-yqa11v58uwom.s3.us-east-1.amazonaws.com/knowledge/assets/knowledge_asset_db216b2862794fbdbab829de421ed7c4/imported.png)
_Diálogo "Añadir dispositivo" en RRM_

Una vez asignado:

* La aplicación de la carrera puede enviar pasadas de cronometraje manual.
* Las acciones de carrera aparecerán en las notificaciones de carrera.
* La sesión se vuelve operativamente activa.

## Sesiones, pases y acciones de carrera (vista en la nube)

Desde la tarjeta del dispositivo en la nube, puede auditar:

### Sesiones

Sesiones operativas vinculadas a eventos asociadas al token.

### Fallecimientos

Generado a partir de la temporización manual.

### Acciones de carrera

Generado a partir de:

* Penalización y bonificación
* Cambios de estado
* Alertas de carrera
* Chat del equipo

La nube actúa como plano de control y capa de auditoría, mientras que Race Manager gestiona las operaciones de la carrera en directo.

## Mejores prácticas operativas

Antes del día de la carrera:

* Inicia la aplicación de la carrera con antelación.
* Establezca un TTL adecuado.
* Asigna el dispositivo a los puntos de control en Race Manager.
* Comparte el enlace y el token con los jueces.

El día de la carrera:

* Supervisa las sesiones en la nube.
* Gire el token si es necesario restablecer el acceso.
* Verifique la asignación del dispositivo en Race Manager.

Después del día de la carrera:

* Revise el historial de auditoría si es necesario.
* Gire el token si el dispositivo ya no debe ser accesible.

## Resumen

El lanzamiento de una aplicación de carrera en RUFUS Cloud crea un dispositivo virtual controlado y basado en tokens que los jueces utilizan durante las operaciones de carrera.

El token de acceso define quién puede iniciar sesión, el TTL define cuánto tiempo permanece válido y la rotación de tokens proporciona un mecanismo de restablecimiento seguro.

La nube gestiona el acceso y la auditoría. El gestor de carreras se encarga de la ejecución operativa.
