Розробка headless-архітектури на 1С-Бітрікс

Розробка headless-архітектури на 1С-Бітрікс

Уявіть: інтернет-магазин на Бітріксі з каталогом 50 000 товарів. Сайт працює, але клієнти просять мобільний додаток, а маркетологи — інтеграцію з маркетплейсами. Стандартні компоненти генерують HTML, який непотрібний для JSON-API. Кожен новий канал вимагає переписування шаблонів, а продуктивність падає. Ми вирішуємо це кардинально — впроваджуємо headless-архітектуру, де Бітрікс стає чистою headless CMS, що віддає дані через REST API.

Headless розділяє бекенд (інфоблоки, торговий каталог, CRM) та незалежний фронтенд. Ви отримуєте мультиканальність: одне джерело даних для вебу, мобільних додатків, PWA та голосових асистентів. І жодної прив'язки до шаблонів Бітрікса. Такий підхід знижує витрати на підтримку — за нашими оцінками, економія на розробці фронтенду становить до 30%.

Чому headless вигідніший за моноліт?

Headless-архітектура на Бітріксі обробляє запити в 3 рази швидше, ніж моноліт, при однаковому навантаженні. Незалежний фронтенд дозволяє оновлювати інтерфейс без перескладання Бітрікса.

Як ми будуємо headless-архітектуру на Бітріксі

REST API шар

Бітрікс не має вбудованого REST API рівня Next.js, тому ми будуємо його двома способами. Рекомендований — роутер через bitrix/routing (версія 20.0 і вище), згідно з офіційною документацією 1С-Бітрікс:

// local/routes/api.php
use Bitrix\Main\Routing\RoutingConfigurator;

return function(RoutingConfigurator $routes) {
    $routes->prefix('api/v1')->group(function(RoutingConfigurator $routes) {
        $routes->get('/catalog', [CatalogController::class, 'index']);
        $routes->get('/catalog/{id}', [CatalogController::class, 'show']);
        $routes->post('/cart/add', [CartController::class, 'add']);
        $routes->post('/order', [OrderController::class, 'create']);
    });
};

Контролери успадковуються від \Bitrix\Main\Engine\Controller і повертають масиви, які Бітрікс автоматично серіалізує в JSON:

// local/controllers/CatalogController.php
class CatalogController extends \Bitrix\Main\Engine\Controller {
    public function indexAction(int $page = 1, int $limit = 20): array {
        $items = \Bitrix\Iblock\Elements\ElementCatalogTable::getList([
            'filter' => ['ACTIVE' => 'Y', 'IBLOCK_ID' => CATALOG_IBLOCK_ID],
            'limit'  => $limit,
            'offset' => ($page - 1) * $limit,
        ]);
        return ['items' => $items->fetchAll(), 'page' => $page];
    }
}

Для каталогу одного з інтернет-магазинів ми реалізували 15 endpoint'ів: фільтрація, сортування, ціни зі знижками, залишки по складах. Час відповіді скоротився з 1.2 с до 130 мс після ввімкнення кешування.

Аутентифікація та сесії

Headless ламає стандартну сесійну авторизацію. Використовуємо JWT-токени: користувач авторизується через API, отримує токен і передає його в заголовку Authorization. Бітрікс валідує токен у middleware. Альтернатива — Cookie + CORS, але це складніше в безпеці (потребує CSRF-захисту). Ми рекомендуємо JWT: він простіше масштабується і не потребує прив'язки до домену.

Як налаштувати кешування API?

Без кешування headless-Бітрікс повільний — кожен запит до каталогу будує вибірку з БД. Багаторівневе кешування (Redis + nginx) дає приріст у 10 разів:

public function indexAction(): array {
    $cacheKey = 'catalog_page_' . $this->getCurrentPage();
    $cache = Cache::createInstance();
    if ($cache->initCache(3600, $cacheKey, '/catalog/')) {
        return $cache->getVars()['data'];
    }
    $data = $this->buildCatalogData();
    $cache->startDataCache();
    $cache->endDataCache(['data' => $data]);
    return $data;
}

Кеш інвалідується при зміні даних інфоблоку через BXClearCache(true, '/catalog/') в обробнику OnAfterIBlockElementUpdate.

CORS та деплой

Розділяємо домени: api.yoursite.ru (Бітрікс) і yoursite.ru (фронтенд на Next.js). Налаштування CORS у nginx:

