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

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

Форма записи на консультацию — не просто форма обратной связи. Пользователь должен выбрать удобное время, специалиста, тему — и сразу получить подтверждение. Основная техническая сложность: отображение реального расписания (не записанных слотов) и блокировка выбранного времени от параллельных записей. На 1С-Битрикс это решается через 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'),
        ];
    }
}

Генерация слотов

Слоты генерируются агентом или при первом запросе. Расписание специалиста — JSON с рабочими часами:

{
  "1": {"start": "09:00", "end": "18:00"},
  "2": {"start": "09:00", "end": "18:00"},
  "3": {"start": "10:00", "end": "16:00"},
  "4": {"start": "09:00", "end": "18:00"},
  "5": {"start": "09:00", "end": "17:00"}
}

Генерация слотов на 30 дней вперёд:

class SlotGenerator
{
    public function generateForConsultant(int $consultantId, int $daysAhead = 30): void
    {
        $consultant = ConsultantTable::getByPrimary($consultantId)->fetch();
        $schedule   = json_decode($consultant['SCHEDULE_JSON'], true);
        $duration   = (int)$consultant['SLOT_DURATION']; // например, 60 минут

        for ($day = 0; $day <= $daysAhead; $day++) {
            $date    = new \DateTime("+{$day} days");
            $weekDay = $date->format('N'); // 1=Пн, 7=Вс

            if (!isset($schedule[$weekDay])) {
                continue; // Выходной
            }

            $daySchedule = $schedule[$weekDay];
            $slotStart   = new \DateTime($date->format('Y-m-d') . ' ' . $daySchedule['start']);
            $slotEnd     = new \DateTime($date->format('Y-m-d') . ' ' . $daySchedule['end']);

            // Проверить, что слот уже не создан
            $existingCount = BookingSlotTable::getCount([
                '>=SLOT_START' => $slotStart,
                '<SLOT_START'  => $slotEnd,
                'CONSULTANT_ID' => $consultantId,
            ]);

            if ($existingCount > 0) {
                continue;
            }

            $current = clone $slotStart;
            while ($current < $slotEnd) {
                $next = clone $current;
                $next->modify("+{$duration} minutes");

                if ($next > $slotEnd) break;

                BookingSlotTable::add([
                    'CONSULTANT_ID' => $consultantId,
                    'SLOT_START'    => \Bitrix\Main\Type\DateTime::createFromPhp($current),
                    'SLOT_END'      => \Bitrix\Main\Type\DateTime::createFromPhp($next),
                    'STATUS'        => 'FREE',
                ]);

                $current = $next;
            }
        }
    }
}

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

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 и освобождает слот.

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