Перейти до основного вмісту
Системна архітектура
8 хв читання

Повний розбір архітектури Unitrition: розробка Headless HealthTech-платформи персоналізованого харчування на Next.js 16, WordPress та Supabase

Технічний та архітектурний розбір платформи Unitrition (unitrition.info): поєднання Headless WordPress із Next.js 16 App Router, інтеграція USDA FoodData Central API для розрахунку Хлібних Одиниць і глікемічних кривих для 10 дієт та захист даних через Supabase RLS.

AY
Artur Yusupov
Fullstack веб-інженер та AI-розробник
Впроваджено в проєктах:Unitrition
Повний розбір архітектури Unitrition: розробка Headless HealthTech-платформи персоналізованого харчування на Next.js 16, WordPress та Supabase

1. Executive Summary та задача HealthTech-інженерії

Люди, які дотримуються спеціалізованих медичних або оздоровчих дієт (діабетична, кетогенна, Low-FODMAP, ниркова, середземноморська тощо), щодня стикаються зі складним когнітивним навантаженням: їм доводиться вручну звіряти етикетки продуктів із клінічними таблицями та вираховувати Хлібні Одиниці (ХО / Bread Units) і глікемічне навантаження.

При цьому класичні медичні портали на монолітних CMS працюють повільно на мобільних пристроях при пошуку у великих базах продуктів і не дають інтерактивних інструментів моделювання раціону.

Платформа Unitrition (unitrition.info) була створена на стику клінічної нутриціології та сучасної fullstack-архітектури. Поєднуючи Headless WordPress, Next.js 16 App Router (React 19), Supabase PostgreSQL та державну базу даних США USDA FoodData Central API, система забезпечує миттєвий скоринг продуктів за 10 дієтичними протоколами, автоматичний розрахунок Хлібних Одиниць та візуалізацію глікемічних кривих.


2. Architecture Decision Records (ADR - Чому обрано саме цей стек)

Архітектурне рішення
Гібридний Headless-стек (Next.js 16 + Headless WordPress REST API)
Відхилена альтернатива
Монолітна PHP-тема WordPress із AJAX
Інженерне та бізнес-обґрунтування
Нутриціологи та редактори отримують зручну адмінку WordPress + ACF Pro для ведення довідників, а користувачі - миттєвий інтерфейс на React 19 із 95+ PageSpeed.
Архітектурне рішення
Supabase PostgreSQL + Auth для профілів користувачів
Відхилена альтернатива
Зберігання акаунтів у таблиці wp_users WordPress
Інженерне та бізнес-обґрунтування
Ізоляція авторизації та особистих профілів харчування у Supabase із Row Level Security (RLS) гарантує безпеку персональних даних незалежно від редакційної CMS.
Архітектурне рішення
Серверний проксі Next.js для USDA FoodData API
Відхилена альтернатива
Прямі клієнтські fetch() запити до USDA API
Інженерне та бізнес-обґрунтування
Приховує приватний API-ключ на сервері, нормалізує складну вкладену JSON-схему USDA у типізований контракт і кешує відповіді на Edge.
Архітектурне рішення
Двомовна маршрутизація та Schema.org (`EN / ES`)
Відхилена альтернатива
Клієнтський переклад без окремих URL
Інженерне та бізнес-обґрунтування
Локалізовані маршрути з тегами hreflang та медичною мікророзміткою Schema.org максимізують органічний SEO-трафік англійською та іспанською мовами.

3. Ключові механізми: Як працює Unitrition під капотом

Механізм 1: Серверний проксі USDA FoodData Central та нормалізація нутрієнтів

База даних USDA FoodData Central містить сотні тисяч продуктів, де макро- та мікроелементи передаються у глибоко вкладених масивах із різними ідентифікаторами та одиницями вимірювання (наприклад, енергія в kcal чи kJ, вуглеводи за різницею, клітковина, цукри).

Коли користувач вводить назву продукту в Unitrition:

1
Клієнт відправляє дебаунс-запит до внутрішнього Next.js Route Handler.
2
Серверний проксі авторизується в USDA API через захищені серверні змінні, витягує масив нутрієнтів і трансформує його у строго типізований об'єкт NormalizedFoodItem.
3
Відповіді кешуються із заголовком stale-while-revalidate, тому повторні пошукові запити виконуються менш ніж за 30ms.
TS
// Концептуальна формула розрахунку Хлібних Одиниць (ХО) та засвоюваних вуглеводів
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 Хлібна Одиниця (ХО) = 12 г засвоюваних вуглеводів
  const breadUnits = Number((digestibleCarbs / 12).toFixed(2))
  return { digestibleCarbs: Number(digestibleCarbs.toFixed(1)), breadUnits }
}

Механізм 2: Детермінований рушій скорингу для 10 дієт (Traffic-Light Scoring)

