용어집

HandyCafe 문서 전체에서 사용되는 도메인 용어의 알파벳순 참조입니다.

관리자 패널 HandyCafe 서버의 주요 모니터링 대시보드입니다. 연결된 모든 클라이언트, 상태, 활성 세션을 표시합니다. 또한 각 클라이언트 카드에 세션 제어와 원격 관리 작업을 위한 작업 버튼을 제공합니다.

수수료율 결제 처리 수수료를 나타내는 백분율입니다. 예: 1% 또는 5%. 특정 결제 수단을 수락하는 비용을 정의하기 위해 결제 수단 설정에서 사용됩니다.

바이너리 프로토콜 HandyCafe Server와 클라이언트 간 TCP 통신에 사용되는 압축 인코딩 형식입니다. 텍스트 기반 형식보다 빠르고 메시지 크기가 작아서 선택되었습니다.

클라이언트 HandyCafe Client 소프트웨어를 실행하는 고객용 PC입니다. 클라이언트는 로컬 네트워크를 통해 서버에 연결하고, 세션 명령을 받으며, 상태와 사용 데이터를 보고합니다. 각 클라이언트는 MAC 주소와 호스트명으로 식별됩니다.

연결 키 설정 시 서버와 각 클라이언트에 모두 구성되는 공유 비밀입니다. TCP 통신용 암호화 인증 토큰을 생성하는 데 사용되며, 승인된 장치만 서버와 명령을 주고받을 수 있도록 합니다.

콘솔 PlayStation이나 Xbox 같은 게이밍 장치로, HandyCafe가 관리합니다. 콘솔은 클라이언트 PC처럼 세션, 요금, 회원 사용을 지원하지만 HandyCafe Client 소프트웨어는 실행하지 않습니다. MAC 주소로 추적됩니다.

카페테리아 HandyCafe에 통합된 음식 및 음료 서비스 모듈입니다. 시각적 배치도, 테이블 관리, 카테고리와 상품이 있는 메뉴 편집기, 실시간 주문 대시보드, handy.cafe/{slug}의 브랜드 고객 메뉴를 포함합니다. 카페테리아는 클라우드 우선 데이터 모델을 사용하며, 로컬 데이터베이스와 클라우드 데이터베이스가 동기화 상태를 유지합니다.

인터넷 카페 / 사이버카페 보통 시간당 요금을 받으며 고객에게 컴퓨터와 인터넷을 제공하는 사업장입니다. 인터넷 카페라고도 합니다. HandyCafe는 세션, 과금, 회원 관리 등 사이버카페 운영의 모든 측면을 관리합니다.

기기 제한 지갑 크레딧, 시간 크레딧 또는 요금 규칙이 어떤 기기에 적용되는지를 지정하는 설정입니다. 가능한 값은 client(PC), console(게이밍 콘솔), PCs only, consoles only, both(모든 기기)입니다.

e스포츠 아레나 고성능 PC, 대회 무대, 관람석을 갖춘 경우가 많은 경쟁 게임과 e스포츠 이벤트 전용 장소입니다. HandyCafe는 세션 관리, 회원 추적, 콘솔 과금으로 e스포츠 아레나를 지원합니다.

혜택 회원이 패키지를 구매해서 받는 가치입니다. 세션 사용에 대한 시간 크레딧, 금전적 지갑 잔액, 또는 둘의 조합일 수 있습니다. 혜택은 회원의 지갑이나 시간 잔액에 크레딧 항목으로 기록됩니다.

배치도 카페테리아에서 캔버스 위에 테이블을 배치하는 시각적 편집기입니다. 여러 층, 드래그 앤 드롭 배치, 3D 이등각 뷰를 지원합니다. 테이블은 각각 정확히 한 층에 할당됩니다. 카페테리아 > 배치도를 참고하세요.

환율 기준 통화를 로컬 표시 통화로 변환할 때 사용하는 외환 환율입니다. 통화가 다른 지역의 카페가 내부 회계 기준은 일관되게 유지하면서 현지 통화로 가격을 표시할 수 있게 해 줍니다.

게이밍 센터 고객이 PC나 게이밍 콘솔을 사용하기 위해 비용을 지불하는 상업 시설로, 보통 고성능 하드웨어와 사회적 게임 환경을 제공합니다. HandyCafe는 세션 과금부터 회원 프로그램까지 게이밍 센터 운영을 관리하도록 만들어졌습니다.

암호화 인증 서버와 클라이언트 간 TCP 메시지의 무결성과 진위를 보장하기 위한 메시지 검증 메커니즘입니다. 양쪽 모두 연결 키를 사용해 인증 코드를 계산하고 검증합니다.

