Повний розбір архітектури 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.

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-трафік англійською та іспанською мовами. |
wp_users WordPressfetch() запити до USDA APIhreflang та медичною мікророзміткою Schema.org максимізують органічний SEO-трафік англійською та іспанською мовами.3. Ключові механізми: Як працює Unitrition під капотом
Механізм 1: Серверний проксі USDA FoodData Central та нормалізація нутрієнтів
База даних USDA FoodData Central містить сотні тисяч продуктів, де макро- та мікроелементи передаються у глибоко вкладених масивах із різними ідентифікаторами та одиницями вимірювання (наприклад, енергія в kcal чи kJ, вуглеводи за різницею, клітковина, цукри).
Коли користувач вводить назву продукту в Unitrition:
NormalizedFoodItem.stale-while-revalidate, тому повторні пошукові запити виконуються менш ніж за 30ms.// Концептуальна формула розрахунку Хлібних Одиниць (ХО) та засвоюваних вуглеводів
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)
Де ця архітектура працює у моєму портфоліо
Ці інженерні рішення не є абстрактною теорією - вони повністю реалізовані та перевірені у наступних робочих продуктах:
Розробка сучасних веб-сайтів під ключ для бізнесу в Севільї та Іспанії
Швидкі, доступні сайти з фокусом на генерацію реальних заявок для компаній, клінік та експертів у Севільї та по всій Іспанії. Без шаблонних конструкторів та прихованих витрат.
Плануєте міграцію стеку або розробку продукту?
Обговоріть архітектурні вимоги вашого проєкту з інтерактивним RAG AI-асистентом або зв’яжіться напряму для інженерної оцінки.
Інші інженерні статті
Next.js 16 проти Headless WordPress та Custom PHP: об’єктивний аналіз TCO, продуктивності та SEO (2026)
Інженерний аналіз архітектури, витрат на підтримку (TCO) та показників Google Core Web Vitals для Next.js 16, Headless WordPress та кастомного PHP.
Повний розбір архітектури Fullstack AI Lab: компіляція 1 135+ MDX-уроків за 90 секунд на Next.js 16 та Rust MDX-RS
Повний технічний та архітектурний розбір інтерактивної освітньої платформи Fullstack AI Lab: як ми прискорили статичну збірку у 14 разів (із 21.6 хв до 1.5 хв), створили браузерну WebAssembly-пісочницю WordPress, симулятор AI-співбесід, інтерактивні симулятори рантайму та аудіогенератор для NotebookLM.