> ## 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.

# Stateless Gateway

> Diseño previsto del componente de integración. En desarrollo.

<Warning>
  **Componente en desarrollo.** Esta página describe el diseño arquitectónico del Gateway. La implementación todavía no está disponible en producción. Las capacidades descritas aquí son el comportamiento previsto, no el estado actual.
</Warning>

El Gateway es el componente que va a validar cada recurso FHIR® contra CL Core v1.9.4 y enrutarlo al EHR destino del cliente sin escribirlo en disco. Los datos clínicos no se persistirán en infraestructura de Fhiron.

## Flujo previsto

```mermaid theme={null}
sequenceDiagram
    autonumber
    participant App as App cliente
    participant Gateway as Fhiron Gateway
    participant EHR as EHR destino

    App->>Gateway: POST /fhir/Patient
    activate Gateway
    Note over Gateway: Validar contra CL Core v1.9.4

    alt Validación falla
        Gateway-->>App: 400 · OperationOutcome (es)
    else Validación OK
        Gateway->>EHR: POST /fhir/Patient
        activate EHR
        EHR-->>Gateway: 201 Created
        deactivate EHR
        Gateway-->>App: 201 Created
    end

    Note over Gateway: Recurso descartado<br/>tras reenvío
    deactivate Gateway
```

Tras reenviar, el Gateway descartará el recurso de memoria. No habrá escritura a base de datos del lado de Fhiron.

## Por qué stateless

**Ley 21.719** (protección de datos personales en Chile). El diseño busca que los recursos clínicos solo existan en memoria durante la validación y el reenvío.

**Separación de almacenamiento prevista.**

| Origen del dato        | Dónde vivirá                               |
| ---------------------- | ------------------------------------------ |
| Datos clínicos reales  | EHR destino del cliente                    |
| Datos sintéticos       | Sandbox aislado, sin conexión a producción |
| Metadatos de operación | Plan, contadores, logs de validación       |

Los logs de validación registrarán código de error, ruta del recurso y el identificador de tu organización. No incluirán el cuerpo del recurso ni datos identificables de pacientes.

## Lo que no significará

* No será un proxy ciego. El Gateway abrirá el recurso, lo validará contra el perfil correspondiente y solo lo reenviará si cumple.
* No omitirá trazabilidad. Cada request dejará registro de timestamp, tenant, tipo de recurso y código de respuesta.
* No reemplazará la auditoría clínica del EHR destino.

## Estado actual

Hoy Fhiron valida recursos vía:

* [`POST /api/validate`](/inspect/api): endpoint REST de Inspect.
* `@fhiron/mcp-connector`: desde el editor con [Model Context Protocol](/mcp/overview).
* Dashboard web: workspace con editor JSON y resultado en tiempo real.

El reenvío al EHR destino, mientras el Gateway no esté disponible, queda del lado de la aplicación que consume Inspect.