Defines constraints for bookable time slots.

This is not an event — it's a template that defines the rules for creating events (like Cal.com's Event Types or a clinic's appointment type configuration).

Examples

# Standard 30-minute meetings with 5-minute buffer
%PhoenixLiveCalendar.BookingConfig{
  duration: 30,
  buffer_after: 5,
  min_notice: 60,
  max_advance: 30
}

# Flexible duration consultation (15-60 min)
%PhoenixLiveCalendar.BookingConfig{
  duration: 30,
  min_duration: 15,
  max_duration: 60,
  slot_interval: 15,
  buffer_before: 10,
  buffer_after: 10
}

# Group class with capacity
%PhoenixLiveCalendar.BookingConfig{
  duration: 60,
  seats: 20,
  min_notice: 120,
  availability: [
    %PhoenixLiveCalendar.Availability{
      days_of_week: [1, 3, 5],
      start_time: ~T[09:00:00],
      end_time: ~T[10:00:00]
    }
  ]
}

Fields

• duration — Default slot duration in minutes (default: 30)
• min_duration / max_duration — Allowed range for free-form booking
• slot_interval — Minutes between slot start times. If nil, defaults to duration. Example: duration=60, slot_interval=15 means slots at 9:00, 9:15, 9:30, 9:45, 10:00...
• buffer_before / buffer_after — Required gap in minutes before/after each booking
• min_notice — Minimum minutes in advance a booking can be made (0 = no restriction)
• max_advance — Maximum days in advance a booking can be made (nil = no limit)
• seats — Number of concurrent bookings per slot (1 = exclusive, >1 = group/shared)
• availability — List of PhoenixLiveCalendar.Availability windows when slots are offered
• timezone — IANA timezone string for interpreting availability times