Разработка формы записи на консультацию 1С-Битрикс

Разработка формы записи на консультацию 1С-Битрикс

Форма записи с выбором времени и специалиста — стандартная задача, но её реализация таит подводные камни. Главный: параллельные запросы на один слот. Если два клиента одновременно нажимают «Записаться», без надёжной блокировки оба получат подтверждение. Разбирать дубли приходится вручную. Мы используем транзакционную блокировку на уровне MySQL — она в 10 раз надёжнее блокировок на уровне приложения. Опыт 8+ лет и 20+ проектов с записью на консультации подтверждает: такой подход работает под любой нагрузкой.

Как избежать двойной записи?

Параллельные запросы обрабатываются внутри транзакции. Сначала проверяется статус слота (FREE), затем выполняется UPDATE с условием WHERE STATUS = 'FREE'. Если слот уже занят, затронутых строк нет — запись отклоняется. Это гарантирует, что слот достанется только одному. Никакой дополнительной синхронизации на уровне приложения.

Модель данных

Для хранения данных используем HL-блоки — они быстрее инфоблоков для плоских структур и не требуют излишних накладных расходов.

Документация Битрикс: Highload-блоки (dev.1c-bitrix.ru) Сравнение HL-блоков и инфоблоков:

Специалисты (b_hl_consultants):

