자주 묻는 질문

설정 및 설치

HandyCafe는 어떤 유형의 사업장을 지원합니까?

HandyCafe는 인터넷 카페, 게이밍 센터, e스포츠 아레나, 사이버카페, PC방을 위해 설계되었습니다. PC 또는 게이밍 콘솔에 시간제 접근을 제공하는 모든 사업장은 HandyCafe로 세션, 과금, 회원 관리를 할 수 있습니다.

HandyCafe Server의 시스템 요구사항은 무엇입니까?

서버는 Windows 10 이상(64비트), 최소 4GB RAM, 500MB 디스크 공간, 로컬 네트워크 연결이 필요합니다. 클라이언트 PC는 Windows 10 이상과 2GB RAM이 필요합니다. 모든 PC는 같은 LAN에 있어야 합니다. 자세한 내용은 시스템 요구사항을 참고하세요.

HandyCafe Server는 어떻게 설치합니까?

공식 웹사이트에서 설치 프로그램을 내려받아 실행하고 안내를 따르세요. 처음 실행하면 초기 설정 마법사가 관리자 계정을 만듭니다. 단계별 안내는 서버 설치를 참고하세요.

클라이언트 PC를 서버에 어떻게 연결합니까?

PC에 HandyCafe Client를 설치하세요. 로컬 네트워크에서 서버를 자동으로 찾기 위해 mDNS를 사용합니다. 자동 검색이 실패하면 클라이언트 설정에서 서버 IP를 수동으로 입력하세요. 클라이언트 설치를 참고하세요.

클라이언트가 서버에 연결되지 않는 이유는 무엇입니까?

흔한 원인은 서버가 실행 중이 아니거나, PC가 서로 다른 서브넷에 있거나, 방화벽이 포트(TCP 5001, 5002, 5003 및 UDP 5004)를 차단하거나, 연결 키가 일치하지 않는 경우입니다. 자세한 해결책은 문제 해결을 참고하세요.

HandyCafe는 어떤 포트를 사용합니까?

TCP 5001(명령), TCP 5002(파일 전송), TCP 5003(원격 관리), UDP 5004(화면 스트리밍)입니다. 이 값은 네트워크 설정에서 바꿀 수 있습니다.

라이선스는 어떻게 활성화합니까?

라이선스 패널에 라이선스 키를 입력하세요. 서버가 라이선싱 서버로 검증합니다. 처음 활성화할 때는 인터넷 연결이 필요합니다. 라이선싱을 참고하세요.

서버가 72시간 이상 오프라인이면 어떻게 됩니까?

HandyCafe에는 72시간 오프라인 유예 시간이 있습니다. 이 기간 동안 모든 기능은 정상 동작합니다. 72시간 동안 라이선싱 서버와 연결되지 않으면 인터넷이 복구될 때까지 서버가 잠금 상태로 들어갑니다.

세션 및 요금

PC에서 세션을 어떻게 시작합니까?

관리자 패널에서 대기 상태(청록색) PC를 선택하고 카드의 시작을 클릭합니다. 후불 또는 선불 모드를 고르고, 필요하면 회원을 배정하고, 선불이면 지속 시간/금액을 설정한 뒤 결제 수단을 선택하고 확인합니다. 세션을 참고하세요.

선불과 후불 세션의 차이는 무엇입니까?

후불은 고객이 실제 사용 시간에 따라 종료 시 결제하는 방식입니다. 선불은 정해진 시간 또는 금액을 미리 결제하는 방식입니다. 선불에는 구매 시 잠금(시작 시 비용 고정)과 실시간 스케줄(시간대 변경에 따라 비용 조정) 두 가지 하위 모드가 있습니다. 세션을 참고하세요.

요금 스케줄은 어떻게 작동합니까?

요금 스케줄은 7일 x 24시간 그리드로, 각 시간 블록이 색상으로 구분된 요금 슬롯에 배정됩니다. 각 슬롯에는 배율(예: 1.0배 표준, 1.5배 피크, 0.5배 비피크)이 있습니다. 세션 비용은 기본 시간당 요금 x 슬롯 배율 x 시간으로 계산됩니다. 세션 요금을 참고하세요.

주말과 평일에 다른 가격을 설정하려면 어떻게 합니까?

