Zum Hauptinhalt springen
Systemarchitektur
8 Min. Lesezeit

Unitrition Architektur-Deep-Dive: Entwicklung einer Headless-HealthTech- und Präzisions-Ernährungsplattform mit Next.js 16, WordPress und Supabase

Technischer und architektonischer Deep-Dive zu Unitrition (unitrition.info): Entkopplung von WordPress CMS und Next.js 16 App Router, Integration der USDA FoodData Central API für Echtzeit-Broteinheiten und glykämische Kurvenmodellierung über 10 klinische Ernährungsprotokolle sowie Datensicherheit durch Supabase RLS.

AY
Artur Yusupov
Fullstack Web-Engineer & KI-Entwickler
Praxiseinsatz:Unitrition
Unitrition Architektur-Deep-Dive: Entwicklung einer Headless-HealthTech- und Präzisions-Ernährungsplattform mit Next.js 16, WordPress und Supabase

1. Executive Summary & Die HealthTech-Herausforderung

Patienten und gesundheitsbewusste Menschen, die strenge Ernährungsprotokolle befolgen (wie Diabetes Typ 1/Typ 2, ketogene, Low-FODMAP-, Nieren- oder mediterrane Diäten), stehen täglich vor einer hohen kognitiven Belastung: Sie müssen rohe Nährwertkennzeichnungen mit komplexen klinischen Leitlinien abgleichen und manuell Broteinheiten (BE / Kohlenhydrateinheiten) sowie die glykämische Last berechnen.

Gleichzeitig leiden traditionelle Medizinportale, die auf monolithischen CMS-Templates basieren, unter einer langsamen mobilen Performance bei Abfragen großer Nährwertdatenbanken und bieten keine interaktiven clientseitigen Modellierungswerkzeuge.

Unitrition (unitrition.info) wurde entwickelt, um klinische Ernährungsdaten mit moderner Fullstack-Performance zu verbinden. Durch die Kombination von Headless WordPress, Next.js 16 App Router (React 19), Supabase PostgreSQL und der offiziellen USDA FoodData Central API liefert die Plattform eine Kompatibilitätsbewertung von Lebensmitteln im Subsekundenbereich über 10 Ernährungsprotokolle, eine Echtzeit-Berechnung von Broteinheiten sowie interaktive Visualisierungen glykämischer Kurven.


2. Architecture Decision Records (ADR - Warum wir diesen Stack gewählt haben)

Architekturentscheidung
Hybrider Headless-Stack (Next.js 16 + Headless WordPress REST API)
Verworfene Alternative
Monolithisches PHP-WordPress-Theme mit Custom AJAX
Technische & geschäftliche Begründung
Ernährungswissenschaftler und medizinische Redakteure behalten den gewohnten WordPress/ACF Pro-Workflow bei, während Endnutzer ein blitzschnelles React 19 App Router-Frontend mit 95+ PageSpeed und null PHP-Template-Engpässen erhalten.
Architekturentscheidung
Supabase PostgreSQL + Auth für Nutzerprofile
Verworfene Alternative
Speicherung von Nutzerkonten in WordPress wp_users
Technische & geschäftliche Begründung
Die Entkopplung der Nutzerauthentifizierung und persönlicher Ernährungsprotokolle in Supabase mit Row Level Security (RLS) verhindert, dass WordPress-Plugin-Schwachstellen jemals sensible Gesundheitspräferenzen offenlegen können.
Architekturentscheidung
Serverseitiger Next.js-Proxy für die USDA FoodData API
Verworfene Alternative
Direkter clientseitiger fetch() zur USDA API
Technische & geschäftliche Begründung
Schützt den privaten USDA-API-Schlüssel vor clientseitiger Offenlegung, normalisiert inkonsistente JSON-Schemata von Drittanbietern auf dem Server und wendet Edge-Caching an, um Rate-Limit-Überschreitungen zu verhindern.
Architekturentscheidung
Zweisprachiges Routing & Schema.org-Graph (`EN / ES`)
Verworfene Alternative
Reine Client-Übersetzungsstrings ohne URL-Routing
Technische & geschäftliche Begründung
Dedizierte lokalisierte URLs mit hreflang-Alternativen und strukturierten medizinischen/ernährungswissenschaftlichen Schema.org-Daten maximieren die organische Sichtbarkeit in englisch- und spanischsprachigen Suchmärkten.

