# Qué es Engine 2

## Cuatro componentes, un sentido

La plataforma de Neurologyca tiene cuatro partes, y los datos las recorren en un solo sentido:

| Componente | Dónde se ejecuta | Qué hace | Qué no hace |
| --- | --- | --- | --- |
| **Captura (@neurologyca/capture)** | **En el dispositivo (tiempo real)** (**Preview 0.45**): En el dispositivo de la persona, en el navegador | Extrae geometría facial, coeficientes de expresión y pose mientras capturas. **Sale:** landmarks, coeficientes de expresión y pose hacia Engine; el transcrito y las señales extra, solo si los activas. El vídeo y el audio no salen del dispositivo. | Interpretar nada |
| **Captura (@neurologyca/capture)** | **Diferido (en servidor)** (**Preview**): Graba en el navegador; se procesa en nuestro servicio de procesado | Graba el vídeo y un manifiesto de steps y los sube; nuestro servicio de procesado lo procesa poco después, así que el vídeo y el audio salen del dispositivo. **Sale:** vídeo y audio hacia tu receptor y el servicio de procesado. | Interpretar nada |
| **Engine** | Neurologyca | Ejecuta el protocolo de medición, los modelos propios y la calibración | Decidir el significado de un resultado |
| **Konstellation** | Neurologyca | Resuelve el caso de forma determinista, lo ancla en la evidencia y redacta la narrativa | Procesar señal o recalcular medidas |
| **Tu aplicación** | Tú | La interfaz, la identidad de tus usuarios, el almacenamiento y el flujo; ejecuta la mitad de servidor del SDK (`@neurologyca/capture-server`): el proxy, el token y las inscripciones | — |

Cada flecha es un contrato versionado.

El propio SDK de captura tiene dos mitades: `@neurologyca/capture` corre en el navegador y `@neurologyca/capture-server` corre en tu backend. Ver [Instalación](/docs/es/start/install/).

Qué modo usar y cómo combinar el SDK con la API HTTP: [Vías de integración](/docs/es/start/paths/).

## Solo hablas con Engine

Tu backend y tu página llaman a **Engine**, y a nada más. Engine llama a Konstellation por ti cuando pides una interpretación. En diferido, tu backend habla además con el servicio de procesado de Neurologyca, que llama de vuelta a tu backend con un webhook firmado ([Servicio de procesado](/docs/es/sdk/processing/)).

## Contextos: qué puede medir tu organización

Un **contexto** es un caso de uso (por ejemplo, el bienestar de un deportista durante la semana de competición) con sus protocolos y, normalmente, una **taxonomía** que le dice a la interpretación en qué fijarse.

Neurologyca asigna contextos a cada organización. `GET /catalog/contexts` y `GET /catalog/protocols` devuelven el catálogo de **tu** organización, así que dos organizaciones ven listas distintas. La organización de estos ejemplos es solo eso: un ejemplo.

| Si el contexto… | Una captura devuelve | Uso típico |
| --- | --- | --- |
| tiene taxonomía (`taxonomy.constellation_context_id`) | HCIs **y** una interpretación | Bienestar, deporte, selección |
| no la tiene (**Measurement**) | Solo HCIs, por frame y por step | "Solo medir": el significado lo pones tú |

Measurement es universal en el entorno de pruebas: todos las organizaciones tienen su contexto y lo ven sin taxonomía. El Engine de producción aún no lo ofrece ([Tus entornos](/docs/es/start/environments/)).

```json
[{ "name": "Measurement", "taxonomy": null }]
```

Un contexto con taxonomía trae su id (ilustrativo):

```json
[
  {
    "name": "<your context>",
    "taxonomy": {
      "constellation_context_id": "<your-context-id>"
    }
  }
]
```

¿Te falta un contexto? Lo pide a Neurologyca el admin de tu organización. Puedes listar los tuyos cuando quieras con las dos llamadas de arriba, o en la [referencia de la API](/docs/es/reference/).

Neurologyca te da una guía por cada uno de tus contextos: te la da Neurologyca con el acceso al contexto. Una guía de contexto cuenta:

- qué mide el contexto y para quién;
- sus protocolos, posiciones y cadencia;
- su taxonomía: el contexto, el indicador objetivo y el subcontexto de cada mecánica;
- sus steps y medias: quién cierra cada step y cuándo enviar `mediaId`;
- qué steps transcribir y en qué idioma;
- las audiencias disponibles para la interpretación y los roles de sus usuarios.

## Palabras que vas a ver

| Palabra | Qué es |
| --- | --- |
| Contexto | Un caso de uso que tiene asignado tu organización; decide en qué protocolos puedes inscribir a las personas |
| Protocolo | Qué se mide y cuándo: una lista ordenada de posiciones |
| Posición | Un hueco del protocolo, la captura de un momento; cada una ejecuta una mecánica hecha de steps |
| Inscribir | Apuntar a una persona a un protocolo (`POST /user-protocols`); el `userProtocolId` de la respuesta nombra esa inscripción |
| El par | `userProtocolId` y `protocolMechanicId`: una inscripción y la posición que se captura. Tu backend se lo da a la página; se usa una vez |
| Sesión | Una captura de una posición, del primer frame a sus resultados; Engine abre una por captura |
| Baseline | Una captura corta por persona que Engine usa como su referencia; recomendada antes de cualquier protocolo, no obligatoria |
| Kit | En [Tu integración](/integration), por protocolo: su configuración del cliente (`neuro.config.json`), el entorno de tu backend (`.env.example`) y un starter listo para ejecutar por modo |

Más niveles y sus nombres en la API: [Protocolos y su jerarquía](/docs/es/concepts/protocols/).

## Qué devuelve Engine

- **Human Context Indicators (HCIs)** de cada frame capturado, y su media por step.
- **Eventos en vivo** mientras se procesa una captura (Server-Sent Events).
- **Una interpretación** de una captura completada, escrita para la audiencia que elijas, cuando el contexto tiene taxonomía.

## Qué no devuelve

- No hay análisis agregado de todo un protocolo.
- Sin webhooks de Engine: usas el stream en vivo o consultas los resultados (en diferido, el servicio de procesado sí manda uno).
- Ningún audio llega a Engine: en el dispositivo, la transcripción corre en el navegador y solo sale su texto; en diferido, el audio va al servicio de procesado, que lo transcribe.
- No hay intención, engaño ni diagnóstico. Los indicadores describen la interacción, no a la persona.

## Siguiente

Sigue el [Quickstart](/docs/es/start/quickstart/) para ir de tu API key a tus primeros indicadores, o elige primero tu vía en [Vías de integración](/docs/es/start/paths/).