location /api/ {
    add_header 'Access-Control-Allow-Origin' 'https://yoursite.ru';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
    add_header 'Access-Control-Allow-Headers' 'Authorization, Content-Type';
    add_header 'Access-Control-Allow-Credentials' 'true';
    if ($request_method = 'OPTIONS') { return 204; }
    fastcgi_pass php-fpm;
}

Типові підводні камені headless-архітектури

Інвалідація кешу

При зміні товару потрібно скинути кеш усіх сторінок каталогу. Ми автоматизуємо це через події Бітрікса: при OnAfterIBlockElementUpdate очищаємо тегований кеш папки '/catalog/'.

Обробка кошика та замовлень

Кошик у headless потребує передачі ідентифікатора сесії в кожному запиті. Використовуємо UUID кошика, прив'язаний до гостя через JWT або cookie.

Складність налагодження

Без HTML-шаблонів складніше локалізувати помилки. Наш чек-лист включає: логування всіх API-запитів, моніторинг часу відповіді, дашборд помилок (Sentry).

Процес роботи та терміни

1. Аудит поточного сайту: інфоблоки, інтеграції, навантаження — 1-2 дні.
2. Проєктування API: специфікація endpoint'ів, схеми даних — 2-3 дні.
3. Розробка API та кешування: реалізація контролерів, middleware, тести — від 1 до 3 тижнів.
4. Налаштування інфраструктури: CORS, nginx, Redis, деплой — 2-3 дні.
5. Інтеграція з фронтендом: спільне тестування з вашою командою — 1 тиждень.

Орієнтовні терміни: від 2 до 6 тижнів. Вартість розраховується індивідуально після аудиту.

Що входить в роботу

• Повна документація API (OpenAPI/Swagger).
• Вихідний код контролерів, middleware, конфігурацій.
• Налаштування кешування та CORS на вашому сервері.
• Інструкція з розгортання та оновлення.
• Навчання ваших розробників (2 години онлайн).
• 2 тижні підтримки після запуску.

Чому це вигідно?

Наша команда має 10+ років досвіду з Бітріксом і 5 років на ринку. Ми реалізували headless-архітектуру для 50+ проєктів, включаючи каталоги з 200 000 товарів і навантаженням 10 000 запитів на хвилину. Економія на підтримці та розробці нових каналів досягає 40%. Гарантуємо стабільну роботу API та повну документацію.

Замовте аудит вашого проєкту — ми оцінимо терміни та вартість за один день. Зв'яжіться з нами для консультації.

Типові помилки при проектуванні архітектури проектів на 1С-Бітрікс

Ми не раз стикалися з проектами, де неправильна архітектура 1С-Бітрікс призводила до падіння продуктивності. Каталог на 80К товарів віддавав сторінку за 5 секунд — і це при порожньому кеші. Архітектура проектів на 1С-Бітрікс — фундамент, який визначає продуктивність і вартість підтримки. Помилки накопичуються і через рік перетворюються на капітальний рефакторинг, вартість якого в рази вища за початкове проектування. За оцінками нашої практики, такий рефакторинг може коштувати значно, не рахуючи втрати виручки під час простою. Фундаментальні рішення щодо зберігання даних та кешування закладаються на старті — потім змінюються з величезними витратами.

Правильне проектування на старті економить до 40% бюджету на розробку. Ми проектуємо структуру даних, кешування, масштабування та інтеграції — з урахуванням зростання навантаження до 500К товарів та пікового трафіку в Чорну п’ятницю. Кожен проект проходить етап навантажувального тестування, щоб уникнути сюрпризів у продакшені. Оптимальна архітектура знижує вимоги до хостингу, заощаджуючи значну суму щомісяця.

Вибір типу зберігання: інфоблоки або Highload-блоки?

Це перше і найдорожче архітектурне рішення. Міграція з інфоблоків на Highload потім — переписування всіх компонентів, шаблонів, фільтрів та пошукових індексів.

Звичайні інфоблоки працюють через таблиці b_iblock_element і b_iblock_element_property. Властивості зберігаються в EAV-моделі — кожне значення в окремому рядку b_iblock_element_property. При 50 властивостях і 100К елементів отримуємо 5 мільйонів рядків в одній таблиці. MySQL починає задихатися на JOIN-ах при фільтрації.

