Слот — это не свободная точка старта, а весь интервал услуги. Если в 11:00 уже есть запись, часовая услуга не может начинаться в 10:30: её конец 11:30 пересечёт занятость. Для каждого кандидата вычисляйте end и только потом решайте, показывать время пользователю или нет.

Быстрый контрольный пример: график сотрудника 09:00–13:00, занятость 11:00–11:30, длительность 60 минут. Допустимы 09:00 и 10:00, но не 10:30, 11:00 и 12:30. Если выдача другая, код проверяет start, а не диапазон.

Полуинтервал убирает спор на границе

CandidateИнтервал услугиРезультат
09:00[09:00,10:00)Свободен
10:00[10:00,11:00)Свободен, конец совпал с началом busy
10:30[10:30,11:30)Пересекает busy 11:00–11:30
11:30[11:30,12:30)Свободен после busy
12:30[12:30,13:30)Выходит за график

Модель [start,end) включает начало и исключает конец. Поэтому запись, заканчивающаяся в 11:00, не конфликтует с другой, начинающейся в 11:00. RFC 5545 также определяет DTEND события как не включённый конец.

Длительность и буферы собираются до поиска

service_start = candidate_start
service_end = service_start + service_duration
occupied_start = service_start - buffer_before
occupied_end = service_end + buffer_after

fits_shift = occupied_start >= shift_start
             && occupied_end <= shift_end
overlaps = busy_start < occupied_end && busy_end > occupied_start

Буфер может зависеть от услуги, сотрудника или помещения, но его источник фиксируется в снимке бронирования. Если администратор позже изменит стандартную длительность, существующая запись не должна незаметно сократиться или исчезнуть.

Рабочее окно тоже является диапазоном

  • Смена сотрудника задаёт допустимый outer range.
  • Перерыв, отпуск и блокировка помещения добавляют busy ranges.
  • Несколько услуг подряд объединяются в один составной interval или последовательность без разрывов.
  • Шаг сетки определяет candidate starts, но не заменяет проверку пересечений.
  • Часовой пояс применяется при построении локального дня, хранение выполняется в однозначном времени.

Сначала объедините пересекающиеся busy ranges, затем вычитайте их из рабочего окна. Генерировать каждые пять минут на год вперёд необязательно: ограничьте горизонт записи и шаг, разрешённые настройками бизнеса.

Показанный слот ещё раз проверяется при записи

Между открытием календаря и нажатием кнопки другой клиент может занять то же время. Backend повторно вычисляет интервал и блокирует конфликтующее бронирование. В PostgreSQL range type и exclusion constraint могут запретить overlap для одного сотрудника на уровне базы.

Constraint не заменяет понятный ответ пользователю: при конфликте верните, что слот только что заняли, обновите список и предложите соседние варианты. Повтор запроса с тем же idempotency key не создаёт вторую запись.

Изменение графика не удаляет существующие записи

Если новый график больше не покрывает будущую запись, пометьте конфликт для администратора, но не скрывайте и не переносите запись автоматически. Снимок duration, buffers, timezone и resource IDs позволяет объяснить, почему старое бронирование отличается от новых правил.

Границы проверяются отдельной матрицей

  1. Проверить конец услуги ровно в начале busy range и начало ровно в его конце.
  2. Проверить услугу короче, равную и длиннее шага сетки.
  3. Добавить buffer before/after и увидеть изменение первых и последних слотов.
  4. Создать две параллельные попытки одного времени и сохранить только одну.
  5. Проверить переход локального времени через DST в поддерживаемой зоне.
  6. Изменить длительность услуги и оставить существующие записи неизменными.

Для разбора нужны длительность и буферы услуги, график сотрудника, busy intervals, timezone, шаг сетки и один пример неверного candidate start. Контакты клиентов можно заменить идентификаторами — причина живёт в интервалах.

Проверенные источники