# Baseline

## Qué es

Un **baseline** es una captura corta de referencia de una persona. Engine guarda uno por usuario, común a todos los protocolos, y lo usa para calibrar los indicadores de esa persona. Sin él, solo se aplica la calibración poblacional.

## Antes de cualquier protocolo

Captura el baseline antes de la primera captura de un protocolo, y otra vez cuando caduque. Engine no bloquea una captura sin baseline: en su lugar, cada respuesta de inscripción trae un `baselineWarning`.

```json
{
  "baselineWarning": {
    "missing": true,
    "expired": false,
    "invalid": false,
    "message": "No baseline found for this user."
  }
}
```

| `baselineWarning` | Qué significa | Qué hacer |
| --- | --- | --- |
| `null` | Hay un baseline válido y vigente | Nada |
| `missing: true` | El usuario no tiene baseline | Capturar uno |
| `invalid: true` | La última captura no fue suficientemente buena | Capturar uno nuevo |
| `expired: true` | Es más antiguo que `expiryDays` | Capturar uno nuevo |

Con un baseline válido, la misma inscripción responde:

```json
{ "baselineWarning": null }
```

## Compruébalo

```bash
curl -s "$ENGINE/users/$EXT/baseline" -H "Authorization: Bearer $TOKEN"
```

```json
{ "isValid": true, "status": "valid", "expiryDays": 7 }
```

`isValid` es `true` solo si el baseline está vigente **y** es válido. Lee `expiryDays` de la respuesta: es un ajuste del entorno, no una constante. Un usuario sin baseline responde:

```json
{ "status": 404, "body": { "code": 404, "message": "No baseline found for this user." } }
```

| Respuesta | Estado | Qué hacer |
| --- | --- | --- |
| `404` | Sin baseline | Engine mide igual, con calibración de población, y avisa |
| `200` · `isValid: true` | Válido | Días restantes: `lastUpdatedAt` + `expiryDays` − ahora |
| `200` · `isValid: false` · `status: "invalid"` | Calidad insuficiente | Captura uno nuevo |
| `200` · `isValid: false` · `status: "valid"` | Caducado | Captura uno nuevo |

En la implementación actual de Engine (pendiente de confirmar con Engine), el baseline descuenta la expresión de reposo de la persona en Joy, Sadness, Surprise, Anger, Disgust, Fear y Neutral (y en lo que depende de ellas, como Frustration) y no cambia Valence ni Arousal. Míralo, y captura uno, en el [playground](/playground#baseline).

## Captúralo

`POST /users/{externalId}/baseline` recibe frames con el mismo formato que `POST /process-kpn-emo`, sin `step`, `protocolMechanicId` ni `triggerAnalysis`. Divide la captura en lotes numerados desde 1 y marca el último como `Final`. El baseline se calcula cuando llega el `Final` y no falta ningún lote; el último `202` te lo dice:

```json
{
  "status": "accepted",
  "framesWithoutFeaturesMeta": 0,
  "packetsReceived": 10,
  "packetsExpected": 10,
  "missingOrders": []
}
```

Un baseline nunca se interpreta y no tiene resultados propios. No inscribes a las personas en el protocolo Baseline: la captura crea lo que necesita. La [captura de ejemplo](/docs/samples/sample-capture.json) del quickstart también sirve como baseline, sin su `step`.

## Con el SDK

```js
const info = await client.getBaselineInfo(userId) // null: aún no hay
// también lo recaptura si es inválido o ha caducado (isValid: false)
if (!info || !info.isValid) await client.captureBaseline({ userId, source: { type: 'webcam' } })
```

Engine lo calcula en segundo plano: vuelve a leerlo hasta que esté ([En el dispositivo (tiempo real)](/docs/es/sdk/on-device/#baseline)).

## Límites

- Engine aplica el baseline siempre que exista, sea cual sea su `status`, también `invalid`. Una captura nueva que salga inválida no sustituye a un baseline válido; si no lo hay, pasa a ser el baseline guardado y se aplica.
- El baseline tiene que ser de la misma persona que mides; en el [playground](/playground#baseline), eso es la misma persona y el mismo origen (cámara o muestra sintética).
- No hagas dos capturas de baseline de la misma persona a la vez.
- Los resultados de una captura no dicen si se aplicó un baseline personal.
