카페를 처음부터 설정하는 방법

이 가이드는 인터넷 카페, 게임 센터, 또는 e스포츠 아레나에서 HandyCafe를 새로 설치하는 모든 단계를 안내합니다. 이 가이드를 완료하면 작동하는 서버, 최소한 하나의 연결된 클라이언트 PC, 설정된 요금, 그리고 결제가 기록된 테스트 세션을 완료하게 됩니다.

준비물

HandyCafe 서버로 사용할 Windows PC (Windows 10 이상, 최소 4 GB RAM).
클라이언트 스테이션으로 사용할 추가 Windows PC 최소 한 대.
모든 PC를 연결하는 로컬 네트워크 (신뢰성을 위해 유선 이더넷 권장).
유효한 HandyCafe 베타 라이선스 키. 초기 설정 시 입력합니다.
미리 결정된 시간당 요금과 통화.

1단계: 서버 설치 및 구성

HandyCafe 대시보드에서 최신 HandyCafe 서버 설치 프로그램을 다운로드합니다.
서버로 지정한 PC에서 설치 프로그램을 실행합니다. 화면의 지시에 따라 기본 설치 디렉토리를 수락합니다.
HandyCafe 서버를 실행합니다. 첫 실행 시 자동으로 초기 설정 마법사가 나타납니다.
라이선스 키를 입력합니다. 서버는 온라인으로 키를 검증하고 카페 이름과 PC 제한을 표시합니다.
관리자 계정을 생성합니다. 사용자 이름과 강력한 비밀번호를 입력합니다. 이 계정은 모든 기능에 대한 무제한 접근 권한을 가집니다.
카페 이름을 설정합니다. 이 이름은 클라이언트 대기 화면과 보고서에 표시됩니다.
마법사를 완료하려면 마침을 클릭합니다.

예상 결과: 서버 메인 창이 열리며 관리 패널에 연결된 클라이언트가 0으로 표시됩니다. 카페 이름이 제목 표시줄에 나타납니다.

2단계: 요금 설정

왼쪽 사이드바에서 톱니바퀴 아이콘을 클릭하여 설정 페이지를 엽니다.
요금 탭으로 이동합니다.
기본 통화를 설정합니다. 통화 드롭다운에서 선택합니다. 모든 가격, 거래, 보고서는 이 통화를 사용합니다.
시간당 요금을 입력합니다. 이는 후불 세션의 시간당 기본 요금입니다. 예를 들어, 시간당 10 단위를 입력합니다.
부가가치세(VAT) 비율을 설정합니다. 세션 요금에 적용되는 비율(0~100)을 입력합니다. VAT가 적용되지 않으면 0을 입력합니다.
시작 요금을 설정합니다. 세션의 지속 시간에 관계없이 최소 요금입니다. 최소 요금을 원하지 않으면 0을 입력합니다.
일반적인 지속 시간을 위한 요금 프리셋을 만듭니다. 프리셋 섹션으로 스크롤합니다. 프리셋 추가를 클릭합니다. 다음과 같은 프리셋을 만듭니다:
- "30분"은 30분 지속 시간.
- "1시간"은 60분 지속 시간.
- "2시간"은 120분 지속 시간.
저장을 클릭하여 요금 구성을 적용합니다.

예상 결과: 요금 탭에 시간당 요금, VAT 비율, 시작 요금, 모든 프리셋이 아래에 나열됩니다. 이 프리셋은 선불 세션 시작 시 빠른 선택 버튼으로 나타납니다.

3단계: 네트워크 설정 확인

설정에서 네트워크 탭으로 이동합니다.
수신 포트를 확인합니다. 기본값은 7842입니다. 네트워크의 다른 서비스가 해당 포트를 사용 중인 경우에만 변경합니다.
연결 키를 설정하거나 기록합니다. 이 키는 클라이언트 연결을 인증합니다. 모든 클라이언트 PC는 연결을 위해 동일한 키를 사용해야 합니다.
서버 PC의 방화벽이 설정된 포트에서 수신 TCP 연결을 허용하는지 확인합니다. Windows에서는 HandyCafe가 설치 중에 이 규칙을 추가합니다. 포트를 변경한 경우 수동으로 새 방화벽 규칙을 추가합니다.
네트워크 탭에 표시된 서버 PC의 IP 주소를 기록합니다. 클라이언트가 자동 검색을 통해 서버를 찾지 못할 경우 필요합니다.

예상 결과: 네트워크 탭에 수신 포트와 연결 키가 표시됩니다. 서버 상태 표시기가 녹색으로 "수신 중"을 나타냅니다.

4단계: 첫 번째 클라이언트 배포

대시보드에서 HandyCafe 클라이언트 설치 프로그램을 다운로드합니다.
첫 번째 클라이언트 PC에 설치합니다. 설치 프로그램을 실행하고 지시에 따릅니다.
HandyCafe 클라이언트를 실행합니다. 클라이언트는 로컬 네트워크에서 mDNS를 통해 서버를 자동으로 검색하려고 시도합니다.
자동 검색이 실패하면 클라이언트 연결 대화 상자에 서버 IP 주소와 포트를 수동으로 입력합니다.
3단계에서 기록한 연결 키를 입력합니다.
연결이 설정될 때까지 기다립니다. 클라이언트 화면이 잠금 화면과 시계를 표시하는 대기 페이지로 전환됩니다.

