K-Beautypass 병원 파트너 가이드

A. 예약 자격 제한 (Eligibility Check)

시스템은 예약 시점에 다음 조건들을 자동으로 검증합니다. 조건 미달 시 예약이 차단됩니다.

• 나이 제한: 만 18세 이상만 예약 가능합니다.
• 국적 제한: 한국 국적 소지자는 예약이 불가능합니다 (외국인 환자 유치업법 준수).
• 이메일 인증: 이메일 인증이 완료된 계정만 예약할 수 있습니다.
• 중복 예약 방지: 동일한 시술에 대해 이미 '결제 완료(Completed)'된 유효한 예약이 있는 경우 중복 예약을 막습니다.

B. 시간 슬롯 시스템 (Time Slot System)

• 단위: 예약 시간은 기본 30분 단위로 배정됩니다.
• 동시성 제어: 여러 사용자가 동시에 같은 시간을 보고 있더라도, 결제 버튼을 누르는 순간 실시간으로 재고(Slot Capacity)를 확인합니다. 먼저 결제한 사용자가 슬롯을 선점하며, 후순위 사용자는 "이미 마감된 시간입니다"라는 메시지를 받게 됩니다.

C. 결제와 정산 데이터 생성

• 환자가 결제를 완료하는 즉시 시스템 내부적으로 정산 테이블(ReservationSettlement) 데이터가 생성됩니다.
• 초기 상태는 Paid(결제됨)이며, 추후 병원 방문이 완료되면 정산 확정 단계로 넘어갑니다.

A. 상태 변경의 제약 (Status Constraints)

관리자는 임의로 모든 상태로 변경할 수 없으며, 정해진 흐름을 따라야 합니다.

• Pending (대기) → Confirmed (승인) 또는 Cancelled (취소)
• Confirmed (승인) → Completed (완료) 또는 No Show (노쇼)
• 주의: Pending 상태에서 바로 Completed로 넘어갈 수 없습니다. 반드시 승인 절차를 거쳐야 합니다.

B. 노쇼(No-Show) 처리와 수수료

• 환자가 예고 없이 방문하지 않은 경우 No Show 처리를 합니다.
• 이때 시스템은 사전에 설정된 노쇼 수수료(No-Show Fee) 로직을 가동하여, 예약금에서 수수료를 차감하거나 위약금을 부과하는 정산 데이터를 자동으로 생성합니다.

C. 알림 시스템 연동

• 상태 변경 버튼을 누르는 즉시 비동기 작업(Background Job)으로 이메일 및 푸시 알림이 큐(Queue)에 등록됩니다.
• 관리자가 별도로 연락하지 않아도 환자에게 실시간으로 변경 사항이 전달됩니다.

A. 정산 확정의 조건

• 정산은 반드시 예약 상태가 Completed (방문 완료) 일 때만 최종 확정이 가능합니다.
• 단순히 결제만 되었다고 정산이 지급되지 않으므로, 현장 데스크에서 '방문 완료' 처리를 누락하지 않도록 주의해야 합니다.

B. 조정(Adjustment) 데이터 구조

• 조정 금액을 입력하면 원본 결제 데이터를 수정하는 것이 아니라, 별도의 조정 내역(Adjustment Record) 이 JSON 형태로 메타데이터에 추가됩니다.
• 이는 회계 감사(Audit) 시 "누가, 언제, 왜 금액을 변경했는지" 추적하기 위함입니다.

C. 다통화 지원 (Multi-currency)

• 환자가 USD, JPY 등으로 결제했더라도, 병원 정산은 KRW(원화) 기준으로 환산되어 표시됩니다.
• 환불 시에는 환자가 결제한 원본 통화 금액을 기준으로 환율 변동을 고려하여 계산됩니다.