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.

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 | Alternativa Descartada | Justificación Técnica y de Negocio |
|---|---|---|
| Stack Híbrido Headless (Next.js 16 + Headless WordPress REST API) | Tema Monolítico PHP en WordPress con AJAX | 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. |
| Supabase PostgreSQL + Auth para Perfiles de Usuario | Almacenar usuarios en wp_users de WordPress | 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. |
| Proxy Servidor en Next.js para la API USDA FoodData | Peticiones fetch() directas desde el navegador a USDA | 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. |
| Rutas Bilingües y Schema.org (`EN / ES`) | Traducción solo en cliente sin rutas dedicadas | URLs localizadas con etiquetas hreflang y datos estructurados Schema.org maximizan el posicionamiento SEO orgánico en mercados hispanohablantes e ingleses. |
wp_users de WordPressfetch() directas desde el navegador a USDAhreflang 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:
NormalizedFoodItem.stale-while-revalidate, resolviendo búsquedas frecuentes en menos de 30ms.// 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_iden cada operación. - *Valor*: Garantiza privacidad absoluta para los perfiles dietéticos de cada usuario.
5. Arquitectura de Seguridad en Profundidad (Defense-in-Depth)
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:
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.
¿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.
Otros artículos de ingeniería
Next.js 16 vs Headless WordPress vs Custom PHP: Análisis objetivo de TCO, rendimiento y SEO (2026)
Análisis de ingeniería que compara arquitectura, costes de mantenimiento (TCO) y métricas de Core Web Vitals entre Next.js 16, Headless WordPress y PHP a medida.
Análisis profundo de la arquitectura Fullstack AI Lab: compilación de 1.135+ lecciones MDX en 90 segundos con Next.js 16 y Rust MDX-RS
Desglose ejecutivo y técnico completo de la plataforma educativa interactiva Fullstack AI Lab: cómo redujimos el tiempo de compilación SSG 14 veces (de 21.6m a 1.5m), diseñamos un sandbox WebAssembly de WordPress en el navegador, un simulador de entrevistas técnicas con IA, visualizadores interactivos y un motor de audio para NotebookLM.