설정 > 요금 스케줄에서 서로 다른 배율의 요금 슬롯을 만듭니다(예: "평일" 1.0배, "주말" 1.3배). 주말 열에는 주말 슬롯 색상을, 평일 열에는 평일 슬롯 색상을 칠하세요. 요금 스케줄 설정을 참고하세요.

세션을 일시정지하고 재개하려면 어떻게 합니까?

온라인 PC 카드에서 일시정지를 클릭합니다. 일시정지 중에는 과금이 멈춥니다. 다시 시작하려면 일시정지된 PC 카드에서 재개를 클릭합니다. 재개되면 새로운 요금 구간이 시작됩니다. 세션을 참고하세요.

활성 세션에 시간을 추가하려면 어떻게 합니까?

온라인 PC 카드에서 시간 추가를 클릭합니다. 추가할 분 수를 입력하세요(양수는 연장, 음수는 차감). 조정 기록이 거래로 남습니다.

세션이 여러 요금 슬롯에 걸치면 어떻게 됩니까?

세션은 슬롯 경계에서 자동으로 여러 구간으로 나뉩니다. 각 구간은 해당 기간에 활성화된 배율을 사용합니다. 총 비용은 모든 구간 비용의 합입니다. 세션 요금을 참고하세요.

시작 수수료란 무엇입니까?

시작 수수료는 모든 세션에 적용되는 최소 요금입니다. 세션이 매우 짧아도 고객에게 최소 이 금액은 청구됩니다. 요금 설정에서 설정합니다.

회원 및 로열티

새 회원은 어떻게 생성합니까?

회원 페이지로 이동해 회원 추가를 클릭합니다. 사용자명, 표시 이름, 선택적 이메일, 전화번호, 기타 정보를 입력하세요. 해당되면 등급을 지정합니다. 회원을 참고하세요.

지갑 시스템은 어떻게 작동합니까?

각 회원에게는 지갑 잔액이 있습니다. 지갑을 충전하면 특정 금액과 크레딧 유형(유료, 보너스, 수동 등)을 가진 지갑 크레딧이 생성됩니다. 세션 동안 지갑은 자동으로 소비됩니다. 크레딧에는 만료일과 기기 제한이 있을 수 있습니다. 회원 지갑을 참고하세요.

지갑 크레딧이란 무엇입니까?

지갑 크레딧은 한 번의 충전으로 생성되는 지갑 잔액의 개별 항목입니다. 각 크레딧은 금액, 크레딧 유형(유료, 보너스, 수동), 상태(활성, 만료됨, 소진됨), 사용 가능 기기 제한을 기록합니다. 크레딧은 오래된 것부터 순서대로 사용됩니다. 회원 지갑을 참고하세요.

로열티 등급과 포인트는 어떻게 작동합니까?

회원은 지출, 방문, 충전, 주문 같은 활동으로 포인트를 쌓습니다. 각 등급에는 포인트 기준이 있습니다. 충분한 포인트를 모으면 다음 등급으로 올라갑니다. 상위 등급은 더 좋은 할인율을 제공할 수 있습니다. 로열티 등급을 참고하세요.

회원 지갑을 어떻게 충전합니까?

회원 페이지에서 회원을 선택하고 결제/충전 옵션을 클릭한 뒤 금액, 크레딧 유형, 결제 수단을 선택하고 확인합니다. 새 지갑 크레딧이 생성됩니다. 회원 지갑을 참고하세요.

회원이 지갑 잔액을 PC와 콘솔 모두에 사용할 수 있습니까?

크레딧의 기기 제한에 따라 다릅니다. 크레딧은 "PC 전용", "콘솔 전용", "둘 다"로 제한할 수 있습니다. 패키지를 구매할 때 기기 제한은 패키지 설정으로 정의됩니다. 패키지를 참고하세요.

지갑 크레딧이 만료되면 어떻게 됩니까?

크레딧이 만료일에 도달하면 상태가 "만료됨"으로 바뀌고 남은 잔액은 더 이상 사용할 수 없습니다. 만료된 금액은 회원 거래 내역에 기록됩니다.

회원의 거래 내역은 어떻게 봅니까?

회원 페이지에서 회원을 선택합니다. 회원 상세 패널에 지갑 충전, 사용, 환불, 조정 내역이 타임스탬프와 금액과 함께 표시됩니다.