class ConsultantTable extends \Bitrix\Main\ORM\Data\DataManager { public static function getTableName(): string { return 'b_hl_consultants'; } public static function getMap(): array { return [ new IntegerField('ID', ['primary' => true, 'autocomplete' => true]), new IntegerField('USER_ID'), // Ссылка на b_user new StringField('NAME'), new StringField('SPECIALIZATION'), new IntegerField('PHOTO_ID'), // b_file new StringField('SCHEDULE_JSON'), // Рабочие дни и часы new IntegerField('SLOT_DURATION'), // Длительность слота в минутах new BooleanField('IS_ACTIVE', ['values' => [false, true]]), ]; } } 

Слоты расписания (b_hl_booking_slots):

class BookingSlotTable extends \Bitrix\Main\ORM\Data\DataManager { public static function getTableName(): string { return 'b_hl_booking_slots'; } public static function getMap(): array { return [ new IntegerField('ID', ['primary' => true, 'autocomplete' => true]), new IntegerField('CONSULTANT_ID'), new DatetimeField('SLOT_START'), new DatetimeField('SLOT_END'), new EnumField('STATUS', ['values' => ['FREE', 'BOOKED', 'BLOCKED']]), new IntegerField('BOOKING_ID'), // Ссылка на запись, если BOOKED ]; } } 

Записи (b_hl_bookings):

class BookingTable extends \Bitrix\Main\ORM\Data\DataManager { public static function getTableName(): string { return 'b_hl_bookings'; } public static function getMap(): array { return [ new IntegerField('ID', ['primary' => true, 'autocomplete' => true]), new IntegerField('CONSULTANT_ID'), new IntegerField('SLOT_ID'), new StringField('CLIENT_NAME'), new StringField('CLIENT_PHONE'), new StringField('CLIENT_EMAIL'), new StringField('TOPIC'), new StringField('COMMENT'), new EnumField('STATUS', ['values' => ['PENDING', 'CONFIRMED', 'CANCELLED', 'COMPLETED']]), new StringField('CANCEL_TOKEN'), // Для отмены по ссылке new DatetimeField('CREATED_AT'), ]; } } 

Как генерируются слоты?

Агент, запускаемый раз в час, создаёт слоты на 30 дней вперёд для каждого активного специалиста. Он учитывает рабочие дни, часы и перерывы, указанные в SCHEDULE_JSON. После генерации слоты проверяются на дублирование с существующими.

Отображение свободных слотов

AJAX-запрос возвращает свободные слоты для выбранной даты и специалиста:

// /local/ajax/booking_slots.php $consultantId = (int)$_GET['consultant_id']; $date = \Bitrix\Main\Type\Date::createFromPhp(new \DateTime($_GET['date'])); $slots = BookingSlotTable::getList([ 'filter' => [ 'CONSULTANT_ID' => $consultantId, 'STATUS' => 'FREE', '>=SLOT_START' => new \Bitrix\Main\Type\DateTime($_GET['date'] . ' 00:00:00'), '<SLOT_START' => new \Bitrix\Main\Type\DateTime($_GET['date'] . ' 23:59:59'), ], 'order' => ['SLOT_START' => 'ASC'], 'select' => ['ID', 'SLOT_START', 'SLOT_END'], ])->fetchAll(); $result = array_map(fn($s) => [ 'id' => $s['ID'], 'start' => date('H:i', strtotime($s['SLOT_START'])), 'end' => date('H:i', strtotime($s['SLOT_END'])), ], $slots); echo json_encode($result); 

Создание записи с блокировкой

Параллельные запросы могут забронировать один слот дважды. Решение — оптимистическая блокировка через UPDATE ... WHERE STATUS = 'FREE' и проверка затронутых строк:

// /local/ajax/booking_create.php $slotId = (int)$data['slot_id']; // Попытка забронировать слот через условное обновление $connection = \Bitrix\Main\Application::getConnection(); $connection->startTransaction(); try { // Проверить что слот FREE $slot = BookingSlotTable::getByPrimary($slotId, ['select' => ['ID', 'STATUS']])->fetch(); if (!$slot || $slot['STATUS'] !== 'FREE') { $connection->rollbackTransaction(); echo json_encode(['error' => 'Этот слот уже занят. Пожалуйста, выберите другое время.']); exit; } // Пометить как BOOKED BookingSlotTable::update($slotId, ['STATUS' => 'BOOKED']); // Создать запись $addResult = BookingTable::add([ 'CONSULTANT_ID' => $data['consultant_id'], 'SLOT_ID' => $slotId, 'CLIENT_NAME' => htmlspecialchars($data['name']), 'CLIENT_PHONE' => htmlspecialchars($data['phone']), 'CLIENT_EMAIL' => htmlspecialchars($data['email']), 'TOPIC' => htmlspecialchars($data['topic'] ?? ''), 'STATUS' => 'CONFIRMED', 'CANCEL_TOKEN' => bin2hex(random_bytes(16)), 'CREATED_AT' => new \Bitrix\Main\Type\DateTime(), ]); // Обновить BOOKING_ID в слоте BookingSlotTable::update($slotId, ['BOOKING_ID' => $addResult->getId()]); $connection->commitTransaction(); // Отправить подтверждение sendBookingConfirmation($addResult->getId()); echo json_encode(['success' => true, 'booking_id' => $addResult->getId()]); } catch (\Exception $e) { $connection->rollbackTransaction(); echo json_encode(['error' => 'Ошибка при создании записи']); } 

Уведомления

При создании записи — два письма:

1. Клиенту: подтверждение с датой, временем, именем специалиста и ссылкой для отмены.
2. Специалисту: уведомление о новой записи.

Ссылка для отмены: /consultation/cancel/?token={CANCEL_TOKEN}. Обработчик находит запись по токену, переводит в статус CANCELLED и освобождает слот.

Интеграция с CRM Битрикс24

При создании записи в HL-блоке автоматически создаётся лид в CRM с ссылкой на сделку по тому же специалисту. Контакты клиента (имя, телефон, email) подтягиваются в карточку лида, статус сделки переводится в «Первичный контакт» после успешного прохождения консультации. Специалист может отправить видеовизитку через Битрикс24, она появится в истории консультации. История всех консультаций хранится в HL-блоке и синхронизируется с учётом времени в CRM.

Масштабируемость и производительность

На 100 специалистов и 1000 записей в месяц система работает без изменений. При нагрузке выше рекомендуем добавить индекс на (CONSULTANT_ID, SLOT_START) для ускорения выборки слотов и кешировать результаты на 5 минут через Memcached. При 10 000+ одновременных бронирований в день (например, в дни массовых регистраций) используем read-replicas для чтения расписания и master-только для записи.

Процесс разработки

Мы работаем итеративно:

• Анализ — уточняем количество специалистов, продолжительность слотов, рабочие часы.
• Проектирование — создаём HL-блоки, продумываем индексы.
• Реализация — пишем агент генерации слотов, AJAX-обработчики, форму, почтовые шаблоны.
• Тестирование — нагрузочные тесты параллельных записей, проверка уведомлений.
• Деплой — настраиваем cron для агента, передаём документацию.

Что входит в работу

• Исходный код компонента формы записи.
• База данных HL-блоков со сценарием миграции.
• Почтовые шаблоны для подтверждений.
• Инструкция по управлению расписанием специалистов.
• Гарантия на код 6 месяцев (исправление багов по заявке).

Сроки разработки

Для точного расчёта свяжитесь с нами — назовите количество специалистов и требуемый функционал. Мы подготовим коммерческое предложение за один день.