3. Kernmechanismen: Wie Unitrition unter der Haube arbeitet

Mechanismus 1: Der USDA FoodData Central Proxy & die Nährstoff-Normalisierungs-Pipeline

Die Datenbank von USDA FoodData Central enthält Hunderttausende von Lebensmitteln (Foundation Foods, SR Legacy, Branded Foods), die Nährstoffe jeweils in leicht unterschiedlichen verschachtelten Strukturen und Einheiten-IDs ausweisen (z. B. Energie in kcal vs. kJ, Gesamtkohlenhydrate nach Differenz, Ballaststoffe, Gesamtzucker).

Wenn ein Nutzer in Unitrition nach einer Zutat sucht:

1
Der Client sendet eine per Debounce verzögerte Anfrage an unseren internen Next.js Route Handler.
2
Der Server-Proxy authentifiziert sich bei der USDA API über rein serverseitige Umgebungsvariablen, extrahiert das rohe Nährstoff-Array und überführt die Nährstoff-IDs in ein striktes, typsicheres NormalizedFoodItem-Interface.
3
Antworten werden mit stale-while-revalidate-Headern zwischengespeichert, sodass häufige Lebensmittelabfragen in unter 30ms aufgelöst werden.
TS
// Konzeptioneller Blueprint der Berechnung von Broteinheiten (BE) & Netto-Kohlenhydraten
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 Broteinheit (BE) = 12g verwertbare Kohlenhydrate
  const breadUnits = Number((digestibleCarbs / 12).toFixed(2))
  return { digestibleCarbs: Number(digestibleCarbs.toFixed(1)), breadUnits }
}

Mechanismus 2: Deterministische 10-Diäten-Ampel-Scoring-Engine

Anstatt sich auf langsame oder unvorhersehbare LLM-Aufrufe zu verlassen, um zu beurteilen, ob ein Lebensmittel zu einer Diät passt, nutzt Unitrition eine deterministische klinische Regelmatrix über 10 Ernährungsprotokolle hinweg:

  • Jedes Diätprofil definiert strikte Makronährstoffverhältnisse, Obergrenzen für die glykämische Last und ausgeschlossene Lebensmittelgruppen.
  • Wenn ein Nutzer einen Ernährungsplan auswählt und Lebensmittel sucht, berechnet die Engine sofort einen farbcodierten Kompatibilitätswert:
  • Grün (Optimale Eignung): Innerhalb der Makroziele und mit geringer glykämischer Auswirkung.
  • Gelb (Moderat / Portionskontrolle): Erfordert eine genaue Portionsanpassung auf Basis der berechneten Broteinheiten.
  • Rot (Vermeiden): Überschreitet Kohlenhydrat-, Natrium- oder Lipidschwellenwerte für das aktive Protokoll.

Mechanismus 3: Simulation der kontinuierlichen Glukoseüberwachung (CGM) & PDF-Export

Um Nutzern visuell zu verdeutlichen, *warum* Ballaststoffe und Proteine die Glukoseaufnahme im Vergleich zu raffiniertem Zucker verlangsamen, enthält Unitrition einen interaktiven Simulator für die glykämische Reaktion:

  • Basierend auf dem Verhältnis von verwertbaren Kohlenhydraten, Ballaststoffen, Fett und Protein in der gewählten Portion modelliert die Engine die prognostizierte postprandiale Glukosekurve über ein 180-Minuten-Fenster.
  • Nutzer können ihre ausgewählten Lebensmittel und Mahlzeitenberechnungen direkt im Browser zu einem sauberen, druckfertigen PDF-Ernährungsbericht zusammenstellen.

Mechanismus 4: Entkoppeltes Redaktions-CMS über Headless WordPress & ISR

Wissenschaftliche Ernährungsartikel und klinische Leitfäden werden in einer gehärteten Headless-WordPress-Instanz mit Advanced Custom Fields (ACF Pro) verwaltet:

  • Next.js ruft strukturierte Beitragsdaten über die WP REST API während des Builds und mittels Incremental Static Regeneration (ISR) ab.
  • Jeder Artikel generiert automatisch Schema.org `Article`- und `FAQPage`-JSON-LD-Markup, um medizinische und ernährungsbezogene Such-Snippets zu gewinnen.

