카페테리아 설정 방법

이 가이드는 카페테리아 모듈의 첫 설정 전체를 안내합니다. 끝나면 handy.cafe/{your-slug}에 게시된 고객 메뉴, 최소 한 개의 작동하는 테이블이 있는 배치도, 상품이 들어 있는 메뉴, 그리고 성공적으로 제출된 테스트 주문이 준비됩니다.

준비물

활성화된 HandyCafe 라이선스. 카페테리아 인증은 라이선스를 자동으로 사용하므로 키를 따로 입력하지 않습니다.
서버의 인터넷 연결. 카페테리아는 클라우드 우선이므로 프로비저닝, 메뉴 동기화, 주문 폴링에 모두 클라우드 API로의 외부 접속이 필요합니다.
공개 메뉴 URL에 사용할 슬러그. 허용 문자는 소문자, 숫자, 대시입니다. 길이는 3자에서 62자까지입니다.
선택 사항: 로고와 헤더 이미지. 권장 형식은 2 MB 이하의 WebP입니다.
선택 사항: 로컬 네트워크의 TCP 영수증 프린터.

1단계: 카페테리아 활성화

HandyCafe Server를 엽니다.
사이드바에서 설정으로 이동합니다.
카페테리아 탭을 엽니다.
카페테리아 활성화를 켭니다.
서버가 라이선스를 인증 토큰으로 사용해 클라우드 API에 연결합니다. 성공하면 프로비저닝 마법사가 열립니다.

예상 결과: 프로비저닝 마법사 화면이 나타납니다. 라이선스나 연결 오류가 보이면 인터넷 연결을 확인하고 HandyCafe 라이선스가 활성 상태인지 확인하세요.

2단계: 카페 개설

마법사는 네 가지 필드를 요청합니다.

슬러그. 원하는 URL 접미사를 입력합니다. 사용 가능 여부 표시가 1초 안에 갱신됩니다. 슬러그가 이미 사용 중이거나 예약되어 있으면 다른 값을 선택하세요.
표시 이름. 고객 메뉴 상단에 표시되는 사람이 읽을 수 있는 이름입니다. 예: "Atilla's Gaming Lounge".
국가 및 통화. 카페가 있는 국가를 선택합니다. 통화는 국가에 따라 기본값이 정해지며 이후 변경할 수 있습니다.
시간대. 주문 및 정산 타임스탬프에 사용할 시간대를 선택합니다.
카페 만들기를 클릭합니다.

예상 결과: 마법사가 닫히고 카페테리아 작업 공간이 열립니다. 공개 URL handy.cafe/{slug}가 이제 활성화되며, 아직 메뉴는 비어 있습니다.

3단계: 비즈니스 프로필 입력

계속해서 설정 > 카페테리아에서 비즈니스 프로필 섹션으로 스크롤합니다.
로고(정사각형 이미지)를 업로드합니다.
헤더 이미지(가로형 배너)를 업로드합니다.
고객 메뉴 푸터에 표시할 주소와 전화번호를 입력합니다.
고객에게 예상 준비 시간을 보여줄지에 따라 메뉴에 준비 시간 표시를 켜거나 끕니다.
저장을 클릭합니다.

예상 결과: 로고와 헤더가 미리보기로 나타납니다. 이제 브라우저에서 handy.cafe/{slug}를 열면 브랜드 헤더가 보이지만 내용은 아직 비어 있습니다.

4단계: 층 만들기

설정 > 카페테리아에서 층 섹션을 찾습니다.
층 추가를 클릭하고 이름을 붙입니다(예: "메인 홀").
매장에 여러 구역이 있다면 추가 층을 만듭니다(예: "중이층", "야외 테라스").
위/아래 이동 버튼으로 층 순서를 조정합니다. 맨 위 층은 배치도 편집기의 기본값이 됩니다.

예상 결과: 층이 목록에 표시됩니다. 이제 카페테리아 > 배치도 탭 상단에 층 칩이 나타납니다.

5단계: 배치도 만들기

카페테리아 > 배치도를 엽니다.
첫 번째 층을 칩에서 선택합니다.
테이블 추가를 클릭합니다. 정사각형 테이블이 캔버스 원점에 나타납니다.
테이블을 원하는 위치로 드래그합니다. 놓으면 저장됩니다.
테이블을 클릭해 속성 패널을 엽니다. 다음 항목을 설정합니다.
- 코드(예: "T1", "창가 3번")
- 표시 이름(선택 사항인 긴 레이블)
- 좌석 수
- 모양(정사각형, 가로 직사각형, 세로 직사각형, 원형)
- 크기(1~10)
층의 모든 테이블에 대해 반복합니다.
필요하면 3D 보기로 전환해 건축가 관점에서 배치를 검토합니다.

예상 결과: 배치도에 실제 위치대로 모든 테이블이 렌더링됩니다. 3D 보기에서는 드래그가 비활성화되므로, 테이블을 움직이려면 2D로 돌아가세요.

6단계: 메뉴 만들기