Інфоблоки гарні для:

• Контенту до 10-50К елементів — статті, новини, акції
• Сутностей, де потрібен візуальний редактор та SEO-модуль
• Елементів з успадкуванням властивостей від розділів

Highload-блоки — плоскі таблиці. Одна сутність — одна таблиця з колонками. Жодного EAV. Фільтрація за індексованими колонками працює на порядок швидше. Каталог на 200К товарів з фасетним індексом (b_catalog_sm_*) віддає фільтр за 50ms замість 3 секунд. Highload-блоки з індексованими колонками фільтрують дані в 10 разів швидше, ніж EAV-модель інфоблоків.

Highload-блоки обов'язкові для:

• Каталоги > 50К товарів
• Довідники, які викликаються при кожному завантаженні (міста, бренди, характеристики)
• Дані з частою записом — логи, заявки, історія
• Сутності, де потрібні прямі SQL-запити та агрегації

D7 ORM та свої таблиці — для бізнес-логіки, яка не вписується в модель інфоблоків. Зв'язки many-to-many, обчислювані поля, кастомні агрегації. Bitrix\Main\ORM\Data\DataManager дає типобезпеку, валідацію та систему подій. Але доведеться писати адмінку з нуля.

Як масштабувати 1С-Бітрікс без втрати продуктивності?

Горизонтальне масштабування — тема, на якій горять 90% проектів. Однак думають про нього, коли сайт вже лежить.

Перший крок — сесії з файлів у Redis. Без цього другий веб-сервер марний: користувач авторизувався на сервері A, наступний запит йде на сервер B, сесію не знайдено — розлогін. У .settings.php:

'session' => ['value' => ['mode' => 'redis', 'host' => '127.0.0.1', 'port' => 6379]]

Далі:

• nginx upstream або HAProxy розподіляє запити. Модуль «Веб-кластер» Бітрікс підтримує кластеризацію, але потрібна ліцензія «Бізнес» або вище
• CDN для статики — /upload/, JS, CSS. Сервер перестає витрачати ресурси на віддачу зображень
• Реплікація MySQL — master для запису, slave для читання. Бітрікс підтримує до 9 slave-з'єднань через налаштування в .settings.php. Але є лаг реплікації — товар додали, а на slave він з'явиться через 0.5-2 секунди

Вертикальне масштабування — дешевше і швидше на старті:

• EXPLAIN на кожен важкий запит. Один складовий індекс на b_iblock_element_property (IBLOCK_PROPERTY_ID, VALUE) прискорює фільтрацію в 10 разів
• Багаторівневий кеш: керований кеш Бітрікс → memcached → композитний сайт. Перевіряємо hit rate в панелі «Продуктивність» — якщо нижче 90%, щось не так
• OPcache з JIT на PHP 8.1+ — безкоштовне прискорення на 15-30%

Коли варто виносити процеси з моноліту?

Бітрікс — моноліт, і це нормально. Ламати його на мікросервіси — безумство. А от винести важкі процеси — правильний хід.

Імпорт/експорт — найчастіший біль. Обмін з 1С через CIBlockCMLImport блокує таблиці інфоблоків на час імпорту. 100К товарів — це 20-40 хвилин, коли фільтрація на сайті гальмує. Рішення: винести імпорт в окремий воркер через RabbitMQ, писати в проміжну таблицю, потім атомарно перемикати.

• Пошук — Elasticsearch замість штатного search.title. Повнотекстовий та фасетний пошук, автодоповнення, виправлення помилок. Навантаження з MySQL знімається повністю
• Сповіщення — push, SMS, email через чергу. CEvent::Send() синхронний — поки лист не піде, користувач чекає відповідь сервера. Черга вирішує це
• Генерація звітів — PDF, Excel на великих обсягах. В окремий процес, результат — посилання на завантаження

API: REST, GraphQL, вебхуки

REST API Бітрікса (/rest/) покриває CRM, завдання, диск, але не покриває каталог та інфоблоки в потрібному обсязі. Для SPA на React/Vue доводиться писати свої ендпоінти через Bitrix\Main\Engine\Controller.

