Saltar al contenido principal
Arquitectura de Sistemas
8 min de lectura

Análisis profundo de la arquitectura Unitrition: ingeniería de una plataforma HealthTech Headless con Next.js 16, WordPress y Supabase

Desglose ejecutivo y técnico de Unitrition (unitrition.info): desacoplamiento de WordPress CMS con Next.js 16 App Router, integración de la API USDA FoodData Central para el cálculo de Unidades de Pan y curvas glucémicas en 10 dietas, y seguridad con Supabase RLS.

AY
Artur Yusupov
Ingeniero Web Fullstack y Desarrollador IA
Aplicado en producción:Unitrition
Análisis profundo de la arquitectura Unitrition: ingeniería de una plataforma HealthTech Headless con Next.js 16, WordPress y Supabase

1. Resumen Ejecutivo y el Desafío en HealthTech

Las personas que siguen protocolos dietéticos estrictos (diabetes tipo 1 y 2, dieta cetogénica, Low-FODMAP, renal o mediterránea) enfrentan una carga cognitiva diaria: cruzar etiquetas nutricionales con tablas clínicas y calcular manualmente las Unidades de Pan (BU / Intercambios de Carbohidratos) y la carga glucémica.

Al mismo tiempo, los portales de salud tradicionales construidos sobre CMS monolíticos sufren lentitud en dispositivos móviles al consultar grandes bases de datos nutricionales y carecen de herramientas interactivas de simulación.

Unitrition (unitrition.info) fue diseñado para unir el rigor nutricional con el alto rendimiento fullstack. Combinando Headless WordPress, Next.js 16 App Router (React 19), Supabase PostgreSQL y la API oficial USDA FoodData Central, la plataforma ofrece evaluación instantánea de alimentos en 10 protocolos dietéticos, cálculo de Unidades de Pan en tiempo real y simulación de curvas glucémicas.


2. Registros de Decisiones de Arquitectura (ADR - Por qué elegimos este stack)

Decisión Arquitectónica
Stack Híbrido Headless (Next.js 16 + Headless WordPress REST API)
Alternativa Descartada
Tema Monolítico PHP en WordPress con AJAX
Justificación Técnica y de Negocio
Los editores nutricionales mantienen el flujo de trabajo de WordPress + ACF Pro, mientras los usuarios disfrutan de una aplicación React 19 con 95+ en PageSpeed.
Decisión Arquitectónica
Supabase PostgreSQL + Auth para Perfiles de Usuario
Alternativa Descartada
Almacenar usuarios en wp_users de WordPress
Justificación Técnica y de Negocio
Aislar la autenticación y las preferencias dietéticas en Supabase con Row Level Security (RLS) garantiza que los datos personales estén blindados y separados del CMS editorial.
Decisión Arquitectónica
Proxy Servidor en Next.js para la API USDA FoodData
Alternativa Descartada
Peticiones fetch() directas desde el navegador a USDA
Justificación Técnica y de Negocio
Oculta la clave privada de la API en el servidor, normaliza el complejo esquema JSON del USDA en un contrato tipado y aplica caché en el Edge.
Decisión Arquitectónica
Rutas Bilingües y Schema.org (`EN / ES`)
Alternativa Descartada
Traducción solo en cliente sin rutas dedicadas
Justificación Técnica y de Negocio
URLs localizadas con etiquetas hreflang y datos estructurados Schema.org maximizan el posicionamiento SEO orgánico en mercados hispanohablantes e ingleses.

3. Mecanismos Clave: Cómo funciona Unitrition bajo el capó

Mecanismo 1: Proxy Servidor USDA FoodData Central y Normalización de Nutrientes

La base de datos USDA FoodData Central contiene cientos de miles de alimentos donde cada nutriente se reporta en estructuras anidadas con distintos identificadores y unidades (kcal vs kJ, carbohidratos totales, fibra dietética, azúcares).

Cuando un usuario busca un alimento en Unitrition:

1
El cliente envía una solicitud con debounce al Route Handler interno de Next.js.
2
El proxy del servidor se autentica ante la API del USDA usando variables de entorno privadas, extrae la matriz de nutrientes y la transforma en una interfaz tipada NormalizedFoodItem.
3
Las respuestas se almacenan en caché con stale-while-revalidate, resolviendo búsquedas frecuentes en menos de 30ms.
TS
// Fórmula conceptual para el cálculo de Unidades de Pan (BU) y carbohidratos netos
export interface NormalizedMacros {
  caloriesKcal: number
  totalCarbsGrams: number
  dietaryFiberGrams: number
  sugarsGrams: number
  proteinGrams: number
  fatGrams: number
}

export function calculateBreadUnits(macros: NormalizedMacros, portionGrams: number) {
  const factor = portionGrams / 100
  const digestibleCarbs = Math.max(0, (macros.totalCarbsGrams - macros.dietaryFiberGrams) * factor)
  // 1 Unidad de Pan (BU) = 12 g de carbohidratos asimilables
  const breadUnits = Number((digestibleCarbs / 12).toFixed(2))
  return { digestibleCarbs: Number(digestibleCarbs.toFixed(1)), breadUnits }
}

