Слот — это не свободная точка старта, а весь интервал услуги. Если в 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 позволяет объяснить, почему старое бронирование отличается от новых правил.
Границы проверяются отдельной матрицей
- Проверить конец услуги ровно в начале busy range и начало ровно в его конце.
- Проверить услугу короче, равную и длиннее шага сетки.
- Добавить buffer before/after и увидеть изменение первых и последних слотов.
- Создать две параллельные попытки одного времени и сохранить только одну.
- Проверить переход локального времени через DST в поддерживаемой зоне.
- Изменить длительность услуги и оставить существующие записи неизменными.
Для разбора нужны длительность и буферы услуги, график сотрудника, busy intervals, timezone, шаг сетки и один пример неверного candidate start. Контакты клиентов можно заменить идентификаторами — причина живёт в интервалах.