Замість використання повільних і схильних до галюцинацій LLM-запитів для оцінки їжі, Unitrition використовує детерміновану клінічну матрицю правил для 10 дієтичних планів:

  • Кожна дієта має чіткі пороги макронутрієнтів, глікемічного навантаження та стоп-списки інгредієнтів.
  • Система миттєво присвоює продукту колірний статус:
  • Зелений (Оптимально): Повністю відповідає обраній дієті та має низький глікемічний вплив.
  • Жовтий (Помірно / Контроль порції): Допустимо за умови точного розрахунку порції та Хлібних Одиниць.
  • Червоний (Уникати): Перевищує допустимі ліміти вуглеводів, натрію або жирів для активного плану.

Механізм 3: Симуляція глікемічних кривих (CGM) та генерація PDF-звітів

Щоб наочно показати користувачеві, як клітковина та білки уповільнюють засвоєння глюкози, в Unitrition реалізовано симулятор глікемічного відгуку (CGM Simulation):

  • На основі балансу засвоюваних вуглеводів, клітковини, білків і жирів у вибраній порції алгоритм будує графік прогнозованої динаміки глюкози на 180 хвилин.
  • Результати підбору та розрахунки ХО можна в один клік експортувати у структурований PDF-звіт раціону.

Механізм 4: Headless WordPress та Incremental Static Regeneration (ISR)

Освітні статті та довідники дієт ведуться в ізольованій панелі WordPress за допомогою ACF Pro:

  • Next.js отримує структурований контент через WP REST API і оновлює статичні сторінки у фоновому режимі через ISR.
  • Кожна стаття автоматично збагачується мікророзміткою Schema.org (`Article`, `FAQPage`) для максимальної видимості в Google.

4. Інженерний глосарій: Пояснення кожного терміна та механізму

  • Headless CMS:
  • *Що це*: Архітектура, де панель управління контентом (WordPress) відокремлена від зовнішнього інтерфейсу сайту (Next.js).
  • *Користь*: Редактори працюють у звичному інтерфейсі, а користувачі отримують миттєвий React-сайт, захищений від типових вразливостей публічних тем WordPress.
  • Incremental Static Regeneration (ISR):
  • *Що це*: Механізм Next.js, який дозволяє оновлювати окремі статичні сторінки у фоні після зміни даних у CMS без повної перезбірки всього сайту.
  • *Користь*: Поєднує субсекундну швидкість статики з актуальністю динамічного порталу.
  • Хлібна Одиниця (ХО / Bread Unit):
  • *Що це*: Умовна одиниця для оцінки кількості вуглеводів у продуктах (1 ХО дорівнює 10-12 г засвоюваних вуглеводів за вирахуванням клітковини).
  • *Користь*: Автоматизує складні щоденні розрахунки при плануванні раціону.
  • Серверний API-проксі (Server-Side API Proxy):
  • *Що це*: Проміжний серверний вузол, який приймає запит від браузера, додає секретний ключ на сервері, звертається до зовнішнього сервісу (USDA) і повертає очищені дані.
  • *Користь*: Гарантує, що ключі API неможливо викрасти через DevTools.
  • Supabase Row Level Security (RLS):
  • *Що це*: Політики безпеки на рівні бази даних PostgreSQL, які дозволяють читати або змінювати лише ті рядки, де user_id збігається з криптографічним токеном поточного користувача.
  • *Користь*: Абсолютна приватність збережених дієтичних налаштувань.

5. Ешелонована безпека (Defense-in-Depth Security)

1
Повне розділення редакційної CMS та персональних даних: Дані користувачів та авторизація фізично відокремлені від WordPress і знаходяться в захищеному кластері Supabase PostgreSQL із увімкненим RLS.
2
Ізоляція секретів на сервері: Ключі USDA FoodData Central та сервісні токени ніколи не потрапляють у клієнтський бандл браузера.
3
Захист від перевантаження API: Дебаунсинг на клієнті та серверне кешування захищають зовнішні шлюзи від спам-запитів.
Практичне впровадження в коді

Де ця архітектура працює у моєму портфоліо

Ці інженерні рішення не є абстрактною теорією - вони повністю реалізовані та перевірені у наступних робочих продуктах:

Веб-розробка в Севільї та Іспанії / Малий бізнес та клініки

Розробка сучасних веб-сайтів під ключ для бізнесу в Севільї та Іспанії

Швидкі, доступні сайти з фокусом на генерацію реальних заявок для компаній, клінік та експертів у Севільї та по всій Іспанії. Без шаблонних конструкторів та прихованих витрат.

Переглянути послугу
Архітектурний аудит

Плануєте міграцію стеку або розробку продукту?

Обговоріть архітектурні вимоги вашого проєкту з інтерактивним RAG AI-асистентом або зв’яжіться напряму для інженерної оцінки.

Написати напряму