예상 결과: 서버의 관리 패널에 하나의 연결된 클라이언트가 표시됩니다. 클라이언트 타일에 호스트 이름과 파란색 "대기 중" 상태가 표시됩니다. 클라이언트 PC는 잠금 화면을 표시합니다.

서버는 호스트 이름을 기반으로 클라이언트에 표시 이름을 자동 할당합니다. 이름을 변경하려면 서버에서 클라이언트 타일을 선택하고 이름 변경을 클릭합니다.

5단계: 첫 번째 테스트 세션 실행

서버 관리 패널에서 대기 중인 클라이언트 타일에서 시작을 클릭합니다.
세션 대화 상자에서 후불을 선택합니다. 게스트 세션을 위해 회원 필드를 비워 둡니다.
확인을 클릭하여 세션을 시작합니다.

예상 결과: 클라이언트 타일이 녹색으로 변하고 타이머가 올라갑니다. 클라이언트 PC에서 잠금 화면이 사라지고 온라인 페이지 데스크톱이 나타납니다.

요금 계산을 확인하기 위해 세션을 최소 5분 동안 실행합니다.
서버의 녹색 클라이언트 타일에서 중지를 클릭합니다.
비용 내역 대화 상자를 검토합니다. 다음이 표시됩니다:
- 지속 시간 (예: 5분).
- 적용된 시간당 요금.
- VAT 금액.
- 총 요금.
결제 방법을 선택합니다 (기본값은 현금).
확인을 클릭하여 세션을 종료하고 결제를 기록합니다.

예상 결과: 클라이언트 타일이 파란색 "대기 중" 상태로 돌아갑니다. 클라이언트 PC는 다시 잠금 화면을 표시합니다. 시스템에 거래가 기록됩니다.

6단계: 현금 보고서에서 확인

왼쪽 사이드바를 사용하여 현금 보고서 페이지로 이동합니다.
오늘의 보고서에 하나의 세션 거래가 표시되는지 확인합니다.
세션 중지를 할 때 본 비용 내역과 거래 금액이 일치하는지 확인합니다.
결제 방법 열에 "현금" (또는 선택한 방법)이 표시되는지 확인합니다.

예상 결과: 현금 보고서에 올바른 금액, 지속 시간, 결제 방법으로 완료된 세션 하나가 나열됩니다. 이제 카페가 운영 가능합니다.

7단계: 선택적 다음 단계

기본 설정이 작동하면 다음 기능을 구성하는 것을 고려하십시오:

회원 추가. 회원 페이지로 이동합니다. 추가를 클릭하여 사용자 이름과 선택적 지갑 잔액이 있는 회원 계정을 만듭니다. 회원은 클라이언트 PC에서 로그인할 수 있습니다.
제품 설정. 제품 페이지로 이동합니다. 캐셔가 주문을 생성할 수 있도록 음식 및 음료 항목과 가격을 추가합니다.
클라이언트 메뉴 구성. 설정 > 클라이언트 메뉴로 이동합니다. 고객이 온라인 페이지에서 런처 그리드를 볼 수 있도록 애플리케이션 카테고리와 앱을 추가합니다.
추가 클라이언트 배포. 카페의 모든 스테이션 PC에 HandyCafe 클라이언트를 설치합니다. 각 클라이언트는 서버에 자동으로 나타납니다.
캐셔 계정 생성. 관리 페이지로 이동합니다. 적절한 역할로 캐셔 계정을 추가하여 직원이 로그인하고 세션을 관리할 수 있도록 합니다.
피크/비피크 요금 설정. 설정 > 요금 일정으로 이동합니다. 바쁜 시간 동안 더 많은 요금을 부과하기 위한 시간 기반 배율을 만듭니다.
OAuth 로그인 활성화. 설정 > OAuth로 이동합니다. 고객이 소셜 계정으로 로그인할 수 있도록 Google 또는 다른 제공자를 구성합니다.

피해야 할 일반적인 실수

방화벽 규칙 생략. 클라이언트가 연결할 수 없는 가장 일반적인 원인은 Windows 방화벽 규칙이 수신 포트를 차단하는 것입니다. 다른 문제를 해결하기 전에 규칙이 존재하는지 확인하십시오.
연결 키 불일치. 모든 클라이언트의 키는 서버의 키와 정확히 일치해야 합니다. 오타를 피하기 위해 복사-붙여넣기 하십시오.
시간당 요금을 0으로 설정. 시간당 요금을 0으로 두면 모든 후불 세션이 무료가 됩니다. 라이브로 전환하기 전에 항상 요금을 확인하십시오.
설정 저장을 잊음. 설정 페이지의 변경 사항은 저장을 클릭할 때까지 적용되지 않습니다. 재시작 후 설정이 변경되지 않은 것처럼 보이면 저장을 잊었을 가능성이 큽니다.
서버와 클라이언트를 동일한 PC에서 실행. 테스트 목적으로는 가능하지만, 실제 운영에서는 권장되지 않습니다. 서버 PC는 전용 스테이션이어야 합니다.