예약 가능 시간
예약 규칙 레퍼런스
예약 규칙 종류, 필드, 범위와 적용 동작을 정확하게 확인하세요.
규칙 종류
| 종류 | 관리자 목적 | 주요 값 |
|---|---|---|
hours | 요일별 영업 창과 시간 선택 간격을 만듭니다. | weekdays, start_time, end_time, slot_minutes |
block | 특정 기간을 전체 또는 한 범위에서 닫습니다. | starts_at, ends_at, scope_key, scope_value |
capacity | 고정된 시간 칸의 최대 동시 예약 수를 제한합니다. | max_concurrent, slot_minutes, scope_key |
gap | 같은 범위의 예약 사이에 최소 간격을 둡니다. | gap_minutes, scope_key |
custom | 플랫폼에서 배포한 조직별 판단을 적용합니다. | 플랫폼 관리 값 |
조직 관리자는 앞의 네 종류를 만들고 변경할 수 있습니다. custom 규칙은 플랫폼에서
배포한 로직과 함께 관리하므로 대시보드에서 만들거나 변경할 수 없습니다.
공통 필드
| 필드 | 의미 |
|---|---|
target | 규칙이 제한하는 데이터입니다. 현재 예약을 사용합니다. |
time_key | 예약 시각을 읽는 필드입니다. 기본값은 starts_at입니다. |
scope_key | 장비나 담당자처럼 예약을 나눌 사용자 필드 키입니다. 빈 값은 조직 전체입니다. |
position | 관리자 목록에서 규칙을 정렬하는 순서입니다. |
scope_key를 사용하는 규칙은 예약의 같은 사용자 필드 값을 기준으로 계산합니다. 특정 범위를
닫는 block 규칙에는 scope_value도 필요합니다.
적용 동작
- 여러 영업시간 창은 같은 요일에 함께 열릴 수 있습니다.
- 영업시간이 하나 이상 있으면 예약은 그중 하나의 창 안에 있어야 합니다.
- 휴무는 시작을 포함하고 종료를 제외합니다.
- 수용량은
slot_minutes크기의 고정된 칸마다 계산합니다. - 예약 간격은 후보 시각과 기존 예약의 실제 거리로 계산합니다.
- 취소, 노쇼와 완료 예약은 수용량과 간격 계산에서 제외합니다.
- 저장할 때 모든 규칙을 다시 확인합니다.
custom규칙을 확인할 수 없으면 안전을 위해 예약을 거부합니다.
시간 제안
영업시간 창의 slot_minutes가 고객에게 제안할 간격을 정합니다. 값이 없으면 다른 규칙의
가장 작은 간격을 사용하고, 적용할 값이 없으면 30분을 사용합니다. 영업시간 규칙 자체가
없으면 제안 시간은 빈 목록입니다.