상품, 주문, 재고

카탈로그에 상품을 어떻게 추가합니까?

상품으로 이동해 상품 추가를 클릭합니다. 이름, 카테고리, 단위, 바코드, 판매가, 원가, 부가세율을 입력하세요. 활성/비활성도 전환할 수 있습니다. 상품을 참고하세요.

고객 주문은 어떻게 생성합니까?

주문으로 이동해 새 주문을 클릭합니다. 필요하면 PC를 배정하거나 메모를 추가하고, 상품 카탈로그에서 수량과 함께 항목을 추가한 뒤, 결제 수단으로 주문을 마감합니다. 주문을 참고하세요.

주문을 취소하거나 환불하려면 어떻게 합니까?

주문 페이지에서 주문을 열고 취소를 클릭합니다. 주문은 무효 처리되며 결제 기록이 남지 않습니다. 이미 마감된 주문을 환불하려면 해당 환불 흐름을 사용하세요.

재고 추적은 어떻게 작동합니까?

각 상품에는 재고 수량이 있습니다. 재고 로그는 판매(주문 종료 시 자동 차감), 입고(재고 항목에서), 조정, 폐기, 반품 같은 사유와 함께 변화를 기록합니다. 상품과 재고를 참고하세요.

캠페인 및 패키지

캠페인은 어떻게 만듭니까?

캠페인으로 이동해 캠페인 추가를 클릭합니다. 이름과 설명을 입력하고, 활성 상태로 설정한 뒤 필요하면 만료일을 지정하세요. 그 다음 캠페인에 패키지를 추가합니다. 캠페인을 참고하세요.

분 단위 패키지와 금액 기반 패키지의 차이는 무엇입니까?

분 단위 패키지는 회원에게 세션에 사용할 시간(분)을 제공합니다. 금액 기반 패키지는 회원의 지갑에 금액을 추가합니다. 둘 다 보너스 금액을 포함할 수 있습니다. 패키지를 참고하세요.

패키지의 보너스 시스템은 어떻게 작동합니까?

패키지에는 기본 혜택 위에 보너스가 포함될 수 있습니다. 예를 들어 "60분 + 보너스 15분" 또는 "$10 + $2 보너스" 같은 형태입니다. 보너스는 "보너스" 크레딧 유형으로 태그된 별도 크레딧 항목을 만듭니다.

패키지의 기기 제한은 어떻게 작동합니까?

각 패키지는 기기 제한을 정의합니다. 클라이언트(PC), 콘솔, 둘 다, PC 전용, 콘솔 전용 중 하나입니다. 패키지를 구매하면 생성된 지갑/시간 크레딧이 이 제한을 상속하고, 맞는 기기에서만 사용할 수 있습니다.

캐셔 관리

캐셔 계정은 어떻게 생성합니까?

관리 > 캐셔로 이동합니다. 캐셔 추가를 클릭하고 사용자명과 비밀번호를 입력한 뒤 역할을 배정합니다. 그러면 해당 자격 증명으로 로그인할 수 있습니다. 캐셔 역할을 참고하세요.

캐셔 역할 권한은 어떻게 설정합니까?

관리 > 캐셔 역할로 이동합니다. 새 역할을 만들거나 기존 역할을 편집합니다. 6개 범주(인증, 회원, 콘솔, 로그, 보고서, 결제 수단) 각각의 개별 권한 플래그를 체크하거나 해제합니다. 캐셔 역할을 참고하세요.

6개의 권한 범주는 무엇입니까?

인증(1개 플래그), 회원(6개 플래그: 보기, 추가, 삭제, 수정, 이메일 보기, 전화번호 보기), 콘솔(4개 플래그: 보기, 추가, 삭제, 수정), 로그(4개 플래그: 보기, 전체 기록, 오늘만, 삭제), 보고서(3개 플래그: 보기, 전체 기록, 오늘만), 결제 수단(4개 플래그: 관리, 추가, 삭제, 수정)입니다. 총 22개의 개별 권한 플래그가 있습니다.

캐셔 로그인에서 무차별 대입 방지는 어떻게 작동합니까?