카페테리아 > 메뉴를 엽니다.
카테고리 추가를 클릭합니다. 이름을 입력하고 아이콘 선택기에서 MDI 아이콘을 고른 뒤 저장합니다.
"핫 드링크", "콜드 드링크", "버거", "디저트"처럼 각 카테고리에 대해 반복합니다.
카테고리 안에서 상품 추가를 클릭합니다. 다음을 입력합니다.
- 이름
- 설명(마크다운 지원)
- 재료 한 줄
- 기본 가격
- 부가세율
- 준비 시간(정적 대체값)
- 선택 사항: 단위 레이블, 재고 추적 플래그, 재고 수량
상품 사진을 업로드합니다. 모든 형식이 허용되며, WebP 2 MB 이하를 권장합니다.
저장을 클릭합니다.
상품에 선택지가 있다면 변형 섹션으로 스크롤해 변형 추가를 클릭합니다. 각 옵션과 가격 차이로 행을 만듭니다. 고객이 반드시 하나를 골라야 하면 필수를 켭니다.
메뉴의 모든 상품에 대해 반복합니다.

예상 결과: handy.cafe/{slug}의 고객 메뉴에 이제 카테고리와 상품이 보입니다. 브라우저에서 열어 확인하세요.

7단계: 프린터 설정(선택 사항)

계속해서 설정 > 카페테리아에서 프린터 설정으로 스크롤합니다.
종류를 TCP로 설정합니다.
프린터의 IP와 포트를 입력합니다. 대부분의 ESC POS TCP 프린터는 9100번 포트를 사용합니다.
프린터가 이를 지원하면 자동 절단을 켭니다.
들어오는 주문마다 인쇄하려면 새 주문 시 자동 인쇄를 켭니다.
데스크톱 알림과 함께 오디오 알림을 받으려면 알림음을 켭니다.
테스트 인쇄를 클릭합니다. 몇 초 안에 샘플 영수증이 인쇄되어야 합니다.

예상 결과: 테스트 영수증이 정상적으로 인쇄됩니다. 아무 것도 나오지 않으면 IP, 포트, 프린터가 서버와 같은 로컬 네트워크에 있는지 확인하세요.

8단계: 테이블을 앉히고 테스트 주문하기

카페테리아 > 테이블을 엽니다(또는 배치도 작업 메뉴를 사용합니다).
테이블 하나를 선택하고 고객 앉히기(또는 "테이블 열기")를 클릭합니다.
표시된 6자리 보안 코드를 확인합니다. 적어 두거나 대화상자를 열어 둡니다.
휴대폰에서 handy.cafe/{slug}/{table-code}로 이동합니다. 인쇄된 스티커가 있다면 QR을 스캔해도 됩니다.
6자리 코드를 입력합니다.
메뉴를 둘러보고 항목을 장바구니에 넣습니다.
결제로 이동합니다. 결제 수단으로 현금을 선택합니다(Stripe 설정은 선택 사항이며 나중에 추가할 수 있습니다).
주문을 제출합니다.
서버에서 카페테리아 > 주문으로 전환합니다.

예상 결과: 3초 안에 주문 대시보드에 새 주문 카드가 나타납니다. 데스크톱 알림이 뜹니다. 알림음이 켜져 있으면 오디오 알림이 재생됩니다. 주문 탭의 대기 수 배지가 증가합니다.

9단계: 테스트 주문을 진행하고 정산하기

주문 카드에서 다음 상태 버튼을 클릭합니다. 주문이 placed에서 confirmed로 이동합니다.
계속 클릭해 preparing, ready, served 순서로 진행합니다.
테이블 페이지에서 같은 테이블을 열고 정산을 클릭합니다.
결제 수단으로 현금을 선택하고 확인합니다.

예상 결과: 테이블이 idle로 돌아갑니다. 보안 코드는 만료됩니다. 정산 기록이 생성되며 나중에 감사할 수 있습니다.

흔한 실수

비즈니스 프로필을 건너뛰는 경우. 프로필을 저장하기 전에 출시하면 고객에게 기본 표시 이름과 깨진 로고 영역이 보입니다.
슬러그 변경 후 QR을 다시 인쇄하지 않는 경우. 슬러그를 바꾸면 기존 QR이 모두 무효가 됩니다. 모든 테이블에 새 스티커를 인쇄해 교체하세요.
출시 초기에 카테고리를 너무 많이 공개하는 경우. 상위 카테고리는 6개에서 10개 정도를 목표로 하세요. 메뉴가 화면에 맞을 때 고객이 더 빨리 둘러봅니다.
첫 실제 교대 전에 프린터를 설정하지 않는 경우. 새 주문 자동 인쇄가 없으면 바쁜 시간에 주문을 놓칠 수 있습니다. 최소 한 번은 꼭 테스트 인쇄를 하세요.
동적 기록이 없는 상태에서 기본 메뉴에 준비 시간 표시를 켜 두는 경우. 처음 30일 동안은 정적 값이 고객에게 보입니다. 현실적인 정적 시간을 넣거나 동적 추정이 학습될 때까지 칩을 끄세요.
직원 테스트와 고객 테스트에 같은 기기를 쓰는 경우. 고객 세션은 24시간 유지됩니다. 나중에 같은 기기가 고객에게 전달되면 검증 없이 바로 메뉴에 들어가게 됩니다. 테스트 전용 프로필이나 깨끗한 브라우저를 사용하세요.