4. Engineering-Glossar: Jeder Schlüsselbegriff erklärt

  • Headless-CMS-Architektur:
  • *Was es ist*: Die Trennung des Backend-Content-Management-Systems (WordPress) von der Frontend-Präsentationsschicht (Next.js).
  • *Warum es wichtig ist*: Redakteure arbeiten in einer vertrauten Oberfläche, während Besucher sofortige React-Seitenübergänge und höchste Sicherheit erleben, da das CMS-Admin-Panel vor öffentlichem Traffic verborgen bleibt.
  • Incremental Static Regeneration (ISR):
  • *Was es ist*: Ein Next.js-Mechanismus, der statische Seiten im Hintergrund nach dem Deployment aktualisiert, sobald sich CMS-Inhalte ändern, ohne die gesamte Website neu zu bauen.
  • *Warum es wichtig ist*: Kombiniert die Geschwindigkeit von statischem HTML mit der Aktualität einer dynamischen Datenbank.
  • Broteinheiten (BE / Kohlenhydrateinheit):
  • *Was es ist*: Eine klinische Maßeinheit in der Ernährungsmedizin und im Diabetesmanagement (1 BE entspricht 10g-12g verwertbaren Kohlenhydraten abzüglich Ballaststoffen) zur Abschätzung des Insulinbedarfs und der glykämischen Wirkung.
  • *Warum es wichtig ist*: Die automatische BE-Berechnung für beliebige Portionsgrößen in Gramm eliminiert manuelle Rechenfehler für Nutzer.
  • Serverseitiger API-Proxy:
  • *Was es ist*: Ein zwischengeschalteter Backend-Endpunkt, der Client-Anfragen an einen externen Dienst (USDA API) weiterleitet, geheime Schlüssel auf dem Server hinzufügt und die Antwort bereinigt.
  • *Warum es wichtig ist*: Verhindert den Diebstahl von API-Schlüsseln und schirmt das Frontend gegen Breaking Changes von Drittanbieter-APIs ab.
  • Supabase Row Level Security (RLS):
  • *Was es ist*: Feingranulare Zugriffskontrolle direkt in PostgreSQL, die auth.uid() = user_id bei jeder Datenbankabfrage erzwingt.
  • *Warum es wichtig ist*: Stellt sicher, dass ein Nutzer niemals das gespeicherte Ernährungsprofil eines anderen Nutzers lesen oder ändern kann.

5. Defense-in-Depth-Sicherheitsarchitektur

1
Zero-Trust-Trennung von CMS und Nutzerdaten: Selbst wenn das redaktionelle WordPress-CMS jemals Ziel eines Angriffs werden sollte, befinden sich Nutzerkonten und persönliche Ernährungsdaten in einem isolierten Supabase-PostgreSQL-Cluster, das durch RLS geschützt ist.
2
Serverseitige Geheimnis-Isolierung: USDA-API-Schlüssel und Supabase-Service-Keys sind strikt auf serverseitige Umgebungsvariablen beschränkt und landen niemals im Client-JavaScript-Bundle.
3
Eingabevalidierung & Rate-Protection: Suchanfragen und Rechnereingaben werden bereinigt und per Debounce gedrosselt, bevor sie den Server-Proxy erreichen, um eine Erschöpfung des Upstream-API-Kontingents zu verhindern.
Praxiserprobter Produktiveinsatz

Wo diese Architektur produktiv eingesetzt wird

Diese Architekturmuster sind keine abstrakte Theorie - sie sind in den folgenden Live-Produkten vollständig implementiert und getestet:

Webentwicklung in Sevilla & Spanien / KMU & Kliniken

Maßgeschneiderte Webentwicklung für Unternehmen & Kliniken in Sevilla und Spanien

Schnelle, barrierefreie und konversionsstarke Websites für KMU, Praxen und Kanzleien in Sevilla und ganz Spanien. Ohne langsame Baukästen und ohne versteckte Gebühren.

Leistungsdetails ansehen
Architekturberatung

Planen Sie eine Stack-Migration oder einen Neuaufbau?

Besprechen Sie Ihre Architekturanforderungen mit meinem interaktiven RAG-KI-Assistenten oder kontaktieren Sie mich direkt für eine technische Bewertung.

Direkt kontaktieren