Arquitectura Técnica de KIN Medical

Plataforma médica construida con motor determinista, IA aplicada con guardrails, OCR clínico, seguridad por diseño y cloud deployment.

Java / Spring BootNext.js / React / TypeScriptPostgreSQLGoogle Vision OCRDeepSeek IATesting automatizadoCI/CDSecurity by DesignCloud deployment

KIN Medical en una mirada técnica

1

El problema

Fragmentación de información clínica entre historia médica, agenda, laboratorios y comunicación médico-paciente.

2

La arquitectura

Backend Spring Boot, frontend Next.js, motor determinista para triaje y pipeline clínico de etapas.

3

La IA

El LLM redacta el análisis ya decidido. El motor Java decide la clasificación y urgencia del triaje.

4

El control

Verificación manual de médicos, protección de datos clínicos, testing automatizado y DevSecOps.

Java decide. El LLM únicamente comunica.

KIN Medical no delega las decisiones clínicas al modelo de IA. Un motor determinista de reglas fijas (basado en CIE-10, OMS y protocolos clínicos) decide la clasificación, urgencia y recomendaciones del triaje. La IA solo redacta el resultado en lenguaje sencillo.

El flujo del triaje digital

1

Paciente

Ingresa síntomas en el formulario de triaje digital.

2

Motor determinista

Aplica reglas fijas basadas en CIE-10, OMS y protocolos clínicos.

3

Clasificación

Calcula condiciones probables, severidad y urgencia.

4

Pruebas sugeridas

Sugiere exámenes complementarios según la condición.

5

Fuentes médicas

Proporciona enlaces a MedlinePlus, Mayo Clinic, MSD Manuals, CDC, OMS, AAFP.

6

IA

El LLM (DeepSeek) redacta el resultado en lenguaje sencillo.

7

Resultado

El paciente ve el análisis completo con disclaimer legal.

Análisis de documentos clínicos con OCR

Subida de fotos

El paciente puede subir una foto del examen desde su celular (cámara directa).

Google Vision OCR

Extrae el texto de la imagen con DOCUMENT_TEXT_DETECTION en español.

Análisis con IA

DeepSeek interpreta los valores y genera un análisis en lenguaje sencillo.

Stack técnico verificado

Backend

  • Java 17
  • Spring Boot 3.2.5
  • Spring Security
  • JPA / Hibernate
  • Flyway (V1-V47)
  • JWT + HttpOnly cookies

Frontend

  • Next.js 16 (App Router)
  • React 19
  • TypeScript strict
  • Tailwind CSS 4
  • React Hook Form + Zod
  • Lucide icons

Datos

  • PostgreSQL (Neon)
  • Migraciones versionadas
  • Índices optimizados
  • Audit logs
  • Outbox pattern

IA

  • DeepSeek V4 Flash
  • Spring AI integration
  • Prompt engineering
  • Guardrails deterministas
  • Sin análisis de imágenes médicas

Seguridad

  • JWT stateless
  • Cookie HttpOnly + SameSite=None
  • CORS restrictivo
  • Rate limiting
  • Habeas Data compliance

Cloud / DevOps

  • Render (backend)
  • Vercel (frontend)
  • Docker
  • GitHub Actions
  • CI/CD automatizado

Calidad verificada con pruebas reales

86+

tests backend

436

tests frontend

E2E

Playwright

Herramientas de testing

JUnit 5MockitoTestcontainersVitestReact Testing LibraryPlaywrightJaCoCoESLint

Security by Design

La seguridad no es una capa final de KIN Medical: está distribuida en autenticación, autorización, persistencia y despliegue.

Autenticación stateless con JWT + cookies HttpOnly
CORS restrictivo a dominios específicos (sin wildcards)
Verificación manual de médicos por ADMIN
Rate limiting en endpoints sensibles
Protección de datos de salud (Habeas Data)
Emails sin datos clínicos (solo avisos)
Auditoría de accesos a documentos clínicos
Aislamiento por propietario de recurso (IDOR)

Diferenciador clave

KIN Medical

  • ✅ Motor determinista decide triaje
  • ✅ IA solo redacta el resultado
  • ✅ Fuentes médicas verificables (OMS, CIE-10)
  • ✅ Sin datos clínicos en emails/WhatsApp
  • ✅ Verificación manual de médicos
  • ✅ Accesible WCAG AAA

Plataformas tradicionales

  • ❌ LLM decide (impredecible)
  • ❌ IA sin trazabilidad
  • ❌ Fuentes no verificables
  • ❌ Datos clínicos expuestos
  • ❌ Verificación automática dudosa
  • ❌ Contraste insuficiente

¿Quieres conocer KIN Medical en acción?

La plataforma está disponible en producción. Regístrate gratis y explora todas las funcionalidades.