Mecanismo 2: Motor Determinista de Puntuación para 10 Dietas (Traffic-Light Scoring)

En lugar de depender de llamadas lentas a modelos LLM, Unitrition ejecuta una matriz determinista de reglas clínicas para 10 planes nutricionales:

  • Cada protocolo define umbrales precisos de macronutrientes, carga glucémica y grupos de alimentos restringidos.
  • Al seleccionar una dieta y buscar un alimento, el motor calcula al instante una clasificación visual por colores:
  • Verde (Óptimo): Cumple los objetivos de macronutrientes con bajo impacto glucémico.
  • Ámbar (Moderado / Control de Porción): Requiere ajustar gramos según las Unidades de Pan calculadas.
  • Rojo (Evitar): Supera los límites de carbohidratos, sodio o lípidos del protocolo activo.

Mecanismo 3: Simulación de Curvas Glucémicas (CGM) y Exportación a PDF

Para visualizar cómo la fibra y la proteína amortiguan la absorción de glucosa frente a los azúcares simples, Unitrition incluye un Simulador de Respuesta Glucémica:

  • A partir de la proporción de carbohidratos netos, fibra, grasa y proteína de la porción elegida, proyecta la curva glucémica posprandial a 180 minutos.
  • El usuario puede exportar su selección y cálculos de Unidades de Pan en un Informe Nutricional en PDF listo para imprimir.

Mecanismo 4: CMS Editorial Desacoplado con Headless WordPress e ISR

Las guías clínicas y artículos de nutrición se gestionan en WordPress mediante ACF Pro:

  • Next.js consume la WP REST API y actualiza las páginas estáticas en segundo plano mediante Incremental Static Regeneration (ISR).
  • Cada guía inyecta automáticamente marcado Schema.org (`Article`, `FAQPage`) para destacar en buscadores.

4. Glosario de Ingeniería: Explicación de cada término y mecanismo

  • Arquitectura Headless CMS:
  • *Qué es*: Separar el panel de administración de contenidos (WordPress) de la interfaz visual pública (Next.js).
  • *Valor*: Los editores conservan su herramienta habitual mientras los usuarios obtienen velocidad instantánea y mayor seguridad al ocultar el panel de administración del tráfico público.
  • Incremental Static Regeneration (ISR):
  • *Qué es*: Tecnología de Next.js que regenera páginas estáticas en segundo plano cuando cambia el contenido del CMS sin recompilar todo el portal.
  • *Valor*: Une la velocidad del HTML estático con la actualización continua de un sitio dinámico.
  • Unidad de Pan (BU / Intercambio de Carbohidratos):
  • *Qué es*: Medida clínica nutricional (1 BU equivale a 10g-12g de carbohidratos digeribles descontando la fibra) utilizada para controlar la respuesta glucémica.
  • *Valor*: Automatiza el cálculo exacto según el peso de cada porción.
  • Proxy de API en Servidor (Server-Side API Proxy):
  • *Qué es*: Un endpoint intermedio en el backend que recibe la petición del navegador, añade las credenciales secretas en el servidor y normaliza los datos externos.
  • *Valor*: Impide el robo de claves API y protege el frontend ante cambios en servicios de terceros.
  • Supabase Row Level Security (RLS):
  • *Qué es*: Reglas de seguridad a nivel de fila en PostgreSQL que validan auth.uid() = user_id en cada operación.
  • *Valor*: Garantiza privacidad absoluta para los perfiles dietéticos de cada usuario.

5. Arquitectura de Seguridad en Profundidad (Defense-in-Depth)

1
Separación Zero-Trust entre CMS y Datos de Usuario: Las cuentas y preferencias dietéticas residen en un clúster aislado de Supabase PostgreSQL con RLS, completamente separadas de WordPress.
2
Aislamiento de Credenciales en Servidor: Las claves de la API del USDA nunca se exponen en el código JavaScript del navegador.
3
Validación y Control de Tasa: Las búsquedas pasan por debounce y caché en el servidor para evitar abusos de cuota.
Implementación real en producción

Dónde funciona esta arquitectura en proyectos reales

Estas soluciones no son teoría abstracta: están desplegadas y verificadas en los siguientes productos reales:

Desarrollo Web en Sevilla y España / Pymes y Clínicas

Diseño y Desarrollo Web Profesional a Medida en Sevilla y España para Pymes

Páginas web rápidas, accesibles y orientadas a captar clientes para empresas, clínicas y despachos en Sevilla y toda España. Sin plantillas lentas ni costes ocultos.

Ver detalles del servicio
Auditoría de Arquitectura

¿Planeas una migración técnica o nuevo proyecto?

Consulta los requerimientos de tu proyecto con el asistente de IA o solicita una evaluación técnica directa.

Contactar directamente