Проєктування користувацьких властивостей інфоблоків 1С-Бітрікс

Через 2 роки після запуску типового інтернет-магазину на Бітрікс інфоблок каталогу виглядає так: 60 властивостей, з яких 20 не заповнено в жодного товару, 15 — строкові з повторюваними значеннями, 8 — з назвами на кшталт PROP_123 або MY_FIELD. Це результат органічного зростання без проєктування. Ми спеціалізуємося на проєктуванні властивостей інфоблоків, налаштуванні користувацьких властивостей Бітрікс, аудиті властивостей інфоблоків, нормалізації властивостей Бітрікс, фасетному індексі 1С-Бітрікс, обміні з 1С CommerceML, HL-блоках довідниках, реструктуризації інфоблоку, міграції властивостей Бітрікс і різних типах властивостей інфоблоків. Ми знаємо, як запобігти хаосу. Якщо вам потрібен порядок у властивостях — спроєктуємо схему під ключ за 5–7 днів. Додати властивість у Бітрікс легко — у три кліки. Видалити або перейменувати без втрати даних і поломки імпорту з 1С — значно складніше.

Як уникнути хаосу у властивостях інфоблоку?

Непродумана схема властивостей призводить до проблем: фасетний індекс не будується, обмін з 1С валиться, а розробники витрачають години на дешифрування PROP_47. Досвід показує: економія часу на старті обертається тижнями рефакторингу. Наша команда має 7+ років досвіду з Бітрікс і виконала понад 50 проєктів з проєктування властивостей. Гарантуємо, що спроєктована нами схема служить роками без переробок — у 4 рази довше, ніж хаотична. Крім того, оптимізований фасетний індекс працює у 3 рази швидше, а грамотно спроєктована система властивостей економить у 5 разів більше часу на супроводі.

Як правильно вибрати символьний код властивості?

Символьний код (CODE) має бути латиницею, унікальним у межах інфоблоку і збігатися з полем в 1С (якщо є обмін). Практичні правила:

• Тільки латиниця, цифри, підкреслення
• Верхній регістр: BRAND, COLOR, WEIGHT_KG
• Складові назви через підкреслення: TECH_PROCESSOR, TECH_RAM_GB
• Групування за префіксом: SEO_H1, BADGE_NEW

Символьний код після створення змінити не можна без прямого звернення до b_iblock_property. Тому правильне іменування на старті критичне.

Фасетні властивості та їх налаштування

Обов'язковість (IS_REQUIRED) потрібно проставляти усвідомлено. Якщо властивість обов'язкова, а імпорт з 1С її не передає — елемент не збережеться, обмін впаде. Правило: обов'язковість краще контролювати на формі вводу або в бізнес-процесі, а не на рівні інфоблоку, якщо дані надходять ззовні. Втрати від помилок імпорту — до 100 000 рублів за кожен інцидент.

Не всі властивості повинні брати участь у фасетному індексі. Стратегія поділу на категорії:

Розглянемо основні типи властивостей інфоблоків: рядок, список, число, прив'язка до HL-блоку.

Коли використовувати множинні та обчислювані властивості?

Множинна властивість створює по рядку в b_iblock_element_property на кожне значення. Виправдано для кольорів, тегів, сумісності. Не виправдано «про всяк випадок» — збільшує обсяг таблиці без користі. Оптимізований фасетний індекс працює в 3 рази швидше порівняно з неоптимізованим.

Іноді у властивість пишуть рейтинг або мінімальну ціну. Якщо дані читаються часто, а оновлюються рідко — зберігання у властивості з кешем виправдано. В інших випадках — обчислювати в arResult.

Кейс з нашої практики: аудит і реструктуризація 78 властивостей інфоблоку

Наш клієнт — магазин автозапчастин. Інфоблок «Каталог» з 78 властивостями. Завдання — підготувати до обміну з новою конфігурацією 1С і увімкнути фасетний індекс.

Аудит показав:

• 18 порожніх властивостей (жодного заповненого значення)
• 12 рядкових довідників (марка, модель) — кандидати на HL-блоки
• 5 властивостей з нечитабельними кодами (PROP_47, FIELD_2019)
• 3 дублюючі властивості

Ми виконали реструктуризацію:

• 18 порожніх властивостей видалено (перевірка на використання в коді)
• 12 властивостей переведено на 4 HL-блоки з міграцією даних
• Символьні коди перейменовано через b_iblock_property
• Підсумковий інфоблок: 45 властивостей, 14 у фасетному індексі

З практики: типовий аудит властивостей займає один робочий день, а реструктуризація — до 7 днів залежно від обсягу.

Етапи проєктування властивостей

1. Аудит поточної схеми (якщо є) — виявлення порожніх, дублюючих і нечитабельних властивостей.
2. Проєктування нової схеми — визначення типів, кодів, обов'язковості, групування.
3. Розподіл за категоріями (фасетні, інформаційні, системні).
4. Планування HL-блоків для довідників.
5. Документування маппінгу з полями 1С.
6. Написання скриптів міграції та відкату.
7. Тестування обміну та фільтрації.

// Псевдокод: створення HL-блоку, перенесення даних, видалення старої властивості
$hlBlockId = createHlBlock(['NAME' => 'Brands']);
foreach ($oldValues as $value) {
  addElementToHl($hlBlockId, ['UF_NAME' => $value]);
}
updatePropertyType($propertyId, 'HL', $hlBlockId);

Що входить у проєктування властивостей

• Документація: схема властивостей з кодами, типами, обов'язковістю, маппінг з 1С.
• Міграційні скрипти: для рефакторингу існуючих даних.
• Доступи: до інфоблоків та HL-блоків для подальшої підтримки.
• Інструкція: щодо додавання нових властивостей у майбутньому (шаблони кодів).
• Підтримка: 1 місяць консультацій після здачі.

Строки проєктування

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

Типові помилки при проектуванні архітектури проектів на 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 робочих днів. Щоб отримати персональну консультацію щодо вашого проекту, напишіть нам — розкажемо, які архітектурні рішення підійдуть саме вам.