HandyCafe Docs
owner cashier

세션 관리

세션은 HandyCafe의 핵심 과금 단위입니다. 인터넷 카페 또는 게이밍 센터에서 고객이 PC나 게임 콘솔을 사용할 때마다 세션이 사용 시간을 추적하고 비용을 계산합니다. 이 페이지에서는 세션 시작부터 결제 수금까지 전체 세션 수명주기를 설명합니다.

세션 유형

HandyCafe는 두 가지 유형의 세션을 지원합니다.

  • PC 세션. 관리자 패널을 통해 관리되는 클라이언트 PC의 세션입니다. 클라이언트 소프트웨어는 유휴 시 PC를 잠그고 세션 시작 시 잠금을 해제합니다.
  • 콘솔 세션. 콘솔 페이지를 통해 관리되는 게임 콘솔(PlayStation, Xbox 등)의 세션입니다. 서버에서만 추적되며 콘솔 자체에는 클라이언트 소프트웨어가 없습니다.

두 세션 유형 모두 동일한 요금 엔진과 수명주기를 따르지만 대시보드의 다른 페이지에서 관리됩니다.

세션 수명주기

모든 세션은 명확한 상태 전환이 있는 정의된 수명주기를 따릅니다.

시작 --> 실행 중 --> (일시 중지 <--> 재개) --> 시간 추가 --> 종료

상태별 세부 사항은 다음과 같습니다.

  1. 시작. 캐셔가 세션을 시작합니다. 클라이언트 PC의 잠금이 해제되거나 콘솔 타이머가 시작됩니다.
  2. 실행 중. 세션이 활성 상태입니다. 시간이 흐르고 과금이 누적됩니다.
  3. 일시 중지. 캐셔가 세션을 일시적으로 중단합니다. 과금이 중지됩니다. 클라이언트에 일시 중지 상태가 표시됩니다.
  4. 재개. 캐셔가 일시 중지된 세션을 계속합니다. 새 요금 구간부터 과금이 재개됩니다.
  5. 시간 추가. 캐셔가 활성 세션에 시간(분)을 추가(또는 제거)합니다.
  6. 종료. 세션이 끝납니다. 시스템이 최종 비용을 계산하고 결제를 요청합니다.

세션 시작

클라이언트 PC에서 새 세션을 시작하려면 다음을 수행합니다.

  1. 클라이언트를 선택합니다. 관리자 패널에서 유휴(하늘색) 상태의 PC를 클릭하여 작업 버튼을 표시합니다.
  2. 과금 유형을 선택합니다. 후불(사용 후 결제) 또는 선불(사전 결제)을 선택합니다.
  3. 회원을 배정합니다(선택 사항). 고객이 등록 회원인 경우 자동 완성 회원 검색 필드를 사용하여 계정을 검색합니다. 회원을 배정하면 지갑 결제가 가능하고 세션이 해당 회원의 이력에 추적됩니다.
  4. 시간 또는 금액을 설정합니다(선불만 해당). 선불 세션의 경우 고객이 구매하는 시간(분) 또는 지불하는 금액을 입력합니다. 시스템이 현재 요금 슬롯에 기반하여 해당하는 시간을 계산합니다.
  5. 결제 수단을 선택합니다. 결제 수단(현금, 신용카드 또는 구성한 기타 수단)을 선택합니다.
  6. 확인합니다. 세부 사항을 검토하고 확인합니다. 클라이언트 PC가 즉시 잠금 해제되고 세션 타이머가 시작됩니다.

콘솔 세션의 경우 절차가 유사하지만 콘솔 페이지에서 시작합니다.

후불 세션

후불 세션에서는 고객이 먼저 PC를 사용하고 사용이 끝나면 결제합니다. 인터넷 카페, 사이버카페, 게이밍 센터에서 가장 일반적인 과금 모드입니다.

작동 방식:

  • 사전 결제 없이 세션이 시작됩니다.
  • 타이머가 실행되고 활성 요금 슬롯에 기반하여 비용이 실시간으로 누적됩니다.
  • 세션이 종료되면 시스템이 최종 계산된 비용을 표시합니다.
  • 캐셔가 결제를 수금하고 거래를 확인합니다.

후불 세션에는 시간 제한이 없습니다. 캐셔가 종료하거나 고객이 퇴장을 요청할 때까지 실행됩니다.

선불 세션

