카페테리아
카페테리아는 HandyCafe에 통합된 음식 및 음료 서비스 모듈입니다. 테이블의 디지털 배치도를 만들고, handy.cafe/{your-slug}에서 브랜드가 적용된 셀프 서비스 메뉴를 웹에 게시하며, 서버 대시보드에서 들어오는 모든 주문을 실시간으로 추적할 수 있습니다.
고객은 테이블의 QR 코드를 스캔하고 6자리 보안 코드를 입력한 뒤, 자신의 언어로 메뉴를 둘러보고 주문을 넣습니다. 주문은 몇 초 안에 카페테리아 주문 화면에 표시됩니다. 직원은 준비 단계별 진행 상황을 확인하고, 서비스가 완료되면 "정산" 작업으로 한 번에 계산을 마감할 수 있습니다.
대상
카페테리아는 좌석에서 음식과 음료를 제공하는 인터넷 카페, 게이밍 센터, e스포츠 아레나를 위해 설계되었습니다. 종이 주문지와 카운터로의 구두 요청을 대체합니다. 표준 HandyCafe 세션 및 요금 시스템과 함께 동작하며, 카페테리아 주문은 별도로 추적되지만 동일한 카페 라이선스에서 관리됩니다.
핵심 기능
| 기능 | 요약 |
|---|---|
| 배치도 | 여러 층을 지원하는 시각적 편집기입니다. 테이블을 끌어 배치하고, 3D 보기로 전환하고, 테이블을 사용 중지 상태로 표시할 수 있습니다. |
| 테이블 | 테이블별 좌석 수, 모양, 크기(1~10), 표시 코드를 설정합니다. QR 코드를 생성하고 필요할 때 회전할 수 있습니다. |
| 메뉴 | MDI 아이콘이 있는 카테고리, 사진과 마크다운 설명이 있는 상품, 재료 목록, 변형 그룹(예: 크기, 토핑)을 지원합니다. |
| 주문 | 3초 간격 폴링, 대기 수 배지, 데스크톱 및 오디오 알림, 주문별 및 항목별 상태를 갖춘 실시간 대시보드입니다. |
| 정산 | 한 번의 클릭으로 테이블의 모든 열린 주문을 선택한 결제 수단으로 정산합니다. |
| 고객 메뉴 | handy.cafe/{slug}에서 24개 언어를 지원하는 브랜드 웹 메뉴이며, 라이트/다크 테마와 기기 인식 언어 기본값을 제공합니다. |
| 온라인 결제 | 주문 시 결제를 위한 선택적 Stripe Checkout 통합과, 테이블에서 현금 결제하는 대체 흐름을 제공합니다. |
| 프린터 | 새 주문이 들어오면 자동 절단과 자동 인쇄를 수행하는 선택적 TCP 영수증 프린터를 지원합니다. |
서버 UI에서 카페테리아가 있는 위치
카페테리아에는 두 개의 진입점이 있습니다.
- 사이드바의 카페테리아 섹션. 일상 업무를 위한 운영 작업 공간입니다. 테이블, 배치도, 메뉴, 주문, 일정의 다섯 개 탭이 있습니다. 주문 탭에는 새 주문이 대기 중일 때마다 대기 배지가 표시됩니다.
- 설정 > 카페테리아. 구성 영역입니다. 비즈니스 프로필(슬러그, 표시 이름, 로고, 헤더 이미지, 주소, 통화, 시간대), 프린터 설정, 층 관리, 선택 기능 토글을 포함합니다.
카페 개설
카페테리아를 처음 활성화하면 서버가 HandyCafe 라이선스를 자동으로 인증 토큰으로 사용합니다. 아무 것도 수동으로 붙여넣을 필요가 없습니다. 이후 프로비저닝 마법사가 네 가지 정보를 요청합니다.
- 슬러그.
handy.cafe/{slug}형태의 공개 URL이 됩니다. 허용 문자는 소문자, 숫자, 대시입니다. 슬러그 길이는 3자에서 62자까지입니다. 시스템은 실시간으로 사용 가능 여부를 확인하고 "admin", "api", "dashboard" 같은 예약 슬러그를 거부합니다. - 표시 이름. 고객 메뉴 상단에 표시되는 사람이 읽을 수 있는 이름입니다.
- 국가 및 통화. 메뉴 가격에 사용할 기본 통화입니다. 가격은 최소 단위(예: 센트)로 저장되며 구성된 통화 기호와 함께 표시됩니다.
- 시간대. 동적 준비 시간 계산, 주문의 타임스탬프, 정산 기록에 사용됩니다.
프로비저닝이 완료되면 카페가 클라우드 데이터베이스에 생성되고 카페테리아 작업 공간이 열립니다. 이후 층, 테이블, 메뉴 항목을 추가할 수 있습니다.
비즈니스 프로필
비즈니스 프로필은 설정 > 카페테리아에서 언제든지 수정할 수 있습니다. 주요 항목은 다음과 같습니다.
| 필드 | 용도 |
|---|---|
| 슬러그 | 공개 URL의 일부입니다. 슬러그를 바꾸면 기존 QR 코드는 다시 생성할 때까지 작동하지 않습니다. |
| 표시 이름 | 고객 메뉴 상단에 표시됩니다. |
| 로고 | 정사각형 이미지입니다. WebP 형식, 2 MB 이하를 권장합니다. |
| 헤더 이미지 | 고객 메뉴 상단의 가로형 배너 이미지입니다. WebP 형식, 2 MB 이하를 권장합니다. |
| 주소 및 전화번호 | 선택 사항입니다. 메뉴 푸터에 표시됩니다. |
| 통화 | 메뉴의 모든 상품 가격에 적용됩니다. |
| 국가 | 세금 및 지역 기본값에 사용됩니다. |
| 시간대 | 주문 및 정산 타임스탬프에 적용됩니다. |
| 메뉴에 준비 시간 표시 | 토글입니다. 켜면 각 상품에 예상 준비 시간 칩이 표시됩니다. |
프린터 설정
프린터 섹션에는 다음 구성을 입력할 수 있습니다.
- 종류. Disabled 또는 TCP입니다. USB 직접 인쇄는 이 릴리스에서 지원하지 않습니다.
- IP 및 포트. 영수증 프린터의 네트워크 주소입니다. 대부분의 ESC POS TCP 프린터는 9100번 포트에서 수신합니다.
- 자동 절단. 인쇄할 때마다 용지 절단 명령을 추가합니다.
- 새 주문 시 자동 인쇄. 켜면 새 주문이 들어올 때마다 자동으로 영수증을 인쇄합니다.
- 알림음. 새 주문이 도착할 때 데스크톱 알림 외에 오디오 알림도 재생합니다.
- 테스트 인쇄. 연결을 확인하기 위해 샘플 영수증을 구성된 프린터로 보냅니다.
아키텍처 요약
카페테리아는 클라우드 우선 데이터 모델을 사용합니다. 모든 테이블, 카테고리, 상품, 주문, 정산 기록은 handy.cafe 클라우드 데이터베이스에 저장됩니다. 로컬 HandyCafe 서버는 이 상태를 미러링하고, 새 활동을 확인하기 위해 3초마다 Orders 엔드포인트를 폴링합니다. 고객용 페이지는 handy.cafe 클라우드에서 직접 제공되며, 인터넷에서 서버가 직접 노출되어 있을 필요는 없습니다.
데이터가 클라우드에 있으므로:
- 서버가 오프라인이어도 QR 코드는 계속 작동하지만, 연결이 복구될 때까지 직원은 대시보드에서 주문을 볼 수 없습니다.
- 메뉴 변경 사항은 저장 후 몇 초 안에 handy.cafe에 반영됩니다.
- 고객이 넣은 주문은 다음 3초 폴링 후 Orders 대시보드에 도착합니다.