Разработка 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С-Битрикс — фундамент, который определяет производительность и стоимость поддержки. Архитектурные ошибки накапливаются и через год превращаются в капитальный рефакторинг, стоимость которого в разы выше изначального проектирования. По оценкам нашей практики, такой рефакторинг может стоить от 300 000 до 1 000 000 руб., не считая потери выручки во время простоя. Согласно документации, фундаментальные решения по хранению данных и кэшированию закладываются на старте и потом меняются с огромными затратами.

Наш опыт показывает: правильное проектирование на старте экономит до 40% бюджета на разработку. Мы проектируем структуру данных, кэширование, масштабирование и интеграции — с учётом роста нагрузки до 500К товаров и пикового трафика в Черную пятницу. Каждый проект проходит этап нагрузочного тестирования, чтобы избежать сюрпризов в продакшене. Оптимальная архитектура снижает требования к хостингу, экономя от 30 000 до 150 000 руб. в месяц.

Выбор типа хранения: инфоблоки или 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-блоки обязательны для:

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

D7 ORM и свои таблицы — для бизнес-логики, которая не лезет в модель инфоблоков. Связи many-to-many, вычисляемые поля, кастомные агрегации. Bitrix\Main\ORM\Data\DataManager даёт типобезопасность, валидацию и систему событий. Но придётся писать админку с нуля. Подробнее — в документации Bitrix ORM.

Как масштабировать 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 рабочих дней.