10분 동안 로그인 실패가 5회 누적되면 계정이 15분 동안 잠깁니다. 모든 실패 시도는 보안 경고와 함께 감사 추적에 기록됩니다.

캐셔 교대 보고서는 어떻게 봅니까?

현금 보고서 페이지를 엽니다. 캐셔 이름으로 필터링하면 해당 캐셔의 교대 중 처리된 거래를 볼 수 있습니다. 교대 요약에는 총액과 결제 수단별 내역이 표시됩니다.

설정 및 구성

언어는 어떻게 바꿉니까?

설정 > 일반으로 이동해 드롭다운에서 언어를 선택합니다. HandyCafe는 24개 언어를 지원합니다. 인터페이스는 즉시 업데이트됩니다. 일반 설정을 참고하세요.

Google OAuth 로그인은 어떻게 설정합니까?

설정 > OAuth로 이동합니다. OAuth를 전역으로 활성화한 뒤 Google을 켭니다. Google Cloud Console에서 가져온 Client ID와 Client Secret을 입력하세요. 필요하면 JSON 자격 증명 파일을 가져올 수도 있습니다. 클라이언트 PC에서 OAuth 로그인을 시작해 테스트합니다. OAuth 설정을 참고하세요.

요금 스케줄 그리드는 어떻게 구성합니까?

설정 > 요금 스케줄로 이동합니다. 스케줄을 켜고, 배율이 있는 색상 코드 슬롯을 만든 뒤, 7x24 시간 그리드에서 클릭/드래그해 원하는 슬롯으로 시간 블록을 칠합니다. 요금 스케줄 설정을 참고하세요.

클라이언트 대기 화면은 어떻게 사용자 지정합니까?

설정 > 클라이언트 > 대기 화면 탭으로 이동합니다. 슬라이드쇼를 켜고, 이미지나 비디오를 추가하고, 지속 시간과 전환 효과를 설정합니다. 시계와 카페 이름 오버레이도 선택적으로 켤 수 있습니다. 클라이언트 대기 화면을 참고하세요.

클라이언트 외관 테마는 어떻게 바꿉니까?

설정 > 클라이언트 > 외관 탭으로 이동합니다. 테마(Neon Arena, Crimson Pulse, Emerald Depth)를 선택하고, 레이아웃 프리셋을 고른 뒤, 배경, 카드 밀도, 효과를 설정합니다. 클라이언트 외관을 참고하세요.

알림음은 어떻게 설정합니까?

설정 > 사운드로 이동합니다. 전체 사운드 토글을 켠 다음, 15개의 기본 옵션 중에서 각 이벤트(Call Cashier, New Order, Session End, Login Request)에 맞는 소리를 선택합니다. 사운드 설정을 참고하세요.

연결 키란 무엇이며 왜 중요합니까?

연결 키는 서버와 클라이언트 사이의 암호화 인증에 사용되는 공유 비밀입니다. 승인되지 않은 기기가 서버에 연결하는 것을 막습니다. 모든 클라이언트는 서버와 같은 키를 사용해야 합니다. 네트워크 설정에서 구성합니다.

원격 관리

클라이언트 PC의 원격 스크린샷은 어떻게 찍습니까?

관리자 패널에서 클라이언트를 선택하고 카드의 스크린샷을 클릭합니다. 스크린샷 뷰어에 캡처된 이미지가 표시됩니다. 새 캡처로 새로고침하거나 이미지를 다운로드할 수 있습니다. 스크린샷을 참고하세요.

원격 데스크톱으로 클라이언트 PC를 어떻게 제어합니까?

클라이언트 카드를 선택하고 원격 데스크톱을 클릭합니다. 실시간 H.264 비디오 스트리밍 창이 열립니다. 마우스와 키보드를 원격으로 제어할 수 있고, 서버와 클라이언트 간 클립보드 동기화도 동작합니다. 원격 데스크톱을 참고하세요.

파일 동기화 시스템은 어떻게 작동합니까?

설정 > 동기화 탐색기에서 동기화할 디렉터리를 구성합니다. 실행되면 서버가 파일 매니페스트를 만듭니다. 클라이언트는 매니페스트를 로컬 파일과 비교하고, chunk 기반 전송으로 바뀐 파일이나 새 파일만 내려받습니다. 파일 동기화를 참고하세요.

