◈Содержание
BUSSOL Калькуляторы · полное руководство по версии 1.3.0
◈О документе
Руководство описывает установку, конфигурирование, сопровождение и проверку BUSSOL Calculators версии 1.3.0. Технические сведения сверены с файлами указанной сборки; визуальная структура приведена к единому шаблону BUSSOL Mercury, а шапка оформлена в фирменных сиреневых тонах.
| Параметр | Значение |
|---|---|
| Продукт | BUSSOL: Калькуляторы стоимости и сроков разработки |
| Module ID | bussol.calculators |
| Версия | 1.3.0 |
| Дата версии | 10.11.2026 |
| Компонент | bussol:development.calculator |
| Правообладатель | BUSSOL · Alexander Afanasyev |
| Контакт | alafanasyev2015@gmail.com |
01Назначение и архитектура решения
BUSSOL: Калькуляторы стоимости и сроков разработки — модуль для «1С-Битрикс: Управление сайтом», предназначенный для интерактивной оценки проектов разработки. Посетитель выбирает услуги, видит итоговую стоимость и срок, печатает смету или отправляет её вместе с контактными данными.
Основные контуры
| Контур | Назначение |
|---|---|
| Публичный компонент | Отображение групп и опций, интерактивный пересчёт, печать и контактная форма. |
| Административная часть | Редактор профилей, цен, сроков, цветовых схем и получателей заявок. |
| Серверный расчёт и отправка | Проверка выбранных опций, повторный расчёт, проверка контактов и передача по включённым каналам. |
| Хранение и многосайтовость | Общие конфигурации «*» и отдельные настройки сайтов без изменения исходного кода. |
Стоимость и сроки при отправке рассчитываются повторно на сервере. Клиентские суммы не считаются доверенным источником данных.
Module ID: bussol.calculators. Публичный компонент: bussol:development.calculator. Версия, описанная в документе: 1.3.0 (10.11.2026).
02Возможности версии 1.3.0
- Пять готовых профилей: интернет-магазин, B2B-кабинет, корпоративный сайт, Landing Page и фирменный стиль.
- 214 исходных опций в 24 группах с ценами, сроками и отметками по умолчанию.
- Создание и редактирование калькуляторов, групп и опций, изменение активности, сортировки и режима выбора.
- Одиночный (single) и множественный (multi) режим выбора внутри группы.
- Сворачиваемые группы, динамическая смета, кнопки «Распечатать смету», «Проверить расчёт» и «Отправить расчёт».
- Индивидуальная основная цветовая тема каждого профиля с производными оттенками.
- Многосайтовость с наследованием конфигураций и получателей заявок.
- Email, Telegram, MAX и Битрикс24 в качестве независимых каналов доставки.
- Режим композитного сайта, серверный AJAX-контроллер и отдельный диалог подтверждения отправки.
- Полное удаление профиля с подтверждением и сохранением факта удаления при переустановке.
- Новое в 1.3.0: два режима отображения — INLINE на странице и POPUP в модальном окне; кнопка компонента или внешний CSS-селектор, отдельные настройки закрытия и адаптация для мобильных экранов.
Предустановленные наборы услуг ориентированы на разработку сайтов и фирменного стиля. Продукт не является визуальным конструктором произвольных математических формул.
03Системные требования и совместимость
| Компонент | Требование / особенность |
|---|---|
| 1С-Битрикс | «Управление сайтом», все редакции; главный модуль main версии 26.0.0 или выше. |
| PHP | 8.4 или выше. Установщик проверяет минимальную версию. |
| СУБД | MySQL 8.0 или выше. MariaDB не заявлена как поддерживаемая СУБД. |
| Дополнительные модули | Для базовой работы не требуются iblock, sale, catalog или form. |
| Исходящая почта | Рабочая почтовая конфигурация сервера/Битрикс для канала Email. |
| Внешние API | Исходящий HTTPS-доступ к Telegram, MAX и Битрикс24 для соответствующих каналов. |
| Права | Для административных настроек требуется учётная запись администратора сайта. |
Модуль рассчитан на MySQL 8+, PHP 8.4+ и main 26+. Перед установкой на промышленный сайт рекомендуется резервное копирование файлов и базы данных.
04Установка, обновление и удаление модуля
Чистая установка
- Распакуйте каталог bussol.calculators из архива в /local/modules/bussol.calculators/ (или используйте штатную установку решения).
- Установите модуль через административный раздел 1С-Битрикс.
- Убедитесь, что появилась страница «Bussol → Калькуляторы → Настройки калькуляторов».
- Выберите сайт, проверьте профили, укажите способы получения расчётов.
- Разместите компонент bussol:development.calculator на требуемых страницах.
Обновление с предыдущих версий
- Сделайте резервную копию БД, каталога модуля и публичного компонента.
- Замените файлы /bitrix/modules/bussol.calculators/ или /local/modules/bussol.calculators/ на актуальную версию.
- Один раз откройте /bitrix/admin/settings.php?mid=bussol.calculators от имени администратора для регистрации меню/миграции, если это требуется после обновления.
- Отдельно замените содержимое /local/components/bussol/development.calculator/ файлами из install/components/bussol/development.calculator/ внутри модуля.
- Убедитесь, что шаблон использует script.1.3.0.js. Старые файлы JS удаляйте только после проверки, что пользовательские шаблоны их не используют; очистите объединённый и композитный кеш.
- Очистите обычный, композитный и объединённый кеш JS/CSS, затем проверьте форму и отправку.
Простая замена файлов модуля не гарантирует обновления публичной копии компонента. Если не перенести новый шаблон, на сайте может остаться прежняя логика формы.
Удаление
Штатное удаление модуля отключает его, удаляет установленную копию публичного компонента, административные файлы и собственные иконки. По коду установщика таблицы данных намеренно сохраняются. Перед операцией проверьте, какие страницы сайта используют компонент.
05Быстрый запуск
| Шаг | Действие | Результат |
|---|---|---|
| 1 | Откройте «Bussol → Калькуляторы → Настройки калькуляторов». | Доступен редактор профилей. |
| 2 | В поле «Сайт» выберите «Все сайты» или конкретный сайт. | Определена область настроек. |
| 3 | Выберите профиль и проверьте название, группы, цены, сроки, активность. | Подготовлена смета. |
| 4 | Задайте основной цвет профиля и сохраните калькулятор. | Согласован внешний вид. |
| 5 | Включите Email и/или другие каналы, заполните реквизиты и сохраните их. | Заявки имеют получателя. |
| 6 | Разместите компонент на странице и выберите код PROFILE. | Калькулятор виден посетителям. |
| 7 | Проверьте расчёт, печать, отправку и подтверждение. | Рабочий сценарий протестирован. |
Для первой проверки удобно включить только Email, убедиться в доставке письма, а затем подключать MAX, Telegram и Битрикс24 по отдельности.
06Административный центр и доступ
Административные настройки расположены в левом меню: Bussol → Калькуляторы → Настройки калькуляторов. Адрес страницы: /bitrix/admin/bussol.calculators_calculators.php.
Что доступно администратору
- Выбор сайта и калькулятора, сохранение профилей.
- Создание нового профиля с собственным символьным кодом.
- Редактирование групп, опций, стоимости, срока, выбранных по умолчанию значений.
- Настройка основного цвета и параметров подписи стоимости/срока.
- Полное удаление профиля после ввода его кода и подтверждения.
- Настройка и включение каналов отправки для выбранного сайта.
В меню используется общий раздел Bussol, совместимый с пунктами модуля bussol.neuro2. Доступ к собственной странице настроек в текущем коде ограничен администраторами; отдельная матрица ролей не предусмотрена.
07Профили калькуляторов и начальные данные
Ниже приведены стартовые профили версии 1.3.0. Итоговые суммы — исходные значения при первоначально выбранных опциях; они не являются фиксированными ценами на услуги.
| Код PROFILE | Калькулятор | Групп | Опций | Стартовая цена | Стартовый срок |
|---|---|---|---|---|---|
| shop | Интернет-магазин | 6 | 78 | 491 800 ₽ | 68 дн. |
| b2b_cabinet | B2B-кабинет | 4 | 17 | 449 900 ₽ | 30 дн. |
| corporate | Корпоративный сайт | 6 | 41 | 201 600 ₽ | 32 дн. |
| landing | Landing Page | 6 | 43 | 137 950 ₽ | 23 дн. |
| firmstyle | Фирменный стиль | 2 | 35 | 91 080 ₽ | 44 дн. |
Основные поля профиля
| Параметр | Назначение |
|---|---|
| Код | Уникальный идентификатор для параметра PROFILE компонента. |
| Название и описание | Заголовок и вводный текст публичного калькулятора. |
| Активность | Определяет доступность профиля на выбранном сайте. |
| Сортировка | Положение в административных списках. |
| Валюта, подпись сроков | Обозначения рядом с суммой и количеством дней. |
| Основной цвет | HEX-цвет, по умолчанию #7358bd. |
| Группы и опции | Набор услуг, цен, дней и начальных отметок. |
Стартовые данные можно изменять. При сохранении настроек сайта создаётся локальная копия профиля, не влияющая на общую конфигурацию.
08Редактор групп, опций и режимов выбора
Группа услуг
Группа объединяет тематические опции и имеет название, технический ID и режим выбора.
| Режим | Как работает |
|---|---|
| multi | Посетитель может отметить несколько опций. Стоимости и сроки выбранных опций суммируются. |
| single | Допускается максимум одна выбранная опция. При новом выборе предыдущая отметка снимается. |
Поля опции
- Название, уникальный идентификатор.
- Стоимость и количество дней.
- Активность — отключённые позиции не отображаются посетителю.
- Выбрана по умолчанию — начальное состояние при открытии страницы.
В редакторе доступны добавление, изменение и удаление групп и опций. Перед удалением группы или опции проверьте последствия для итоговых смет: удаление меняет состав предложения.
В текущем валидаторе не более 60 групп; выбор посетителя ограничен 500 идентификаторами опций. Для режима single нельзя одновременно выбрать несколько опций одной группы.
09Правила расчёта стоимости и сроков
Алгоритм суммирует значения выбранных активных опций во всех группах. Деньги и дни суммируются отдельно; параллельное выполнение работ, коэффициенты сложности, скидки и произвольные формулы на этом этапе не учитываются.
Стоимость = Σ стоимость выбранных опций Срок = Σ дни выбранных опций
Пример
| Опция | Цена | Срок |
|---|---|---|
| Дизайн | 40 000 ₽ | 8 дн. |
| Форма заявки | 12 000 ₽ | 3 дн. |
| Интеграция | 18 000 ₽ | 4 дн. |
| Итого | 70 000 ₽ | 15 дн. |
Кнопка «Проверить расчёт» запрашивает актуальный результат у сервера. При отправке заявки сервер также пересчитывает смету на текущей конфигурации и отклоняет неизвестные или отключённые опции.
Срок рассчитывается суммой дней. Он не является календарным графиком и не учитывает выходные, праздники и параллельные этапы.
10Оформление и цветовые темы
Для каждого профиля можно указать основной цвет в формате #RRGGBB. Исходное значение — #7358bd, соответствующее сиреневой палитре BUSSOL.
- Публичный компонент получает основную палитру из настроек профиля.
- Светлые и тёмные оттенки и контрастный текст рассчитываются автоматически.
- Акцент используется в кнопках, элементах выбора, состоянии формы и подтверждении отправки.
- Группы услуг являются раскрывающимися блоками; при первоначальной загрузке они открыты.
При смене основного цвета не требуется переписывать CSS или редактировать шаблон компонента. Для немедленного отображения изменений на кешируемых страницах очистите кеш сайта.
11Многосайтовость и наследование настроек
Общая область «Все сайты» обозначается идентификатором *. Для каждого сайта можно создать собственные значения профилей и каналов уведомлений.
Наследование калькуляторов
- Пока профиль не был сохранён для конкретного сайта, используется общая конфигурация.
- Первое сохранение создаёт локальную копию профиля.
- После этого изменения локального профиля не изменяют общую конфигурацию.
Наследование каналов доставки в версии 1.3.0
| Ситуация | Какие настройки используются |
|---|---|
| Для сайта нет записи доставки | Общие настройки *. |
| Для сайта запись есть, но все каналы выключены | Общие настройки * вместе с получателями и токенами. |
| Для сайта включён хотя бы один канал | Полный локальный набор настроек этого сайта имеет приоритет. |
Если на сайте включён хотя бы один собственный канал, каналы из общих настроек к нему автоматически не добавляются. Локальная запись заменяет общую целиком.
12Размещение публичного компонента
Код компонента: bussol:development.calculator. После установки файлы компонента находятся в /local/components/bussol/development.calculator/.
<?php
$APPLICATION->IncludeComponent(
'bussol:development.calculator',
'.default',
[
'PROFILE' => 'shop',
'SHOW_PRINT' => 'Y',
'PRIVACY_URL' => '/privacy/',
'CACHE_TIME' => 0,
]
);
?>Параметры компонента
| Параметр | Описание / типичное значение |
|---|---|
| PROFILE | Код профиля: shop, b2b_cabinet, corporate, landing, firmstyle или код созданного профиля. |
| SHOW_PRINT | Y — показать кнопку «Распечатать смету»; N — скрыть. |
| PRIVACY_URL | URL политики обработки персональных данных; например /privacy/. |
| CACHE_TIME | В примере 0. При использовании кеширования учитывать обновление начальных цен и композит. |
| DISPLAY_MODE | INLINE (по умолчанию) — на странице; POPUP — в модальном окне. |
| BUTTON_TEXT | Текст встроенной кнопки открытия в режиме POPUP. По умолчанию «Рассчитать стоимость». |
| POPUP_WIDTH | Максимальная ширина Popup на компьютере: 480–1600 px, по умолчанию 1100. |
| POPUP_CLOSE_ESCAPE | Y/N — разрешать закрытие основного Popup клавишей Escape; по умолчанию Y. |
| POPUP_CLOSE_BACKDROP | Y/N — разрешать закрытие по нажатию на затемнённый фон; по умолчанию Y. |
| SHOW_BUTTON | Y/N — показывать кнопку компонента. Когда внешний селектор не задан, компонент сохраняет собственную кнопку. |
| EXTERNAL_TRIGGER_SELECTOR | Селектор элемента страницы, открывающего этот Popup, например #open-calc или .open-calc. |
На разных страницах можно подключать разные профили. Выбор профиля должен соответствовать тому сайту, на котором выполняется компонент.
Актуальный код — bussol:development.calculator. Историческое название bussol:calculator из промежуточной сборки 1.1.0 больше не используется.
Новый режим Popup в версии 1.3.0
Обычный режим INLINE остаётся режимом по умолчанию — обновление само по себе не превращает встроенные калькуляторы в модальные окна. В режиме POPUP посетитель сначала видит кнопку. По нажатию открывается полноценный калькулятор с теми же опциями, суммами, сроками, печатью и отправкой.
<?php
$APPLICATION->IncludeComponent(
'bussol:development.calculator',
'.default',
[
'PROFILE' => 'shop',
'DISPLAY_MODE' => 'POPUP',
'BUTTON_TEXT' => 'Рассчитать стоимость',
'POPUP_WIDTH' => '1100',
'POPUP_CLOSE_ESCAPE' => 'Y',
'POPUP_CLOSE_BACKDROP' => 'Y',
'SHOW_BUTTON' => 'Y',
'SHOW_PRINT' => 'Y',
'PRIVACY_URL' => '/privacy/',
'CACHE_TIME' => 0,
]
);
?>Открытие существующей кнопкой сайта
Можно использовать собственную кнопку (или ссылку) и скрыть стандартную кнопку компонента. Задайте каждому Popup отдельный селектор, особенно если на странице несколько калькуляторов.
<button type="button" class="open-calc-shop">Рассчитать проект</button>
<?php
$APPLICATION->IncludeComponent(
'bussol:development.calculator',
'.default',
[
'PROFILE' => 'shop',
'DISPLAY_MODE' => 'POPUP',
'SHOW_BUTTON' => 'N',
'EXTERNAL_TRIGGER_SELECTOR' => '.open-calc-shop',
'CACHE_TIME' => 0,
]
);
?>На узких экранах Popup раскрывается на весь экран. Контактная форма и подтверждение отправки располагаются поверх калькулятора. Закрытие, Escape и возврат фокуса обрабатываются в клиентском скрипте.
Скопируйте весь новый публичный компонент из install/components/bussol/development.calculator/ в рабочий каталог /local/components/bussol/development.calculator/. Убедитесь, что подключается script.1.3.0.js, проверьте отсутствие загрузки устаревших JS-обработчиков и очистите стандартный, композитный и объединённый кеш JS/CSS.
13Публичный интерфейс, смета и печать
Посетитель выбирает опции и видит разбивку по группам, итоговую цену и срок. Результат обновляется непосредственно в интерфейсе без перезагрузки страницы.
- Раскрытие/сворачивание групп нажатием на заголовок.
- Отображение цены и добавляемого срока у отдельной опции.
- Пересчёт итогов и промежуточных сумм групп.
- Проверка актуальной сметы сервером по кнопке «Проверить расчёт».
- Печать сметы через стандартную функцию печати браузера, если SHOW_PRINT = Y.
- Кнопка «Отправить расчёт» с отдельным диалогом контактной формы.
Публичные суммы — оценочные значения, определяемые конфигурацией владельца сайта; при изменении тарифов рекомендуется синхронно обновлять кеш и проверять расчёт.
14Контактная форма и успешная отправка
Поля формы
| Поле | Обязательность |
|---|---|
| Ваше имя * | Да |
| Телефон * | Да |
| Email * | Да |
| Комментарий | Нет |
| Согласие на обработку персональных данных * | Да |
Обязательные поля отмечены звёздочкой. Проверка выполняется как в браузере, так и в серверном AJAX-контроллере. Ссылка на политику определяется параметром PRIVACY_URL.
Что видит посетитель
- Нажимает «Отправить расчёт» и заполняет контактную форму.
- Модуль проверяет согласие, контакты, выбранные опции и доставку по настроенным каналам.
- После успешного ответа сервера показывает отдельный экран «Расчёт отправлен! В ближайшее время мы вам перезвоним».
- Окно можно закрыть кнопкой «Хорошо». Если сервер вернул ошибку, форма остаётся открытой с текстом причины.
Встроенная защита запрещает повторную отправку примерно в пределах двухминутного окна с того же IP для того же сайта. При проверках учитывайте этот лимит; блокировка не означает неисправность канала доставки.
15Каналы доставки: Email, Telegram, MAX, Битрикс24
Каналы включаются отдельно на странице настроек выбранного сайта. Указание адреса или токена без установки флажка активности не включает канал.
| Канал | Обязательные реквизиты | Результат |
|---|---|---|
| Email получателя | Письмо с полным текстом сметы через Bitrix\Main\Mail\Mail::send. | |
| Telegram | Bot Token и Chat ID | Сообщение бота через Telegram Bot API. |
| MAX | Токен бота и числовой Chat ID | Сообщение через MAX Bot API. |
| Битрикс24 | HTTPS-вебхук с правом crm | Создание лида методом crm.item.add с контактами и сметой. |
Особенности сохранения
- Если секретное поле оставить пустым при повторном сохранении, старое значение сохраняется.
- Для удаления сохранённого токена или вебхука используется отдельный флажок очистки.
- Для Telegram и MAX текст ограничен первыми 3900 символами; Email и Битрикс24 получают полную смету.
- Если часть каналов недоступна, ответ может содержать предупреждение о частичной доставке.
- Для Битрикс24 могут потребоваться дополнительные обязательные поля, настроенные в конкретной CRM.
Работа Telegram, MAX и Битрикс24 зависит от доступа сервера к внешним API и актуальности реквизитов. Эти сервисы не входят в состав модуля.
16Композитный режим, кеш и AJAX
Шаблон компонента использует setFrameMode(true). Проверка расчёта и отправка выполняются через BX.ajax.runAction с серверной обработкой, поэтому персональные данные и секретные ключи не должны присутствовать в кешируемой HTML-разметке.
Что учитывать после изменения конфигурации
- При обновлении тарифа серверный расчёт использует актуальную конфигурацию.
- Статическая HTML-часть может некоторое время отображать старые начальные значения при активном композите.
- После обновления шаблона необходимо очистить композитный кеш и кеш объединённых JS/CSS.
- В 1.3.0 клиентский обработчик находится в script.1.3.0.js — наличие старого script.js может приводить к двойной инициализации.
При обновлении проверьте в инструментах разработчика браузера, что загрузился именно script.1.3.0.js и AJAX-запрос возвращает ожидаемые данные.
В режиме POPUP разметка калькулятора подготавливается вместе со страницей, а модальное окно открывается на стороне браузера. Расчёты и отправка используют те же серверные AJAX-действия, что и в INLINE. Обновление клиентского JS до script.1.3.0.js требует очистки кеша.
17Хранилище, доступ и безопасность
Основные таблицы
| Таблица | Назначение |
|---|---|
| b_bussol_calc_profile | Профили и конфигурации калькуляторов в разрезе SITE_ID. |
| b_bussol_calc_delivery | Настройки каналов и реквизиты доставки в разрезе SITE_ID. |
| b_bussol_calc_throttle | Временные хэши для ограничения повторной отправки. |
Меры защиты
- Серверный повторный расчёт и валидация идентификаторов опций.
- Подписанный контекст калькулятора и сайта.
- POST/AJAX-действия с CSRF-защитой Битрикс.
- Проверка обязательных контактов, согласия и honeypot-поля.
- Ограничение частоты заявок по IP/сайту.
Токены и вебхуки хранятся в таблице настроек доставки; шифрование секретов на уровне приложения в этой версии не реализовано. Обеспечьте права доступа к базе, резервным копиям и административной панели.
Встроенная таблица заявок с контактами посетителей не создаётся. Основная заявка уходит во включённые каналы; в базе остаётся временный технический хэш ограничения частоты.
18Структура файлов и техническая диагностика
bussol.calculators/
include.php, .settings.php
options.php, admin/calculators.php
lib/calculator.php, lib/config.php, lib/colortheme.php
lib/profilerepository.php, lib/deliverysettings.php
lib/submissionservice.php, lib/controller/submission.php
lib/adminmenu.php, lib/migration.php
install/index.php, install/version.php
install/data/profiles.json
install/themes/.default/
install/components/bussol/development.calculator/
component.php, .parameters.php
templates/.default/template.php
templates/.default/style.css
templates/.default/script.1.3.0.jsГде искать проблемы
| Симптом | Что проверить |
|---|---|
| Не видно пункта меню Bussol | Установлен ли модуль; запускалась ли страница settings.php?mid=bussol.calculators после обновления; есть ли права администратора. |
| Калькулятор не найден или отключён | Код PROFILE, активность для SITE_ID, сохранена ли локальная копия конфигурации. |
| Расчёт не меняется | Работает ли JS текущей версии, нет ли конфликтов старого script.js, не блокируется ли AJAX. |
| «Отправка пока не настроена» | Флажки активности каналов, настройки * и конкретного SITE_ID, наличие корректных реквизитов. |
| «Повторная отправка возможна через две минуты» | Дождитесь окончания лимита для того же IP/сайта; это штатный антиспам. |
| Письмо/сообщение не пришло | Почта Битрикс, доступ к API, действительность токенов, логи сервера. |
| Не появляется окно успеха | Проверьте ответ AJAX, версию script.1.3.0.js, обновление публичного компонента и кеш. |
19Чек-лист приёмки, ограничения и поддержка
Чек-лист приёмки
- Установка завершилась без ошибок и версия главного модуля соответствует требованиям.
- Пункт Bussol → Калькуляторы доступен администратору.
- Все пять исходных калькуляторов открываются на соответствующих страницах.
- Группы раскрываются, одиночный и множественный выбор работают.
- Цена и срок пересчитываются; «Проверить расчёт» возвращает актуальный результат.
- Цветовая тема задана и правильно отображается.
- Настройки * и отдельного сайта наследуются ожидаемым способом.
- Обязательные поля формы и согласие проверяются.
- При успешной доставке открывается окно подтверждения; при ошибке — текст ошибки.
- Проверена доставка по каждому реально используемому каналу.
- Печать сметы и работа с композитным кешем проверены.
- Проверены оба режима INLINE и POPUP, открытие внешней кнопкой, закрытие и несколько экземпляров на одной странице.
Известные ограничения
- Сроки суммируются и не являются календарным планом.
- Нет произвольного визуального редактора формул и условных сценариев.
- Не предусмотрен журнал пользовательских заявок внутри административной части.
- Требуются действующие внешние токены/вебхуки и исходящая связь с сервисами.
- Ограничение частоты отправки действует на IP/сайт в двухминутных временных интервалах.
Copyright by BUSSOL 2026, Alexander Afanasyev, alafanasyev2015@gmail.com. Сайт: https://bussolweb.ru
Документация составлена по фактической сборке bussol.calculators 1.3.0 и оформлению пользовательского HTML-руководства BUSSOL Neuro 2.