선불 세션에서는 고객이 특정 시간에 대해 사전 결제합니다. 구매한 시간이 만료되면 세션이 자동으로 종료됩니다.

설정 > 요금에서 구성되는 두 가지 선불 요금 모드가 있습니다.

구매 시 잠금

비용이 세션 시작 시점에 고정됩니다. 구매 시 활성화된 요금 슬롯과 배율이 세션이 실행되는 동안 발생하는 스케줄 변경에 관계없이 전체 세션 기간에 사용됩니다.

예시: 고객이 표준 요금 슬롯에서 오전 10:00에 60분을 구매합니다. 오전 11:00에 요금 스케줄이 반값 슬롯으로 전환되더라도 고객의 잔여 시간은 영향을 받지 않습니다. 원래 요금으로 결제한 만큼의 시간을 정확히 받습니다.

라이브 스케줄

세션이 다른 요금 슬롯을 통과할 때 비용이 실시간으로 조정됩니다. 고객의 세션이 슬롯 변경에 걸치면 새 요금을 기반으로 잔여 시간이 재계산됩니다.

예시: 고객이 표준 요금 슬롯에서 오전 10:00에 60분을 구매합니다. 오전 11:00에 스케줄이 반값 슬롯으로 전환됩니다. 분당 비용이 절반이 되므로 고객의 잔여 시간이 효과적으로 늘어납니다. 원래 구매한 것보다 더 많은 총 시간을 받을 수 있습니다.

세션 일시정지

일시 중지는 세션을 종료하지 않고 과금을 일시적으로 중단합니다. 고객이 잠시 자리를 비워야 할 때 유용합니다.

세션을 일시 중지하려면:

  1. 관리자 패널에서 활성 PC를 선택하고 카드의 일시 중지 버튼을 클릭합니다.

세션이 일시 중지되면:

  • 과금이 즉시 중지됩니다. 일시 중지 동안 비용이 발생하지 않습니다.
  • 현재 요금 구간이 "일시 중지" 경계로 닫힙니다.
  • 클라이언트 PC에 주황색 상태 표시기와 함께 일시 중지 상태가 표시됩니다.
  • 세션 타이머가 정지합니다.

일시 중지된 세션은 캐셔가 재개하거나 종료할 때까지 무기한 일시 중지 상태를 유지합니다.

세션 재개

재개는 일시 중지된 세션을 중단된 지점부터 계속합니다.

세션을 재개하려면:

  1. 관리자 패널에서 일시 중지된 PC를 선택하고 카드의 재개 버튼을 클릭합니다.

세션이 재개되면:

  • 현재 시간에 활성 요금 슬롯을 사용하여 새 요금 구간이 시작됩니다.
  • 과금이 재개됩니다.
  • 클라이언트 PC가 활성(녹색) 상태로 돌아갑니다.

재개 시점의 요금 슬롯이 세션이 일시 중지된 시점의 슬롯과 다를 수 있습니다. 새 구간은 현재 요금 스케줄에서 활성화된 요금을 사용합니다.

시간 추가

활성 세션에 언제든지 시간(분)을 추가하거나 제거할 수 있습니다.

시간을 추가하려면:

  1. 관리자 패널에서 활성 PC를 선택하고 카드의 시간 추가 버튼을 클릭합니다.
  2. 추가할 시간(분)을 입력합니다. 양수 값으로 세션을 연장하거나 음수 값으로 단축합니다.
  3. 확인합니다.

시간이 추가되면:

  • 세션 이력에 거래 레코드가 생성됩니다.
  • 선불 세션의 경우 종료 시간이 지정된 시간(분)만큼 앞으로(또는 뒤로) 조정됩니다.
  • 후불 세션의 경우 시간 추가 이벤트가 기록되지만 고정 종료 시간이 설정되지 않습니다.

세션 종료

세션 종료는 모든 과금을 중단하고, 클라이언트 PC를 잠그고, 결제 절차를 시작합니다.

세션을 종료하려면:

  1. 관리자 패널에서 활성 또는 일시 중지된 PC를 선택하고 카드의 종료 버튼을 클릭합니다.
  2. 세션 요약을 보여주는 결제 대화 상자가 나타납니다.

결제 대화상자

결제 대화 상자에는 다음 정보가 표시됩니다.

