Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.getcoremetrics.com/llms.txt

Use this file to discover all available pages before exploring further.

ZoneMetrics utiliza una arquitectura de dos capas para capturar datos de frecuencia cardíaca. Una Aplicación de sala 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 de sala toma muestras de cada sensor ANT+ aproximadamente cada 2 segundos (0.5 Hz). Cada lectura produce un punto de telemetría asociado con un asistente y una sesión específicos.
2

Almacenamiento local

Las lecturas se almacenan en una base de datos local en el ordenador 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 de sala 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 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 asistente en un momento específico.
CaracterísticaDescripción
SesiónLa sesión a la que pertenece esta lectura.
AsistenteEl asistente 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 asistentes 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 (ordenador) de sala para revisión. Un dispositivo de sala 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 asistente (frecuencia cardíaca promedio, distribución de zonas, puntos de esfuerzo, etc.) se almacenan por separado y se retienen indefinidamente.