인터넷 카페 고객에게 시간제로 컴퓨터와 인터넷 서비스를 제공하는 사업입니다. 인터넷 카페는 HandyCafe의 주요 사용 사례이며, 세션 관리, 요금, 회원 프로그램, POS 운영을 다룹니다.

대기 PC가 서버에 연결되어 있지만 활성 세션이 없는 클라이언트 상태입니다. 대기 상태에서는 클라이언트가 잠금 화면(IdlePage)을 표시하고 세션 시작, 회원 로그인, 관리 작업을 기다립니다.

레거시 클라이언트 기존 레거시 프로토콜로 현대 서버에 연결하는 HandyCafe V3 또는 V4 클라이언트 설치입니다. 레거시 클라이언트는 관리자 패널에 Login, Logout, Add Time, Screenshot, Logoff, Reboot, Shutdown으로 구성된 축소된 작업 집합과 함께 표시됩니다. 런타임 지원은 설정 > 레거시 클라이언트에서 활성화합니다.

지갑 크레딧 / 시간 크레딧 충전이나 패키지 구매로 생성되는 지갑 잔액 또는 선불 분 단위의 개별 항목입니다. 각 크레딧 항목은 출처(현금 충전, 패키지 혜택, 캠페인 보너스), 남은 가치, 적용 가능한 기기 제한을 기록합니다. 크레딧은 세션 정산 시 순서대로 소비됩니다.

MAC 주소 네트워크 인터페이스에 할당되는 하드웨어 식별자입니다. HandyCafe는 MAC 주소를 사용해 클라이언트와 콘솔을 고유하게 식별하며, IP가 바뀌어도 장치를 인식할 수 있게 합니다.

mDNS (Multicast DNS) 로컬 네트워크에서 자동 서비스 검색을 위한 프로토콜입니다. HandyCafe 클라이언트는 mDNS로 자신의 존재를 알리며, 서버는 수동 IP 설정 없이 이를 감지할 수 있습니다.

회원 HandyCafe 시스템에 프로필이 등록된 고객입니다. 회원에게는 지갑, 등급, 거래 내역이 있습니다. 개인화된 세션을 위해 클라이언트 PC에서 로그인할 수 있으며, OAuth가 연결된 계정을 가질 수도 있습니다.

최소 단위 모든 재무 계산에서 부동 소수점 반올림 오류를 피하기 위해 내부적으로 사용하는 통화의 가장 작은 단위입니다. 예를 들어 USD는 센트(1달러 = 100 최소 단위)를, JPY는 엔(1엔 = 1 최소 단위)을 직접 사용합니다.

배율 요금 스케줄 슬롯 안에서 기본 시간당 요금에 적용되는 계수입니다. 1.0은 표준 요금, 1.5는 50% 높은 요금(예: 피크 시간), 0.5는 반값(예: 비혼잡 할인)을 뜻합니다.

PC방 고객이 시간당 PC 이용료를 지불하는 한국식 인터넷 카페이자 게이밍 센터입니다. PC방은 고급 게이밍 하드웨어와 경쟁 게임 문화로 알려져 있습니다. HandyCafe는 유연한 요금 스케줄과 세션 관리로 PC방 운영을 지원합니다.

온라인 활성 세션 중의 클라이언트 상태입니다. 온라인 상태에서 클라이언트는 데스크톱 인터페이스(OnlinePage)를 표시하며, 고객이 애플리케이션을 사용하고, 웹을 탐색하고, 클라이언트 메뉴와 상호작용할 수 있습니다.

후불 고객이 PC를 자유롭게 사용하고 실제 사용 시간에 따라 종료 시 결제하는 세션 과금 방식입니다. 최종 비용은 적용되는 요금 스케줄 구간을 기준으로 세션 종료 시 계산됩니다.

선불 고객이 고정된 시간에 대해 미리 결제하는 세션 과금 방식입니다. 구매한 시간이 만료되면 세션은 자동으로 종료되며, 연장하지 않는 한 계속되지 않습니다.

요금 구간 세션의 일부로, 하나의 요금 배율이 적용되는 시간 구간입니다. 구간 경계는 세션 시작, 일시정지, 재개, 또는 스케줄의 요금 슬롯 전환 같은 이벤트로 생성됩니다.

