Kani Hub — Demo

Arquitectura

Cómo se conectan los sistemas

Un solo bus recibe Bundles FHIR R4 de organizaciones externas — identificadas por API Key — los valida, resuelve el DNI del paciente y los persiste en la historia clínica de Kani Seguimiento. Si el DNI del Bundle no corresponde a un paciente ya registrado en KANI, el Hub devuelve error y no persiste nada: nunca crea pacientes fantasma.

Kani Audit

Auditoría médica de obras sociales

Canal interno dedicado — no vía API Key pública

Otros sistemas

Laboratorios · Imágenes · Hospitales · Sanatorios · Consultorios

POST /hub/fhir/ingest · header X-Hub-API-Key

┄┄▶┄┄▼

──▶──▼

Kani Hub

Bus de interoperabilidad FHIR R4

Valida Bundle → resuelve DNI → persiste

──▶──▼

Kani Seguimiento

Historia clínica del paciente

patients/{dni}/fhir_inbound

Nota técnica: hoy, la sincronización de Kani Audit hacia Kani Seguimiento corre por un canal interno de servicio a servicio, con secreto propio — distinto del canal público por API Key que usan los integradores externos (laboratorios, sanatorios, hospitales) representado abajo. Ambos alimentan la misma historia clínica, pero no comparten el mismo mecanismo de autenticación.

Verificación entre sistemas

Una API Key por organización, generada una sola vez al dar de alta al integrador — nunca se puede volver a mostrar.
El Hub la verifica con hash SHA-256 contra la organización registrada en cada request, vía el header X-Hub-API-Key.
Una key inactiva o revocada devuelve 401 de inmediato, antes de tocar el contenido del Bundle.
Modo sandbox (X-Hub-Sandbox: dry_run): permite a un integrador probar su envío sin escribir datos reales de un paciente.

01

Alta de integradores

Cada organización, con su propia llave

Un supervisor del Hub da de alta a Laboratorio Diagnóstico Sur como organización integradora. Al crear la clave, el sistema la muestra en texto plano una única vez — desde ese momento, el Hub solo guarda su hash. Desde el mismo panel se puede pasar una integración a modo sandbox o revocarla.

kani-hub.web.app — Supervisión · Organizaciones

SUPERVISIÓN · GESTIÓN DE API KEYS DE INTEGRADORES

Organizaciones

+ Nueva organización

Laboratorio Diagnóstico Sur

LaboratorioActiva

Último uso

hace 12 min

Volumen 7d

128

Éxito 7d

97%

Sanatorio Central

SanatorioSandbox

Último uso

hace 2 hs

Volumen 7d

34

Éxito 7d

88%

Hospital del Este

HospitalRevocada

Último uso

hace 6 días

Volumen 7d

0

Éxito 7d

—

Alta completada — mostrar clave una sola vez

Esta clave se comparte con Laboratorio Diagnóstico Sur. No se va a volver a mostrar — el Hub solo conserva su hash SHA-256.

7f3a09b2e841…c4d9f0

No se puede recuperar después de cerrar esta pantalla

02

Trazabilidad

Cada Bundle recibido queda registrado y es auditable

Cada llamada a /hub/fhir/ingest — con qué organización, con qué paciente (DNI siempre enmascarado), cuántos recursos se procesaron y con qué errores — queda en un log de trazabilidad, visible para compliance en el panel de Auditoría.

kani-hub.web.app — Auditoría · Log de ingesta

AUDITORÍA · LOG DE INGESTA FHIR

Eventos de ingesta

47 recursos FHIR R4 soportados

Laboratorio Diagnóstico Sur Laboratorio

hace 12 min · DNI xxxx3456

Procesados / Errores

6 / 0

OK

Sanatorio Central Sanatorio

hace 2 hs · DNI xxxx1189

Procesados / Errores

4 / 1

Parcial

Hospital del Este Hospital

hace 6 días · DNI xxxx7702

Procesados / Errores

0 / 2

Error

Detalle del evento — Laboratorio Diagnóstico Sur

DiagnosticReport ServiceRequest Specimen ImagingStudy

✓

DiagnosticReport — ok

✓

Specimen ×2 — ok

✓

ServiceRequest — ok

!

ImagingStudy — skipped: recurso duplicado (mismo id ya ingresado)