> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fhiron.cl/llms.txt
> Use this file to discover all available pages before exploring further.

# Insight

> Análisis de cumplimiento FHIR® sobre endpoints existentes. FHIR Score 0–100 y reporte ejecutivo en PDF.

Insight evalúa qué tan cerca está un endpoint FHIR existente de cumplir con **CL Core v1.9.4**. Calcula un puntaje numérico **FHIR Score 0–100**, lo desglosa por dimensión y emite un reporte ejecutivo en PDF apto para presentar a Directorio, MINSAL o auditoría preparatoria.

## Cuándo usarlo

* **Antes de integrar a un EHR existente:** cuantificar la brecha contra el estándar y priorizar trabajo.
* **Auditoría interna periódica** del propio endpoint para detectar regresiones.
* **Evidencia preparatoria** para certificación CENS o equivalente.

## Flujo

```mermaid theme={null}
sequenceDiagram
    autonumber
    participant Cliente
    participant Insight
    participant Endpoint as Endpoint FHIR<br/>del cliente

    Cliente->>Insight: Registrar URL del endpoint
    activate Insight

    Insight->>Endpoint: GET /metadata
    Endpoint-->>Insight: CapabilityStatement
    Note over Insight: Modo lite — solo metadata<br/>(4 dimensiones · score máx. 80)

    Insight->>Endpoint: GET muestra de recursos
    Endpoint-->>Insight: Patients, Encounters, Observations…
    Note over Insight: Modo profundo — validación contra CL Core<br/>(5ª dimensión · score hasta 100)

    Note over Insight: Calcular FHIR Score<br/>+ recomendaciones priorizadas
    deactivate Insight

    Cliente->>Insight: Solicitar reporte
    Insight-->>Cliente: PDF ejecutivo descargable
```

## Anatomía del FHIR Score

El puntaje se compone de hasta **5 dimensiones**:

| Dimensión                       | Disponible en | Mide                                                                  |
| ------------------------------- | ------------- | --------------------------------------------------------------------- |
| Versión FHIR                    | Lite + Pro    | Versión declarada en el `CapabilityStatement` (R4 esperado).          |
| Recursos core                   | Lite + Pro    | Cuántos de los 10 recursos core soporta el endpoint.                  |
| Perfiles CL Core                | Lite + Pro    | Perfiles declarados (CorePacienteCl, CorePrestadorCl, …).             |
| Interacciones `read` + `search` | Lite + Pro    | Operaciones soportadas por recurso.                                   |
| Validación de recursos reales   | Solo Pro      | Recursos muestreados validados contra CL Core v1.9.4 + reglas `cl-*`. |

**Modo lite** se queda con metadata (4 dimensiones, score máximo 80). **Modo profundo** muestrea recursos reales del endpoint y los valida (la 5ª dimensión sube el techo a 100).

## Reporte ejecutivo

El PDF incluye:

* Portada institucional con el FHIR Score, fecha del scan y endpoint analizado.
* Desglose por dimensión con ejemplos concretos del endpoint.
* Recomendaciones priorizadas (qué corregir primero para subir el score).
* Aviso de alcance: este reporte es evidencia técnica para uso interno o presentación a Directorio. **No constituye una auditoría legal vinculante.** Para certificaciones formales se contacta a CENS o entidades acreditadoras del MINSAL.

## Acceso

Insight se ejecuta desde el dashboard:

[**fhiron.cl/dashboard/insight**](https://fhiron.cl/dashboard/insight)

Cada scan queda registrado con timestamp, dimensiones obtenidas y el PDF disponible para descarga posterior.