📐 Диаграма на реалния flow, по кода в репото

Как работи резервацията

Пълният път на една резервация — от избор на свободен час до потвърдено плащане — точно както е имплементиран в контролерите и webhook-а.

Клиент Система / персонал

Избира услуга

Вижда списък с активните услуги на бизнеса.

BookingController@index

Избира свободен час

Системата генерира слотове за работния ден (09:00–17:00) и маха вече заетите — изчислено на момента, не кеширано.

BookingController@create — availableSlots()

Проверка за застъпване

При подаване на формата сървърът прави реална SQL проверка дали часът вече не е зает — предпазва от двойна резервация дори при два едновременни опита.

Booking::scopeOverlapping()

Резервацията се създава като "pending"

Записва се в базата с чакащ статус и се подготвя Stripe Checkout сесия за плащане.

StripeCheckoutService::createSessionForBooking()

Плаща през Stripe Checkout

Клиентът се пренасочва към защитената страница на Stripe за плащане с карта.

Webhook потвърждава плащането

Stripe известява сървъра директно (не през браузъра на клиента) — подписът на заявката се проверява, преди резервацията да се маркира като платена.

StripeWebhookController@handle

Вижда потвърждение

Страница с детайлите на резервацията — услуга, час, статус.

BookingController@confirmation

Персоналът управлява от админ табло

Служебен изглед (зад логин + admin проверка) показва всички резервации и позволява смяна на статус — напр. на "завършена" след посещението.

Admin\DashboardController

    Технически детайли
    Двойна резервация е технически невъзможна — проверката е на ниво база данни (WHERE starts_at < ? AND ends_at > ?), не само във фронтенда.
Webhook route-ът изрично изключва CSRF защитата (Stripe не е логнат браузър) и вместо това проверява криптографски подписания Stripe-Signature header.
Отменена резервация освобождава часа отново — изключена е от проверката за застъпване.

  