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

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

필요한 것

HandyCafe Server로 사용할 Windows PC(Windows 10 이상, 최소 4 GB RAM)
클라이언트 스테이션으로 사용할 최소 하나의 추가 Windows PC
모든 PC를 연결하는 로컬 네트워크(안정성을 위해 유선 Ethernet 권장)
유효한 HandyCafe 베타 라이선스 키. 처음 설정 시 입력합니다.
원하는 시간당 요금 및 통화를 사전에 결정

1단계: 서버 설치 및 구성

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

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

2단계: 요금 구성

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

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

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

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

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

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

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

예상 결과: 서버의 관리자 패널에 연결된 클라이언트 하나가 표시됩니다. 클라이언트 타일에 호스트명과 파란색 "유휴" 상태가 표시됩니다. 클라이언트 PC에 잠금 화면이 표시됩니다.

서버가 호스트명을 기반으로 클라이언트에 자동으로 표시 이름을 배정합니다. 이름을 바꾸려면 서버에서 클라이언트 타일을 선택하고 이름 변경을 클릭합니다.

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

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

예상 결과: 클라이언트 타일이 녹색으로 변하고 0부터 증가하는 실행 중인 타이머가 표시됩니다. 클라이언트 PC에서 잠금 화면이 사라지고 온라인 페이지 데스크톱이 나타납니다.

요금 계산을 확인할 수 있도록 최소 5분 동안 세션을 실행합니다.
서버에서 녹색 클라이언트 타일의 종료를 클릭합니다.
비용 분석 대화 상자를 확인합니다. 다음이 표시됩니다.
- 시간(예: 5분)
- 적용된 시간당 요금
- 부가세 금액
- 총 요금
결제 수단을 선택합니다(현금이 기본값).
확인을 클릭하여 세션을 마감하고 결제를 기록합니다.

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

6단계: 매출 보고서에서 확인

왼쪽 사이드바를 사용하여 매출 보고서 페이지로 이동합니다.
오늘의 보고서에 세션 거래 하나가 표시되는지 확인합니다.
거래 금액이 세션 종료 시 본 비용 분석과 일치하는지 확인합니다.
결제 수단 열에 "현금"(또는 선택한 수단)이 표시되는지 확인합니다.

예상 결과: 매출 보고서에 올바른 금액, 시간, 결제 수단이 포함된 완료된 세션 하나가 나열됩니다. 카페가 이제 운영 준비가 되었습니다.

7단계: 선택적 다음 단계

기본 설정이 작동하면 다음 기능 구성을 고려합니다.

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

일반적인 실수 방지

방화벽 규칙을 건너뛰는 경우. 클라이언트가 연결할 수 없는 가장 일반적인 원인은 수신 대기 포트를 차단하는 Windows 방화벽 규칙입니다. 다른 문제를 해결하기 전에 규칙이 존재하는지 확인합니다.
연결 키가 일치하지 않는 경우. 모든 클라이언트의 키는 서버의 키와 정확히 일치해야 합니다. 오타를 방지하려면 복사하여 붙여넣습니다.
시간당 요금을 0으로 설정하는 경우. 시간당 요금을 0으로 두면 모든 후불 세션이 무료가 됩니다. 영업 시작 전에 항상 요금을 확인합니다.
설정을 저장하는 것을 잊는 경우. 설정 페이지의 변경 사항은 저장을 클릭할 때까지 적용되지 않습니다. 재시작 후 설정이 변경되지 않은 것 같으면 저장을 잊은 것일 수 있습니다.
동일한 PC에서 서버와 클라이언트를 실행하는 경우. 테스트 목적으로는 기술적으로 가능하지만 프로덕션에는 권장되지 않습니다. 서버 PC는 전용 스테이션이어야 합니다.