HandyCafe Docs
owner cashier

시간 패키지

시간 패키지는 회원에게 선불 시간(분) 잔액을 제공합니다. 표준 요금으로 시간당 결제하는 대신 회원은 미리 시간 블록을 구매하여 여러 세션에 걸쳐 사용할 수 있습니다. 시스템이 잔여 잔액을 추적하고 회원이 PC 또는 콘솔을 사용할 때 자동으로 시간을 차감합니다.

시간 크레딧 시스템

지갑 시스템과 마찬가지로 시간 패키지는 크레딧 기반 아키텍처를 사용합니다. 시간 잔액이 추가될 때마다 새로운 시간 크레딧이 생성됩니다. 각 크레딧은 자체적인 시간(분) 잔액, 출처, 만료일, 기기 제한을 가진 독립적인 레코드입니다.

회원의 총 사용 가능 시간은 모든 활성 시간 크레딧의 잔여 시간 합계입니다.

시간 크레딧 필드

각 시간 크레딧 레코드에는 다음이 포함됩니다.

필드 설명
총 시간(분) 크레딧 생성 시 적재된 원래 시간(분)입니다.
잔여 시간(분) 현재 미사용 시간 잔액입니다. 회원이 세션을 사용할 때 감소합니다.
크레딧 유형 이 크레딧이 생성된 방법입니다(아래 크레딧 유형 참조).
기기 제한 이 크레딧에서 차감할 수 있는 기기 유형입니다(아래 기기 제한 참조).
상태 크레딧의 현재 수명주기 상태입니다.
만료일 선택적 만료 타임스탬프입니다. 이 날짜 이후에는 잔여 시간을 사용할 수 없습니다.
구매 ID 이 크레딧이 캠페인 패키지 구매로 생성된 경우, 해당 구매 레코드에 대한 참조입니다.

크레딧 유형

각 시간 크레딧은 생성 방법을 추적합니다.

크레딧 유형 설명
유료 회원이 직접 구매 또는 캠페인 패키지의 기본 제공분으로 이 시간을 결제했습니다.
보너스 패키지 구매 시 프로모션으로 지급된 시간입니다. 예: "120분 구매 시 30분 보너스 무료"
수동 캐셔 또는 관리자가 수동으로 추가한 시간입니다. 호의 크레딧, 보상 또는 특별 약정에 사용됩니다.

크레딧 상태

각 시간 크레딧은 다음 상태를 거칩니다.

  • 활성: 잔여 시간이 있고 만료되지 않았습니다. 이 크레딧에서 시간을 소비할 수 있습니다.
  • 만료됨: 크레딧의 만료일이 지났습니다. 잔액이 0보다 크더라도 잔여 시간을 사용할 수 없습니다.
  • 소진됨: 정상적인 사용을 통해 잔여 시간이 0에 도달했습니다.
  • 취소됨: 관리자가 수동으로 크레딧을 취소하여 잔여 시간이 무효화되었습니다.

기기 제한

각 시간 크레딧에는 어떤 유형의 기기에서 차감할 수 있는지를 제어하는 기기 제한이 있습니다.

제한 의미
클라이언트 클라이언트 PC에서 사용 가능합니다. 명시적으로 제한되지 않는 한 콘솔에서도 사용 가능합니다.
콘솔 게임 콘솔에서 사용 가능합니다. 명시적으로 제한되지 않는 한 PC에서도 사용 가능합니다.
PC 전용 클라이언트 PC에서만 사용 가능합니다. 콘솔 세션에서는 이 크레딧을 차감할 수 없습니다.
콘솔 전용 게임 콘솔에서만 사용 가능합니다. PC 세션에서는 이 크레딧을 차감할 수 없습니다.
모두 제한 없이 모든 기기 유형에서 사용 가능합니다. 기본값입니다.

기기 제한은 크레딧 생성 시 설정되며 이후 변경할 수 없습니다. 일반적으로 크레딧을 생성한 캠페인 패키지 정의에서 상속됩니다.

소비 추적

시간 크레딧에서 시간이 차감될 때마다 시스템은 시간 소비 레코드를 생성합니다.

필드 설명
소비 시간(분) 이 소비 이벤트에서 차감된 시간(분)입니다. 항상 양의 정수입니다.
소비 시각 차감이 발생한 타임스탬프입니다.
컨텍스트 차감을 유발한 원인입니다(아래 참조).
참조 차감을 발생시킨 특정 세션, 크레딧 또는 조정에 대한 참조입니다.

컨텍스트 유형

컨텍스트 설명
세션 사용 활성 세션 결제를 위해 소비된 시간입니다. 주요 소비 경로입니다.
만료 크레딧이 만료되었거나 만료 이벤트로 인해 잔여 시간이 조정될 때 제거된 시간입니다.
환불 환불 절차의 일부로 크레딧에 반환된 시간입니다(음수 소비 또는 새 크레딧 항목으로 기록됩니다).

캠페인 패키지와의 연동

시간 크레딧은 캠페인 패키지 구매를 통해 가장 일반적으로 생성됩니다.

  1. 운영자가 패키지 유형이 "분"인 하나 이상의 패키지가 포함된 캠페인을 생성합니다.
  2. 회원이 패키지를 선택하고 구매합니다(클라이언트 측 회원 패널 또는 카운터의 캐셔를 통해).
  3. 시스템이 적절한 시간 크레딧을 생성합니다.
    • 기본 시간 제공분(패키지의 기본 수량)에 대한 유료 크레딧
    • 패키지에 보너스 유형이 "분"으로 정의되어 있고 보너스 수량이 0보다 큰 경우, 보너스 시간에 대한 별도의 보너스 크레딧이 생성됩니다.
  4. 크레딧은 패키지의 기기 제한 설정을 상속합니다.
  5. 패키지에 유효 기간이 설정된 경우, 크레딧의 만료일은 구매일에 유효 일수를 더하여 계산됩니다.

세션 중 시간 차감 방식

사용 가능한 시간 잔액이 있는 회원이 세션을 시작하면 다음과 같이 진행됩니다.

  1. 시스템이 세션의 기기 유형과 일치하는 활성 시간 크레딧을 확인합니다.
  2. 만료일이 가장 빠른 순서로 크레딧을 소비하여 곧 만료될 크레딧의 낭비를 최소화합니다.
  3. 세션이 진행되는 동안 적격 크레딧에서 주기적으로 시간이 차감됩니다.
  4. 각 차감 시 "세션 사용" 항목으로 소비 레코드가 생성됩니다.
  5. 세션 종료 전에 모든 시간 크레딧이 소진되면 세션은 계속되며 잔여 시간은 표준 시간당 요금으로 청구됩니다(세션 종료 시 결제).

이를 통해 회원의 시간 잔액과 지갑 잔액이 함께 작동합니다. 시간 크레딧이 가능한 만큼의 시간을 처리하고, 초과분은 지갑 잔액 또는 현금 결제로 전환됩니다.