Реализация системы бронирования и записи на сайте
Система бронирования — это управление временными слотами, которые нельзя продать дважды. Клиника, парикмахерская, коворкинг, прокат оборудования, ресторан — везде одна логика: ресурс (специалист, стол, переговорная, автомобиль) доступен в конкретное время, и этот слот должен быть занят ровно одним бронированием. Технически задача близка к учёту складских остатков, но с временным измерением вместо количественного.
Концептуальная модель
Четыре сущности:
Resource — то, что бронируется (мастер, кабинет, инвентарная единица) Schedule — рабочее расписание ресурса (часы работы, выходные, исключения) Slot — временной отрезок доступности (может генерироваться из расписания или задаваться явно) Booking — бронирование слота под конкретного клиента
Схема данных
CREATE TABLE bookable_resources (
id BIGSERIAL PRIMARY KEY,
name VARCHAR(255) NOT NULL,
type VARCHAR(50) NOT NULL, -- staff | room | equipment | table
capacity INTEGER NOT NULL DEFAULT 1, -- для групповых записей
is_active BOOLEAN NOT NULL DEFAULT true,
meta JSONB NOT NULL DEFAULT '{}'
);
CREATE TABLE resource_schedules (
id BIGSERIAL PRIMARY KEY,
resource_id BIGINT NOT NULL REFERENCES bookable_resources(id),
day_of_week SMALLINT, -- 0=вс, 1=пн ... 6=сб; NULL = конкретная дата
date DATE, -- для исключений из недельного расписания
is_working BOOLEAN NOT NULL DEFAULT true,
opens_at TIME NOT NULL,
closes_at TIME NOT NULL,
slot_duration INTEGER NOT NULL DEFAULT 60 -- минуты
);
CREATE TABLE bookings (
id BIGSERIAL PRIMARY KEY,
resource_id BIGINT NOT NULL REFERENCES bookable_resources(id),
service_id BIGINT REFERENCES services(id),
user_id BIGINT REFERENCES users(id),
client_name VARCHAR(255) NOT NULL,
client_phone VARCHAR(50),
client_email VARCHAR(255),
starts_at TIMESTAMP NOT NULL,
ends_at TIMESTAMP NOT NULL,
status VARCHAR(50) NOT NULL DEFAULT 'confirmed',
-- pending | confirmed | cancelled | no_show | completed
notes TEXT,
cancel_reason TEXT,
reminder_sent BOOLEAN NOT NULL DEFAULT false,
created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-- Исключаем пересечения на уровне БД
EXCLUDE USING gist (
resource_id WITH =,
tsrange(starts_at, ends_at, '[)') WITH &&
) WHERE (status NOT IN ('cancelled', 'no_show'))
);
EXCLUDE USING gist — constraint на пересечение временных диапазонов PostgreSQL. Требует расширения btree_gist. Это единственный надёжный способ исключить double-booking на уровне базы данных.
CREATE EXTENSION IF NOT EXISTS btree_gist;
Генерация доступных слотов
Слоты не хранятся в базе — они вычисляются из расписания за вычетом существующих бронирований:
class SlotGenerator
{
public function getAvailableSlots(
BookableResource $resource,
int $serviceDurationMinutes,
Carbon $date
): Collection
{
$schedule = $this->getScheduleForDate($resource, $date);
if (!$schedule || !$schedule->is_working) {
return collect();
}
$slots = collect();
$current = $date->copy()->setTimeFromTimeString($schedule->opens_at);
$closes = $date->copy()->setTimeFromTimeString($schedule->closes_at);
$duration = CarbonInterval::minutes($serviceDurationMinutes);
while ($current->copy()->add($duration)->lte($closes)) {
$slots->push($current->copy());
$current->addMinutes($schedule->slot_duration);
}
// Убираем слоты, которые пересекаются с существующими бронями
$existingBookings = Booking::where('resource_id', $resource->id)
->whereDate('starts_at', $date)
->whereNotIn('status', ['cancelled', 'no_show'])
->get();
return $slots->filter(function (Carbon $slot) use ($existingBookings, $duration) {
$slotEnd = $slot->copy()->add($duration);
return $existingBookings->every(function (Booking $booking) use ($slot, $slotEnd) {
return $slotEnd->lte($booking->starts_at) || $slot->gte($booking->ends_at);
});
})->values();
}
}
Атомарное создание бронирования
Constraint EXCLUDE USING gist ловит конкурентные вставки, но нужно обрабатывать исключение PostgreSQL:
class BookingService
{
public function create(array $data): Booking
{
try {
return DB::transaction(function () use ($data) {
$booking = Booking::create([
'resource_id' => $data['resource_id'],
'starts_at' => $data['starts_at'],
'ends_at' => Carbon::parse($data['starts_at'])
->addMinutes($data['duration']),
'client_name' => $data['client_name'],
'client_phone' => $data['client_phone'],
'client_email' => $data['client_email'],
'service_id' => $data['service_id'] ?? null,
'status' => 'confirmed',
]);
BookingConfirmed::dispatch($booking);
return $booking;
});
} catch (QueryException $e) {
// Код 23P01 — exclusion constraint violation в PostgreSQL
if (str_contains($e->getMessage(), '23P01')) {
throw new SlotAlreadyBookedException($data['starts_at']);
}
throw $e;
}
}
}
Управление расписанием
Расписание — иерархическое: недельный шаблон перекрывается конкретными датами (праздники, отгулы, особые часы):
private function getScheduleForDate(BookableResource $resource, Carbon $date): ?ResourceSchedule
{
// Сначала ищем конкретную дату (исключение)
$specific = $resource->schedules()
->whereDate('date', $date)
->first();
if ($specific) {
return $specific;
}
// Затем — шаблон дня недели
return $resource->schedules()
->where('day_of_week', $date->dayOfWeek)
->whereNull('date')
->first();
}
Напоминания
Автоматические напоминания снижают процент no-show:
// Запускается каждый час
class SendBookingReminders
{
public function handle(): void
{
$upcoming = Booking::where('status', 'confirmed')
->where('reminder_sent', false)
->whereBetween('starts_at', [
now()->addHours(23),
now()->addHours(25),
])
->get();
foreach ($upcoming as $booking) {
SendBookingReminder::dispatch($booking);
$booking->update(['reminder_sent' => true]);
}
}
}
Напоминание — за 24 часа по SMS и email. Можно добавить второе напоминание за 2 часа. Канал зависит от инфраструктуры: SMS через SMSC.ru, Twilio; email через Mailgun, SES, SMTP.
Отмена и перенос
Политика отмены конфигурируема: бесплатно за 24+ часа, штраф или запрет — менее чем за 2 часа. При отмене — автоматическое уведомление специалисту и клиенту.
Перенос — это отмена + новое бронирование. Важно: при переносе освобождается старый слот атомарно с созданием нового в одной транзакции.
Виджет записи на сайте
Трёхшаговый процесс:
- Выбор услуги — список с длительностью и ценой
- Выбор времени — календарь с доступными слотами (загружается через AJAX)
- Контактные данные — имя, телефон, email, примечание
Слоты загружаются по запросу при выборе даты:
GET /api/bookings/availability?resource_id=1&service_id=3&date=2025-04-15
Ответ — массив доступных временных меток. Фронтенд рендерит кнопки-слоты.
Административный календарь
Для администратора/специалиста — вид расписания в формате недельного календаря. Реализуется через FullCalendar (JS-библиотека) с кастомным источником событий:
GET /api/admin/bookings/calendar?resource_id=1&start=2025-04-14&end=2025-04-21
Возвращает события в формате FullCalendar, включая блокировки и перерывы.
Сроки реализации
- Базовая модель: ресурсы + расписание + бронирование + конфликтный constraint: 4–6 дней
- Генерация слотов + API для виджета: 2–3 дня
- Виджет записи (фронтенд): 3–4 дня
- Напоминания + уведомления об отмене: 1–2 дня
- Административный календарь: 2–3 дня
- Онлайн-оплата при бронировании (предоплата или депозит): +3–4 дня
Полная система: 2–4 недели.