HandyCafe Docs
owner cashier it-admin

Dasbor

Dasbor HandyCafe Server adalah pusat utama untuk mengelola warnet atau pusat gaming Anda. Setelah masuk, Anda mendarat di MainPage, yang berfungsi sebagai router yang memuat setiap halaman lain dalam sistem. Semua tugas navigasi, pemantauan, dan manajemen dimulai dari sini.

Gambaran Tata Letak

Dasbor dibagi menjadi empat area:

  1. Panel Atas. Bilah header horizontal di bagian atas jendela. Menampilkan nama merek HandyCafe dan judul halaman yang sedang aktif.
  2. Bilah Alat Samping. Bilah navigasi vertikal di sisi kiri. Setiap item adalah tombol ikon yang beralih ke halaman berbeda. Halaman aktif disorot secara visual.
  3. Area Konten. Ruang kerja utama di sebelah kanan bilah samping. Area ini merender halaman yang saat ini dipilih (Panel Admin, Anggota, Laporan, dan seterusnya).
  4. Bilah Status. Bilah footer opsional di bagian bawah jendela. Anda dapat menampilkan atau menyembunyikannya dari pengaturan Tampilan.

Navigasi Bilah Samping

Bilah alat samping menyediakan akses cepat ke setiap halaman dalam sistem. Setiap entri menampilkan ikon dan, saat diarahkan kursor, nama halaman. Halaman berikut tersedia:

Halaman Ikon Deskripsi
Komputer (Panel Admin) Monitor Memantau dan mengelola semua PC klien
Konsol Gamepad Mengelola sesi konsol gaming
Lisensi Sertifikat Melihat dan mengelola lisensi perangkat lunak
Anggota Akun Membuat dan mengelola akun anggota
Permintaan Pertanyaan Akun Meninjau permintaan login dan OAuth yang tertunda
Pesanan Keranjang Mengelola pesanan makanan, minuman, dan produk
Pengeluaran Kas Minus Mencatat dan melacak pengeluaran bisnis
Log Dokumen Menelusuri log sistem dan audit
Laporan Grafik Garis Melihat laporan mesin kasir dan shift
Statistik Kotak Grafik Menganalisis statistik pendapatan, sesi, dan anggota
Pengaturan Roda Gigi Mengonfigurasi semua pengaturan sistem

Halaman Pengaturan diakses melalui ikon roda gigi terpisah di bagian bawah bilah samping, berbeda dari item navigasi utama.

Badge Pesanan Terbuka

Item navigasi Pesanan menampilkan badge yang menunjukkan jumlah pesanan yang saat ini terbuka (belum terpenuhi). Jumlah ini diperbarui secara real-time setiap kali pesanan dibuat atau ditutup sehingga kasir dapat langsung melihat apakah ada pekerjaan yang belum selesai.

Akses Halaman Berbasis Peran

Tidak setiap pengguna melihat bilah samping yang sama. Visibilitas halaman bergantung pada peran dan izin kasir yang masuk:

  • Akun admin (dibuat selama Wizard Pengaturan Awal) memiliki akses tanpa batas ke semua halaman.
  • Akun kasir ditetapkan peran dengan tanda izin tertentu. Jika peran kasir tidak memberikan akses ke halaman tertentu, halaman tersebut disembunyikan dari bilah samping mereka.
  • Saat kasir masuk, sistem memeriksa izin peran mereka dan secara otomatis mengalihkan mereka ke halaman pertama yang dapat diakses jika mereka saat ini berada di halaman yang dibatasi.

Untuk informasi lebih lanjut tentang peran dan izin, lihat Peran dan Izin Kasir.

Pemeriksaan Pembaruan Otomatis

Saat dimulai, dasbor memeriksa pembaruan perangkat lunak yang tersedia. Jika versi HandyCafe Server yang lebih baru tersedia, notifikasi persisten muncul di sudut kanan atas layar. Notifikasi menampilkan nomor versi baru dan menawarkan opsi untuk mengunduh dan menginstal pembaruan.

Pemeriksaan ini berjalan secara diam. Jika tidak ada pembaruan yang tersedia atau titik akhir pembaruan tidak dapat dijangkau, tidak ada notifikasi yang ditampilkan.

Heartbeat Lisensi

Setelah dasbor dimuat, proses heartbeat lisensi dimulai di latar belakang. Proses ini secara berkala memvalidasi lisensi HandyCafe Anda dengan server lisensi. Jika lisensi kedaluwarsa atau mengalami masalah, Overlay Lisensi Beta mungkin muncul di atas dasbor, membatasi aplikasi ke mode baca-saja hingga lisensi diselesaikan.

Lihat Lisensi untuk detail tentang manajemen lisensi.

Bilah Status

Bilah status adalah bilah horizontal tipis di bagian bawah dasbor. Menampilkan informasi kontekstual tentang status aplikasi saat ini. Visibilitasnya dikendalikan oleh pengaturan:

  • Untuk menampilkan atau menyembunyikan bilah status: Buka Pengaturan dan alihkan opsi Bilah Status di bagian Tampilan.

Saat disembunyikan, area konten meluas untuk mengisi tinggi penuh jendela.

Urutan Bootstrap

Saat dasbor dimuat setelah login berhasil, beberapa langkah inisialisasi terjadi secara otomatis:

  1. Pengaturan sistem dimuat dari database.
  2. Sesi yang tersimpan dipulihkan (jika ada yang berjalan sebelum restart).
  3. Socket server mulai mendengarkan koneksi klien.
  4. Permintaan ping jaringan dikirim untuk menemukan klien yang terhubung.
  5. Izin peran kasir dimuat dan halaman yang dibatasi disembunyikan.
  6. Status lisensi beta diperiksa.
  7. Penghitung waktu heartbeat lisensi dimulai.
  8. Jumlah pesanan terbuka diinisialisasi untuk badge bilah alat.
  9. Pemeriksaan pembaruan otomatis berjalan di latar belakang.

Semua langkah ini non-blocking. Jika langkah individual gagal, dasbor tetap berfungsi. Kegagalan dicatat ke konsol tetapi tidak mencegah Anda menggunakan sistem.

Font Sistem

Dasbor menghormati pengaturan font sistem yang dikonfigurasi di Pengaturan > Umum. Semua teks di seluruh antarmuka menggunakan keluarga font yang dipilih.


Langkah Selanjutnya