클라이언트 PC에서 어떤 앱이 실행 중인지 어떻게 봅니까?

관리자 패널에서 클라이언트를 선택하고 카드의 실행 중인 앱을 클릭합니다. 현재 실행 중인 프로세스의 이름과 세부 정보가 패널에 표시됩니다. 같은 작업 버튼에서 시작 프로그램, 설치된 앱, 창 앱도 볼 수 있습니다.

클라이언트 PC에 메시지를 어떻게 보냅니까?

클라이언트 카드를 선택하고 메시지 전송을 클릭합니다. 메시지를 입력하고 확인하세요. 메시지가 고객 화면에 표시됩니다.

클라이언트 PC를 원격으로 종료하거나 재시작하려면 어떻게 합니까?

클라이언트 카드를 선택하고 종료 또는 재부팅을 클릭합니다. 여러 클라이언트를 선택해 일괄 작업을 할 수도 있습니다. 오프라인 PC를 켤 때는 Wake on LAN도 사용할 수 있습니다.

보고서 및 분석

현금 보고서는 어떻게 봅니까?

사이드바에서 현금 보고서로 이동합니다. 보고서에는 요약 카드, 거래 내역, 기기 수익, 차트가 표시됩니다. 날짜 필터로 기간을 좁힐 수 있습니다. 현금 보고서를 참고하세요.

보고서 데이터를 어떻게 내보냅니까?

현금 보고서에서 내보내기/복사 기능을 사용해 거래 데이터를 CSV 형식으로 클립보드에 복사합니다. 그런 다음 Excel이나 다른 스프레드시트 앱에 붙여넣을 수 있습니다.

통계 페이지에서 어떤 분석을 사용할 수 있습니까?

아홉 개의 분석 탭이 있습니다: 매출 추이, 판매 분석, 비용 추적, 세션 통계, 콘솔 이용률, 애플리케이션 사용량, 컴퓨터 이용률, 회원 활동, 캐셔 실적. 통계를 참고하세요.

컴퓨터 이용률은 어떻게 확인합니까?

통계 > 컴퓨터 사용 탭으로 이동합니다. 각 PC의 이용률, 가동 시간, 기기별 매출이 표시됩니다. 가장 바쁜 PC도 확인할 수 있습니다. 세션 및 컴퓨터 통계를 참고하세요.

문제 해결

클라이언트가 "오프라인"으로 보이는데 PC는 켜져 있습니다. 어떻게 해야 합니까?

다음을 확인하세요: 1) PC에서 HandyCafe Client가 실행 중인지, 2) 두 PC가 같은 네트워크/서브넷에 있는지, 3) 방화벽이 TCP 포트 5001-5003을 허용하는지, 4) 서버와 클라이언트의 연결 키가 같은지. 문제 해결을 참고하세요.

세션 요금이 잘못된 것 같습니다. 어떻게 확인합니까?

요금 설정(설정 > 요금)에서 기본 시간당 요금과 부가세를 확인하세요. 세션 시점에 활성화된 배율은 요금 스케줄(설정 > 요금 스케줄)에서 확인합니다. 세션의 요금 구간을 거래 상세에서 검토하면 각 구간이 어떻게 계산되었는지 볼 수 있습니다.

OAuth 로그인이 "대기 중"에서 멈췄습니다. 어떻게 해결합니까?

관리자가 요청 페이지에서 요청을 승인했는지 확인하세요. 막혀 있다면 다음을 확인합니다: 1) 설정 > OAuth의 OAuth 제공자 자격 증명이 올바른지, 2) 서버가 제공자 API에 접근할 인터넷이 있는지, 3) 기기 코드가 만료되지 않았는지(보통 15~30분 후 만료).

원격 데스크톱이 느립니다. 어떻게 개선합니까?

스트림 설정에서 비트레이트를 낮춰 보세요(LAN에서는 1000~2000kbps 정도가 좋습니다). 서버와 클라이언트 사이의 네트워크 대역폭을 확인하세요. UDP 포트 5004가 차단되지 않았는지도 확인합니다. 최상의 결과를 원하면 Wi-Fi 대신 유선 이더넷을 사용하세요.

라이선스에 "over_limit"이 표시됩니다. 무슨 뜻입니까?

