Saltar al contenido principal
ZoneMetrics utiliza una arquitectura de dos capas para capturar datos de frecuencia cardíaca. Una Aplicación Edge de sala se ejecuta en un dispositivo local en tu instalación y lee directamente de los sensores de frecuencia cardíaca ANT+. Almacena temporalmente las lecturas localmente y las sincroniza con la API en la nube de ZoneMetrics en lotes regulares tras finalizar la sesión.

Flujo de datos

1

Lectura de sensores

La Aplicación Edge toma muestras de cada sensor ANT+ aproximadamente cada 2 segundos (0.5 Hz). Cada lectura produce un punto de telemetría asociado con un atleta y una sesión específicos.
2

Almacenamiento local

Las lecturas se almacenan en una base de datos local en el dispositivo edge de sala a medida que llegan. Este almacenamiento temporal asegura que no se pierdan datos si la conexión a internet no está disponible temporalmente.
3

Sincronización por lotes a la nube

Al finalizar la sesión, la Aplicación Edge envía un lote de lecturas almacenadas a la API en la nube. La API inserta todos los puntos válidos y devuelve el número de registros almacenados.
4

Consulta del panel

La aplicación edge de sala conssulta los datos de frecuencias cardíacas leídos, loes muestra y verifica logros recién obtenidos:

Formato del punto de telemetría

Cada punto de telemetría representa una sola lectura de frecuencia cardíaca para un atleta en un momento específico.
CaracterísticaDescripción
SesiónLa sesión a la que pertenece esta lectura.
AtletaEl atleta cuyo sensor produjo la lectura.
Frecuencia cardíacaFrecuencia cardíaca en bpm. Debe estar entre 20 y 300.
Marca de tiempoMarca de tiempo establecida por el servidor cuando se persiste el punto.
Las lecturas fuera del rango de 20–300 bpm son rechazadas por el sistema de saneamiento y no se almacenan. El endpoint de lotes registra los puntos descartados para diagnóstico pero continúa procesando las lecturas válidas restantes en el mismo lote.

Límites de lotes

El endpoint de lotes impone un máximo de 1,500 puntos por solicitud. Este límite se deriva del techo de hardware de tu instalación:
ParámetroValor
Máximo de atletas por sala32
Tasa de muestreo1 punto / 2 s
Ventana de sincronización30 s
Tamaño normal del lote32 × 15 = 480 puntos
Margen de seguridad (3×)1,440 → 1,500
El margen de 3× acomoda interrupciones breves de red donde se acumulan múltiples ventanas de 30 segundos antes de una sincronización exitosa. Las solicitudes que exceden los 1,500 puntos son rechazadas con un error 400 BATCH_TOO_LARGE.
Exceder consistentemente el límite de lotes se trata como una anomalía. La plataforma marca el dispositivo edge para revisión. Un dispositivo edge legítimo nunca debería exceder este límite excepto después de una interrupción prolongada de la red.

Retención de datos

Los puntos de telemetría sin procesar mayores a 90 días se purgan automáticamente. Los resúmenes de sesión no se ven afectados por esta purga: las estadísticas agregadas por atleta (frecuencia cardíaca promedio, distribución de zonas, puntos de esfuerzo, etc.) se almacenan por separado y se retienen indefinidamente.