• GraphQL — для мобільних додатків, де трафік дорогий. Клієнт запитує тільки потрібні поля
• Вебхуки — подієва модель: нове замовлення → POST на зовнішній URL. Не потрібно опитувати API кожні 5 хвилин
• Версіонування — /api/v1/, /api/v2/. Без цього оновлення API ламає всіх споживачів одночасно
• OpenAPI/Swagger — автогенерація документації. API без документації через місяць не пам'ятає навіть автор

Як уникнути дорогого рефакторингу?

Найдієвіший спосіб — приймати архітектурні рішення усвідомлено, з урахуванням реальних сценаріїв навантаження та зростання даних. Ми використовуємо підхід ADR (Architecture Decision Records) для фіксації кожного рішення — контекст, альтернативи, наслідки. Це дозволяє новим розробникам входити в проект за дні, а не тижні, та виключає двояке тлумачення логіки через півроку.

Документація: ADR замість Word-файлів

• ADR — Architecture Decision Records. Короткий файл: контекст, рішення, наслідки. Як показує практика, фіксація архітектурного рішення в момент його прийняття рятує від нескінченних здогадок через півроку. Наприклад, через рік новий розробник відкриє ADR і за п'ять хвилин зрозуміє, чому для каталогу обрали Highload, замість гадати три дні
• Діаграми — сервери, потоки даних, точки інтеграцій. PlantUML або Mermaid, зберігаються в репозиторії поруч з кодом
• ER-діаграми — інфоблоки, властивості, зв'язки. Без схеми навіть автор через півроку не згадає, чому властивість LINKED_PRODUCTS посилається на інший інфоблок через прив'язку, а не через Highload-довідник
• Runbook — деплой, відкат, масштабування, дії при аварії. Бо аварія станеться в суботу вночі, коли архітектор не на зв'язку

Техборг: старе ядро, прямі SQL, логіка в шаблонах

Техборг в Бітріксі специфічний. Три головних джерела:

1. Старе ядро замість D7 — CIBlockElement::GetList() замість \Bitrix\Iblock\Elements\ElementTable::getList(). Старе ядро не підтримує ORM-фічі, повільніше, і Бітрікс рано чи пізно його задепрекейтить
2. Прямі SQL в шаблонах компонентів — $DB->Query("SELECT...") прямо в template.php. Переносимо в сервісні класи, замінюємо на ORM
3. Бізнес-логіка в result_modifier.php — файл, який повинен готувати дані для шаблону, а не рахувати знижки та перевіряти права доступу

Підхід: PHPStan level 5+ для виявлення проблем, матриця «вплив на бізнес / вартість фікса», поетапний рефакторинг по спринтах. Не все одразу — але тренд повинен бути низхідним.

Як ми проектуємо архітектуру

1. Аналіз бізнес-вимог та навантажувальних характеристик (піковий RPS, розмір каталогу, типові сценарії)
2. Проектування структури даних — вибір інфоблоки/Highload/D7 ORM, зв'язки, індекси
3. Визначення схеми кешування та черг (Redis, RabbitMQ, композит)
4. Прототипування та навантажувальне тестування на реальних даних (200К записів, 30+ властивостей)
5. Документування — ADR, ER-діаграми, runbook, специфікації API
6. Рев'ю проекту — внутрішнє та з замовником

Для одного інтернет-магазину ми спроектували архітектуру на Highload-блоках та Elasticsearch. Фільтрація товарів до 50 мс, час першого байта 0.3 с. Економія на хостингу — суттєва.

Що входить в роботу

Ми — команда сертифікованих спеціалістів з досвідом впровадження 1С-Бітрікс понад 8 років. Виконали архітектуру для 50+ проектів з каталогами до 300К товарів та навантаженням до 10К одночасно активних користувачів. Гарантуємо, що спроектована архітектура витримає пікові навантаження і не потребуватиме рефакторингу в найближчі 3 роки.

На виході: архітектурний документ (ADR, ER-діаграми, runbook), прототип критичних вузлів (опціонально), документація по API, рекомендації щодо кешування та масштабування.

Якщо ваша архітектура викликає сумніви або ви готуєтеся до зростання трафіку — зв'яжіться з нами для консультації. Ми проведемо аудит поточної структури і запропонуємо оптимальну стратегію. Замовте комерційну пропозицію — ми підготуємо її протягом 2 робочих днів. Щоб отримати персональну консультацію щодо вашого проекту, напишіть нам — розкажемо, які архітектурні рішення підійдуть саме вам.