허용된 수보다 더 많은 클라이언트 PC가 연결되어 있습니다. 사용하지 않는 클라이언트를 끊거나 라이선스를 업그레이드하세요. 연결된 클라이언트 수가 한도 이하가 될 때까지 서버는 새 세션을 시작하지 않습니다.

캐셔가 너무 많은 로그인 실패로 잠겼습니다. 어떻게 해제합니까?

자동 잠금이 풀릴 때까지 15분 기다리세요. 급하면 관리자가 관리 인터페이스에서 캐셔 계정을 직접 처리할 수 있습니다.

카페테리아

고객은 테이블에서 어떻게 주문합니까?

고객은 휴대폰으로 테이블의 QR 코드를 스캔하고, 직원에게 받은 6자리 보안 코드를 입력한 뒤, 자신의 언어로 메뉴를 둘러보고, 상품을 장바구니에 담아 현금 또는 온라인(Stripe) 결제로 제출합니다. 주문은 3초 안에 카페테리아 주문 대시보드에 표시됩니다. 고객 메뉴를 참고하세요.

카페테리아 모듈은 어떻게 활성화합니까?

설정 > 카페테리아를 열고 카페테리아 활성화를 켭니다. 서버는 HandyCafe 라이선스를 자동으로 인증에 사용합니다. 프로비저닝 마법사에서 슬러그, 표시 이름, 국가, 통화, 시간대를 요청합니다. 카페테리아 개요와 카페테리아 설정 방법을 참고하세요.

고객 메뉴는 어떤 언어를 지원합니까?

handy.cafe/{slug}의 고객 메뉴는 24개 언어를 지원합니다. 첫 방문 때 브라우저의 Accept-Language 헤더를 보고 가장 잘 맞는 언어를 고릅니다. 고객은 상단 선택기로 언제든지 언어를 바꿀 수 있습니다.

카페테리아는 인터넷 없이도 작동합니까?

아니요. 카페테리아는 클라우드 우선입니다. 프로비저닝, 메뉴 동기화, 주문 폴링 모두 외부 인터넷 접속이 필요합니다. 고객용 페이지는 클라우드가 제공하며, 로컬 서버가 인터넷에서 바로 접근 가능할 필요는 없습니다.

레거시 클라이언트

HandyCafe는 오래된 V3 또는 V4 클라이언트를 지원합니까?

그렇습니다. 설정 > 레거시 클라이언트에서 런타임 지원을 켜면 서버가 원래 레거시 포트(UDP 710/711, TCP 712, 파일 전송 717)에 리스너를 시작합니다. 기존 클라이언트는 아무 변경 없이 연결됩니다. 이들은 관리자 패널에 축소된 작업 집합(Login, Logout, Add Time, Screenshot, Logoff, Reboot, Shutdown)과 함께 표시됩니다. 레거시 클라이언트를 참고하세요.

레거시와 현대 클라이언트를 같은 서버에서 동시에 실행할 수 있습니까?

그렇습니다. 두 프로토콜 스택은 서로 다른 포트를 사용하며 충돌하지 않습니다. 같은 LAN에서 구버전과 신버전 클라이언트를 섞어 쓰고, 같은 관리자 패널에서 관리할 수 있습니다.

오래된 HandyCafe 설치에서 데이터를 가져올 수 있습니까?

그렇습니다. Windows에서 가능합니다. 설정 > 레거시 클라이언트를 열고 데이터베이스 마이그레이션으로 스크롤해 마이그레이션 시작을 클릭하세요. 회원, 요금, 상품, 주문, 거래, 로그가 가져와집니다. 원본 파일은 수정되거나 삭제되지 않습니다. 결과가 예상과 다르면 마이그레이션 되돌리기를 눌러 롤백할 수 있습니다. 레거시 설치에서 이전하는 방법을 참고하세요.

STE와 Standard 프로토콜 변형의 차이는 무엇입니까?

STE(Smart/Turbo Edition) 프레임에는 70바이트의 license info 접두사가 포함되며 프레임 크기는 1337바이트입니다. Standard 프레임에는 접두사가 없고 프레임 크기는 1267바이트입니다. 레거시 서버가 어떻게 만들어졌는지에 맞는 변형을 고르세요. 잘못 고르면 프레임이 버려지거나 잘못 읽힙니다.