요금 슬롯 주간 요금 스케줄 그리드의 색상 코드 영역입니다. 각 슬롯은 시간 범위와 기본 시간당 요금을 수정하는 배율을 정의합니다. 슬롯은 특정 요일의 특정 시간대만 덮을 수 있어 피크/비피크 요금을 다르게 설정할 수 있습니다.

역할 캐셔 계정에 부여되는 이름 있는 권한 집합입니다. 역할은 캐셔가 수행할 수 있는 작업을 정의합니다(예: 세션 시작, 회원 관리, 보고서 보기). 여러 캐셔가 같은 역할을 공유할 수 있으며, 권한은 인터페이스 전반에서 적용됩니다.

보안 코드 직원이 카페테리아 테이블에 고객을 앉힐 때 생성되는 6자리 코드입니다. 고객은 테이블 QR을 스캔한 뒤 이 코드를 입력해 실제로 그 자리에 있는지 증명합니다. 코드는 서버 측에서 해시되며 테이블 닫기 또는 정산에서 만료됩니다. 코드 표시는 캐시된 평문을 보여 주고, QR 회전은 새 코드를 생성해 이전 스티커를 무효화합니다.

구간 경계 세션 안에서 새 요금 구간 생성을 유발하는 이벤트입니다. 경계에는 세션 시작, 세션 종료, 세션 일시정지, 세션 재개, 요금 슬롯 변경(시계가 한 슬롯에서 다른 슬롯으로 넘어갈 때)이 포함됩니다.

세션 고객이 PC 또는 콘솔을 사용하는 시간 단위의 기간입니다. 세션은 시작 시간, 종료 시간, 일시정지, 요금 구간, 총 청구 금액을 추적합니다. 선불 또는 후불일 수 있습니다.

정산 세션이 끝날 때 최종 비용을 결정하기 위해 수행하는 계산입니다. 정산은 모든 요금 구간을 처리하고, 해당 배율을 적용하며, 시작 수수료와 부가세를 더하고, 회원 할인을 차감해 최종 청구 금액을 만듭니다. 카페테리아에서는 선택한 결제 수단으로 테이블의 열린 주문을 모두 마감하고 테이블을 대기 상태로 되돌리는 한 번의 작업이기도 합니다.

STE (Smart/Turbo Edition) 레거시 클라이언트를 위한 프로토콜 변형입니다. STE 프레임에는 70바이트의 라이선스 정보 접두사가 포함되며, 프레임 크기는 1337바이트입니다. 다른 변형인 Standard는 1267바이트이며 접두사가 없습니다. 레거시 서버가 어떤 빌드였는지에 맞춰야 하며, 그렇지 않으면 프레임이 버려지거나 잘못 해석됩니다. 설정 > 레거시 클라이언트에서 변형을 설정합니다.

교대 캐셔의 로그인부터 로그아웃까지의 근무 기간입니다. 교대 중 수행된 모든 거래, 세션 작업, 관리 작업은 로그인한 캐셔에게 귀속됩니다. 교대 데이터는 책임성과 성과 분석에 사용됩니다.

시작 수수료 시간에 관계없이 세션당 적용되는 최소 요금입니다. 세션의 계산 비용(시간과 요금 기준)이 시작 수수료보다 낮으면, 대신 시작 수수료가 청구됩니다. 세션당 기본 수익을 보장합니다.

동기화 HandyCafe Server에서 클라이언트 PC로 파일을 동기화하는 과정입니다. 매니페스트 기반 비교와 청크 기반 전송을 사용해 네트워크 전체에 파일을 효율적으로 배포합니다.

등급 회원 등급 시스템의 로열티 수준입니다. 등급은 포인트 기준으로 정의되며 세션과 주문에 대한 할인율을 제공합니다. 회원이 지출로 포인트를 쌓을수록 더 나은 혜택이 있는 상위 등급으로 올라갑니다.

거래 세션, 주문, 지갑 충전 또는 기타 과금 이벤트에 대한 결제 기록입니다. 거래에는 금액, 결제 수단, 관련 회원 또는 캐셔, 타임스탬프가 포함됩니다.

부가세 (VAT) 세션 요금과 주문 금액에 적용되는 백분율 세금입니다. 부가세율은 요금 설정에서 구성되며 정산 계산에 반영됩니다. 부가세 금액은 세무 보고를 위해 별도로 추적됩니다.

지갑 HandyCafe 시스템에 저장된 회원의 선불 금전 잔액입니다. 지갑은 하나 이상의 크레딧 항목으로 구성되며, 세션, 주문, 기타 서비스 결제에 사용할 수 있습니다. 충전은 현금, 패키지, 캠페인을 통해 할 수 있습니다.