HandyCafe Docs
owner it-admin cashier

카페 매니저 웹

카페 매니저 웹은 handycafe.app 에서 제공하는 반응형 브라우저 관리 화면입니다. 보안 클라우드 릴레이를 통해 HandyCafe 서버에 연결하므로, 사장님과 권한을 받은 운영자는 로컬 서버를 인터넷에 직접 노출하지 않고도 카페를 모니터링하고 관리할 수 있습니다.

할 수 있는 일

  • 컴퓨터와 세션의 실시간 상태, 현재 시간대 매출, 오늘의 매출, 오늘의 평균 세션 시간을 모니터링합니다.
  • 콘솔이나 회원을 검색하고, 오프라인, 일시 중지, 유지보수, 사용 중, 사용 가능 상태별로 콘솔을 필터링합니다.
  • 게스트 세션을 시작하고, 세션을 종료하거나 잠그거나 잠금 해제하며, 세션 시간을 추가하고, PC를 재시작하거나 종료하고, 실행 중인 애플리케이션을 확인하며, 카페 전체에 공지를 보냅니다.
  • 회원을 검색하고, 잔액과 최근 내역을 확인하며, 지갑 크레딧을 충전하고, 플레이 시간을 부여합니다.
  • 선택한 기간의 매출 구성, 일별 매출, 가동률, 시간대별 활동을 확인합니다.
  • 작업, 대상, 안전하게 요약된 매개변수, 운영자, 결과, 오류, 시각이 담긴 원격 활동 기록을 확인합니다.

레이아웃에는 휴대폰용 하단 내비게이션, 터치에 맞춘 조작 요소, 넓은 표 대신 사용하는 반응형 카드, 다크 모드, 모바일 뷰포트 변화에 대한 안전한 처리가 포함됩니다.

연결 상태

하단 상태 영역은 서로 독립적인 두 가지 상태를 표시합니다.

  • 클라우드 채널은 브라우저와 HandyCafe 클라우드 사이의 연결입니다.
  • 카페 서버는 클라우드에서 데스크톱 서버로 이어지는 실시간 명령 릴레이입니다.

클라우드 채널이 연결되었다고 해서 카페 서버가 온라인이라는 뜻은 아닙니다. 카페 서버 릴레이를 사용할 수 없으면 원격 명령은 비활성화되거나 거부됩니다. 대시보드는 마지막으로 확인된 스냅샷을 계속 표시할 수 있으며, 이 경우 실시간 데이터로 보여 주는 대신 오래된 데이터임을 명시합니다.

보안 및 안정성

로그인은 HandyCafe 계정 세션을 사용합니다. 카페 요청마다 소유권과 클라우드 이용 권한을 확인합니다. 원격 쓰기 작업에는 요청 빈도 제한, 입력값 검증, 필수 멱등성 키, 감사 기록이 적용됩니다. 같은 키를 다른 매개변수로 재사용하면 거부됩니다. 브라우저에서 API로 보내는 요청에는 고정된 제한 시간이 있으며, WebSocket 티켓은 수명이 짧고 한 번만 사용할 수 있습니다.

회원 메모는 카페 서버로 전달되지만 원격 감사 매개변수 요약에서는 제외됩니다. 비밀번호, 세션 토큰, 원본 인증 티켓은 활동 페이지에 절대 표시되지 않습니다.

요구 사항

  • 해당 카페를 소유하거나 카페에 대한 권한을 가진 HandyCafe 계정.
  • 활성 라이선스와 필요한 클라우드 이용 권한.
  • 클라우드 릴레이에 연결된 최신 HandyCafe 서버.

카페 서버가 오프라인이면 데스크톱 서버가 유효한 라이선스 상태를 갖추고 HandyCafe 클라우드에 다시 연결될 때까지 실시간 데이터와 원격 명령을 사용할 수 없습니다.