대시보드
HandyCafe 서버 대시보드는 인터넷 카페나 게임 센터를 관리하는 중심 허브입니다. 로그인 후, 시스템의 모든 페이지를 로드하는 라우터 역할을 하는 메인 페이지로 이동합니다. 모든 탐색, 모니터링, 관리 작업은 여기서 시작됩니다.
레이아웃 개요
대시보드는 네 개의 영역으로 나뉩니다:
- 상단 패널. 창 상단에 가로로 위치한 헤더 바입니다. HandyCafe 브랜드 이름과 현재 활성 페이지의 제목을 표시합니다.
- 사이드바 툴바. 왼쪽에 위치한 세로 탐색 바입니다. 각 항목은 다른 페이지로 전환하는 아이콘 버튼입니다. 활성 페이지는 시각적으로 강조 표시됩니다.
- 콘텐츠 영역. 사이드바 오른쪽의 주요 작업 공간입니다. 현재 선택된 페이지(관리 패널, 멤버, 보고서 등)를 렌더링합니다.
- 상태 바. 창 하단에 위치한 선택적 푸터 바입니다. 보기 설정에서 표시하거나 숨길 수 있습니다.
사이드바 탐색
사이드바 툴바는 시스템의 모든 페이지에 빠르게 접근할 수 있도록 합니다. 각 항목은 아이콘을 표시하며, 마우스를 올리면 페이지 이름이 나타납니다. 다음 페이지들이 제공됩니다:
| 페이지 | 아이콘 | 설명 |
|---|---|---|
| 컴퓨터 (관리 패널) | 모니터 | 모든 클라이언트 PC를 모니터링하고 관리합니다 |
| 콘솔 | 게임패드 | 게임 콘솔 세션을 관리합니다 |
| 라이선스 | 인증서 | 소프트웨어 라이선스를 보고 관리합니다 |
| 멤버 | 계정 | 멤버 계정을 생성하고 관리합니다 |
| 요청 | 계정 질문 | 보류 중인 로그인 및 OAuth 요청을 검토합니다 |
| 주문 | 장바구니 | 음식, 음료 및 제품 주문을 관리합니다 |
| 지출 | 현금 마이너스 | 사업 지출을 기록하고 추적합니다 |
| 로그 | 문서 | 시스템 및 감사 로그를 탐색합니다 |
| 보고서 | 차트 라인 | 금전 등록기 및 교대 보고서를 봅니다 |
| 통계 | 차트 박스 | 수익, 세션 및 멤버 통계를 분석합니다 |
| 설정 | 톱니바퀴 | 모든 시스템 설정을 구성합니다 |
설정 페이지는 사이드바 하단의 별도 톱니바퀴 아이콘을 통해 접근하며, 주요 탐색 항목과는 구분됩니다.
열린 주문 배지
주문 탐색 항목은 현재 열려 있는(미완료) 주문 수를 표시하는 배지를 보여줍니다. 이 수치는 주문이 생성되거나 완료될 때마다 실시간으로 업데이트되어, 캐셔가 즉시 미처리 작업이 있는지 확인할 수 있습니다.
역할 기반 페이지 접근
모든 사용자가 동일한 사이드바를 보는 것은 아닙니다. 페이지 가시성은 로그인한 캐셔의 역할과 권한에 따라 달라집니다:
- 관리자 계정(최초 설정 마법사에서 생성됨)은 모든 페이지에 대한 무제한 접근 권한을 가집니다.
- 캐셔 계정은 특정 권한 플래그가 있는 역할이 할당됩니다. 캐셔의 역할이 특정 페이지에 대한 접근 권한을 부여하지 않으면, 해당 페이지는 사이드바에서 숨겨집니다.
- 캐셔가 로그인하면, 시스템은 그들의 역할 권한을 확인하고, 제한된 페이지에 있을 경우 자동으로 첫 번째 접근 가능한 페이지로 리디렉션합니다.
역할 및 권한에 대한 자세한 내용은 캐셔 역할 및 권한을 참조하세요.
자동 업데이트 확인
시작 시, 대시보드는 사용 가능한 소프트웨어 업데이트를 확인합니다. HandyCafe 서버의 최신 버전이 있는 경우, 화면 오른쪽 상단에 지속적인 알림이 나타납니다. 알림은 새 버전 번호를 표시하고 업데이트를 다운로드 및 설치할 옵션을 제공합니다.
이 확인은 조용히 실행됩니다. 업데이트가 없거나 업데이트 엔드포인트에 접근할 수 없는 경우, 알림이 표시되지 않습니다.
라이선스 하트비트
대시보드가 로드된 후, 라이선스 하트비트 프로세스가 백그라운드에서 시작됩니다. 이 프로세스는 주기적으로 HandyCafe 라이선스를 라이선스 서버와 검증합니다. 라이선스가 만료되거나 문제가 발생하면, 베타 라이선스 오버레이가 대시보드 위에 나타나 라이선스가 해결될 때까지 애플리케이션을 읽기 전용 모드로 제한할 수 있습니다.
라이선스 관리에 대한 자세한 내용은 라이선스를 참조하세요.
상태 바
상태 바는 대시보드 하단에 위치한 얇은 가로 바입니다. 애플리케이션의 현재 상태에 대한 컨텍스트 정보를 표시합니다. 가시성은 설정으로 제어됩니다:
- 상태 바를 표시하거나 숨기려면: 설정으로 이동하여 보기 섹션에서 상태 바 옵션을 토글하세요.
숨겨진 경우, 콘텐츠 영역이 창의 전체 높이를 채우도록 확장됩니다.
부트스트랩 시퀀스
성공적인 로그인 후 대시보드가 로드되면, 여러 초기화 단계가 자동으로 진행됩니다:
- 시스템 설정이 데이터베이스에서 로드됩니다.
- 저장된 세션이 복원됩니다(재시작 전 실행 중이었던 경우).
- 서버 소켓이 클라이언트 연결을 수신 대기 시작합니다.
- 네트워크 핑 요청이 전송되어 연결된 클라이언트를 검색합니다.
- 캐셔의 역할 권한이 로드되고 제한된 페이지가 숨겨집니다.
- 베타 라이선스 상태가 확인됩니다.
- 라이선스 하트비트 타이머가 시작됩니다.
- 툴바 배지를 위한 열린 주문 수가 초기화됩니다.
- 자동 업데이트 확인이 백그라운드에서 실행됩니다.
이 모든 단계는 비차단 방식으로 진행됩니다. 개별 단계가 실패하더라도 대시보드는 계속 작동합니다. 실패는 콘솔에 기록되지만 시스템 사용을 방해하지 않습니다.
시스템 폰트
대시보드는 설정 > 일반에서 구성된 시스템 폰트 설정을 따릅니다. 인터페이스 전반의 모든 텍스트는 선택된 폰트 패밀리를 사용합니다.