필드 설명
시간 총 활성 시간(일시 중지 기간 제외)
계산 금액 요금 구간에 기반한 원시 계산 비용
청구 금액 고객에게 청구할 금액(기본값은 계산 금액이지만 변경 가능)
부가세 구성된 경우 세금 금액
수수료 해당하는 경우 결제 수단 수수료
고정 수수료 해당하는 경우 결제 수단 고정 수수료
결제 수단 고객 결제 방법을 선택하는 드롭다운

캐셔 재정의: 캐셔가 청구 금액을 수동으로 조정할 수 있습니다. 예를 들어 캐셔가 호의로 금액을 내리거나 수동 할인을 적용할 수 있습니다. 감사를 위해 원래 계산 금액은 항상 기록에 보존됩니다.

  1. 결제 수단을 선택하고 확인합니다. 세션이 기록되고, 클라이언트 PC가 잠기고, 거래가 저장됩니다.

정산 프로세스

세션이 종료되면 정산 엔진이 다음 단계를 수행합니다.

  1. 마지막 열린 요금 구간을 닫습니다.
  2. 모든 닫힌 구간 금액을 합산합니다.
  3. 반올림 규칙을 적용합니다(구성된 반올림 단위로 항상 올림).
  4. 시작 수수료 최소값을 적용합니다(합계가 시작 수수료보다 절대 적지 않음).
  5. 결제 수단 수수료(BPS 기반)와 고정 수수료를 계산합니다.
  6. 결제 대화 상자에 최종 금액을 표시합니다.

요금 구간과 정산 계산의 자세한 설명은 세션 요금을 참조하십시오.

회원 세션

회원이 세션에 배정되면 추가 과금 옵션을 사용할 수 있습니다.

  • 지갑 결제. 세션 비용을 회원의 지갑 잔액에서 차감할 수 있습니다.
  • 시간 패키지 차감. 회원이 시간 패키지를 구매한 경우 금액 대신 패키지 잔액에서 시간(분)이 차감됩니다.
  • 회원 할인. 회원에게 할인이 구성되어 있는 경우(베이시스 포인트) 세션 비용에 적용됩니다.
  • 세션 이력. 세션이 회원 계정에 연결되어 세션 이력에 표시됩니다.

회원은 사용자명과 비밀번호로 로그인하거나 OAuth(구성된 경우)를 통해 클라이언트 대기 화면에서 직접 세션을 시작할 수도 있습니다.

세션 상태 값

각 클라이언트 PC에는 색상으로 구분된 상태 표시기가 표시됩니다.

상태 색상 의미
온라인 녹색 세션이 활성이고 실행 중
일시 중지 주황색 세션이 일시 중지됨, 과금 중단
유휴 하늘색 클라이언트가 연결되었지만 활성 세션이 없음
오프라인 빨간색 클라이언트가 서버에 연결되지 않음
관리자 보라색 클라이언트가 관리자/유지보수 모드
처리 중 노란색 클라이언트가 요청을 처리 중

이 상태 색상은 관리자 패널의 클라이언트 카드에 표시되어 모든 PC의 상태를 한눈에 파악할 수 있습니다.

세션 요금 구간

각 세션은 하나 이상의 요금 구간으로 나뉩니다. 과금 관련 이벤트가 발생할 때마다 새 구간이 생성됩니다.

  • 세션 시작
  • 일시 중지
  • 재개
  • 요금 슬롯 변경(시계가 스케줄의 다른 시간 슬롯으로 넘어갈 때)
  • 기본 가격 변경(관리자가 세션 도중 시간당 요금을 변경한 경우)
  • 연결 끊김 또는 재연결

각 구간은 요금 슬롯, 배율, 기본 가격, 시작 시간, 종료 시간, 계산된 금액을 기록합니다. 세션 합계는 반올림 및 최소 요금 규칙이 적용된 모든 구간의 합입니다.

구간 계산 방법의 전체 세부 사항은 세션 요금을 참조하십시오.

최소 요금 및 시작 수수료

매우 짧은 세션이라도 최소한 시작 수수료 금액이 청구됩니다. 이는 설정 > 요금에서 구성되며 사용 시간이 아무리 짧더라도 모든 세션이 최소 수준의 매출을 생성하도록 보장합니다.

예시: 시작 수수료가 $1.00으로 설정되어 있고 고객이 PC를 30초만 사용한 경우, 시간당 요금으로 30초에 해당하는 미세한 금액이 아닌 $1.00이 청구됩니다.


다음 단계