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
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.
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.
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.
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:
Cada punto de telemetría representa una sola lectura de frecuencia cardíaca para un atleta en un momento específico.
| Característica | Descripción |
|---|
| Sesión | La sesión a la que pertenece esta lectura. |
| Atleta | El atleta cuyo sensor produjo la lectura. |
| Frecuencia cardíaca | Frecuencia cardíaca en bpm. Debe estar entre 20 y 300. |
| Marca de tiempo | Marca 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ámetro | Valor |
|---|
| Máximo de atletas por sala | 32 |
| Tasa de muestreo | 1 punto / 2 s |
| Ventana de sincronización | 30 s |
| Tamaño normal del lote | 32 × 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.