Headless Битрикс + Next.js
Headless 1С-Битрикс: витрина на Next.js поверх работающего backend
Битрикс хорошо считает деньги: заказы, цены, остатки, обмен с 1С. Показывает он их хуже. Я разделяю эти роли. Backend остаётся в Битриксе, витрина переезжает на Next.js и получает свою скорость и свои релизы.
Что остаётся в Битриксе
- Каталог и инфоблоки как источник данных.
- Заказы, корзина и оплата (через API).
- Цены, скидки и правила.
- Обмен с 1С и складом.
- Админка, к которой привыкли контент-менеджеры.
Когда headless вам не нужен
Если каталог небольшой, скорость устраивает, а команды на поддержку двух стеков нет, headless добавит расходов и не даст выигрыша. Часто хватает настройки кэша и производительности текущего Битрикса. Я скажу это на первом разговоре.
Когда headless плохая идеяЧто переезжает на Next.js
- Каталог, карточки товаров, поиск и фильтры (вместе с Elasticsearch).
- Промо и контентные страницы.
- Вёрстка, которую можно менять без страха задеть заказы.
- Релизы фронта за минуты, независимо от backend.
Что вы получаете
API-слой между Битриксом и витриной
Типизированный контракт: витрина не зависит от внутренностей Битрикса, а изменения в API видны до релиза.
Витрину на Next.js
Каталог, карточки, поиск и фильтры. Кэш с инвалидацией по событиям Битрикса, чтобы цены и остатки не устаревали.
SEO-переезд без потерь
Карта старых URL и 301-редиректов, перенос мета-тегов и разметки, переключение по разделам.
МодернизацияПоиск на Elasticsearch, если он нужен
Морфология, опечатки и быстрые фасеты вместо стандартного поиска Битрикса.
Поиск и каталогРаздельные релизы
CI/CD для витрины: фронт выкатывается за минуты и не трогает заказы.
Документацию и передачу
Ваша команда сможет поддерживать витрину сама или с моим помесячным сопровождением.
Что обычно ломается и как я это закрываю
| Где ломается | Что делаю | Подробно |
|---|---|---|
| Корзина и checkout | Оставляю логику в Битриксе, витрина работает через API, сессии и скидки проверяю отдельно | Корзина в headless Bitrix: пять проблем, которые нас удивили |
| Авторизация | Общая сессия или токены, проверка на всех доменах | Авторизованный пользователь видит форму входа. Bitrix жив. Next.js жив. Они просто не договорились. |
| Кэш | ISR и инвалидация по событиям Битрикса, без устаревших цен | Кэш-инвалидация в headless: как Next.js узнаёт, что Bitrix обновил товар |
| Редиректы и 404 | Полная карта старых URL до релиза | Redirects умерли в день деплоя. Bitrix об этом не предупреждает. |
| Изображения | Отдельный pipeline, ресайз и CDN | Изображения в headless Bitrix: что сломается первым |
| Остатки | Синхронизация, которая не врёт покупателю | Синхронизация остатков в headless Bitrix: почему polling победил webhooks |
| API Битрикса | Свой API-слой с типизированным контрактом | Bitrix REST API и TypeScript: контракт, который мы сгенерировали сами |
Корзина и checkout
- Что делаю
- Оставляю логику в Битриксе, витрина работает через API, сессии и скидки проверяю отдельно
- Подробно
- Корзина в headless Bitrix: пять проблем, которые нас удивили
Авторизация
- Что делаю
- Общая сессия или токены, проверка на всех доменах
- Подробно
- Авторизованный пользователь видит форму входа. Bitrix жив. Next.js жив. Они просто не договорились.
Кэш
- Что делаю
- ISR и инвалидация по событиям Битрикса, без устаревших цен
- Подробно
- Кэш-инвалидация в headless: как Next.js узнаёт, что Bitrix обновил товар
Редиректы и 404
- Что делаю
- Полная карта старых URL до релиза
- Подробно
- Redirects умерли в день деплоя. Bitrix об этом не предупреждает.
Изображения
- Что делаю
- Отдельный pipeline, ресайз и CDN
- Подробно
- Изображения в headless Bitrix: что сломается первым
Остатки
- Что делаю
- Синхронизация, которая не врёт покупателю
- Подробно
- Синхронизация остатков в headless Bitrix: почему polling победил webhooks
API Битрикса
- Что делаю
- Свой API-слой с типизированным контрактом
- Подробно
- Bitrix REST API и TypeScript: контракт, который мы сгенерировали сами
Как проходит работа
- 1
Аудит
Смотрю каталог, интеграции и модули Битрикса. Решаем, что выносить первым.
- 2
API-слой
Типизированный контракт между Битриксом и витриной.
- 3
Каталог и карточка
Обычно выходят первым релизом, с картой редиректов и проверкой SEO.
- 4
Корзина и кабинет
Следующими этапами, когда первая часть стабильна.
Сроки и стоимость
- Сроки
- Зависят от размера каталога и числа интеграций, оцениваю после аудита
- Стоимость
- Цена фиксируется на каждый этап после аудита.
Пример работы
Пример работы
Каталог на 28 000 товаров: Next.js поверх 1С-Битрикс
Рабочий PHP-backend остался на месте: заказы, ценообразование, интеграции. Интерфейс и поиск переехали на Next.js и Elasticsearch, SEO-структура сохранена.
Читать кейсВопросы
- Нужно ли покупать другую редакцию Битрикса?
- Обычно нет. Решаем по факту, какие модули используются, это входит в аудит.
- Контент-менеджеры заметят переезд?
- В админке почти ничего не меняется. Меняется только то, как быстро их правки появляются на сайте.
- Что с SEO?
- URL, мета и разметка переносятся один в один, переключение идёт по разделам. Подробно на странице модернизации.
Работу делаю я
Иван Понамарев, senior full-stack инженер, 10+ лет в production. Вы говорите с тем, кто принимает технические решения и пишет критичный код.
Связанные форматы
Покажите каталог, прикину архитектуру
Пары предложений о каталоге и интеграциях достаточно для первого разговора.