HandyCafe Docs
owner cashier it-admin

Soalan Lazim

Pemasangan dan Pemasangan

Apakah jenis perniagaan yang disokong oleh HandyCafe?

HandyCafe direka untuk kafe internet, pusat permainan, arena esports, kafe siber, dan PC bang. Mana-mana perniagaan yang menyediakan akses berjadual kepada PC atau konsol permainan boleh menggunakan HandyCafe untuk menguruskan sesi, pengebilan, dan keahlian.

Apakah keperluan sistem untuk HandyCafe Server?

Server memerlukan Windows 10 atau lebih baru (64-bit), sekurang-kurangnya 4 GB RAM, 500 MB ruang cakera, dan sambungan rangkaian tempatan. PC klien memerlukan Windows 10 atau lebih baru dengan 2 GB RAM. Semua PC mesti berada dalam LAN yang sama. Lihat Keperluan Sistem untuk maklumat lanjut.

Bagaimana cara memasang HandyCafe Server?

Muat turun pemasang dari laman web rasmi, jalankan, dan ikuti arahan. Pada pelancaran pertama, Wizard Pemasangan Pertama akan membuat akaun admin anda. Lihat Pemasangan Server untuk arahan langkah demi langkah.

Bagaimana cara menyambungkan PC klien ke server?

Pasang HandyCafe Client pada PC. Ia menggunakan mDNS untuk mencari server secara automatik dalam rangkaian tempatan. Jika penemuan automatik gagal, masukkan alamat IP server secara manual dalam tetapan klien. Lihat Pemasangan Klien.

Kenapa klien saya tidak menyambung ke server?

Punca biasa: server tidak berjalan, PC berada dalam subnet yang berbeza, firewall menyekat port (TCP 5001, 5002, 5003 dan UDP 5004), atau kunci sambungan tidak sepadan. Lihat Penyelesaian Masalah untuk penyelesaian terperinci.

Port apa yang digunakan oleh HandyCafe?

TCP 5001 (arahan), TCP 5002 (pemindahan fail), TCP 5003 (pengurusan jauh), UDP 5004 (penstriman skrin). Ini boleh dikonfigurasi dalam Tetapan Rangkaian.

Bagaimana cara mengaktifkan lesen saya?

Masukkan kunci lesen anda dalam panel lesen. Server mengesahkannya dengan server pelesenan. Sambungan internet aktif diperlukan untuk pengaktifan awal. Lihat Pelesenan.

Apa yang berlaku apabila server saya offline lebih dari 72 jam?

HandyCafe mempunyai tempoh kelonggaran offline selama 72 jam. Dalam tempoh ini, semua ciri berfungsi seperti biasa. Selepas 72 jam tanpa sambungan ke server pelesenan, server akan memasuki keadaan terkunci sehingga akses internet dipulihkan.


Sesi dan Harga

Bagaimana cara memulakan sesi pada PC?

Dalam Panel Admin, pilih PC yang tidak digunakan (sian) dan klik Start pada kad. Pilih mod prabayar atau pascabayar, secara opsional tetapkan ahli, tetapkan tempoh/jumlah jika prabayar, pilih kaedah pembayaran, dan sahkan. Lihat Sesi.

Apakah perbezaan antara sesi prabayar dan pascabayar?

Dalam mod pascabayar, pelanggan membayar pada akhir berdasarkan masa penggunaan sebenar. Dalam mod prabayar, pelanggan membayar terlebih dahulu untuk tempoh atau jumlah tetap. Prabayar menyokong dua sub-mod: Lock at Purchase (kos dibekukan pada permulaan) dan Live Schedule (kos disesuaikan dengan perubahan slot masa). Lihat Sesi.

Bagaimana jadual harga berfungsi?

Jadual harga adalah grid 7 hari x 24 jam di mana setiap blok masa diberikan kepada slot harga berwarna. Setiap slot mempunyai pengganda (contohnya, 1.0x standard, 1.5x puncak, 0.5x luar puncak). Kos sesi dikira sebagai: kadar asas setiap jam didarabkan dengan pengganda slot didarabkan dengan tempoh. Lihat Harga Sesi.

Bagaimana cara menetapkan harga yang berbeza untuk hujung minggu berbanding hari kerja?

Dalam Tetapan > Jadual Harga, buat slot harga dengan pengganda yang berbeza (contohnya, "Hari Kerja" pada 1.0x, "Hujung Minggu" pada 1.3x). Warnakan lajur hujung minggu dengan warna slot Hujung Minggu dan lajur hari kerja dengan warna slot Hari Kerja. Lihat Tetapan Jadual Harga.

Bagaimana cara menjeda dan menyambung semula sesi?

Klik Pause pada kad PC dalam talian. Pengebilan berhenti semasa dijeda. Untuk menyambung semula, klik Resume pada kad PC yang dijeda. Segmen harga baru bermula apabila disambung semula. Lihat Sesi.

Bagaimana cara menambah masa tambahan pada sesi aktif?

Klik Add Time pada kad PC dalam talian. Masukkan bilangan minit untuk ditambah (positif untuk melanjutkan, negatif untuk mengurangkan). Rekod transaksi dibuat untuk pelarasan tersebut.

Apa yang berlaku apabila sesi merangkumi beberapa slot harga?

Sesi secara automatik dibahagikan kepada segmen pada sempadan slot. Setiap segmen menggunakan pengganda yang aktif semasa tempoh tersebut. Jumlah kos adalah jumlah semua kos segmen. Lihat Harga Sesi.

Apakah yuran permulaan?

Yuran permulaan adalah caj minimum yang dikenakan kepada setiap sesi. Walaupun sesi sangat singkat, pelanggan dikenakan sekurang-kurangnya jumlah ini. Konfigurasikannya dalam Tetapan Harga.


Ahli dan Kesetiaan

Bagaimana cara membuat ahli baru?

Navigasi ke halaman Ahli dan klik Add Member. Masukkan nama pengguna, nama paparan, email opsional, telefon, dan butiran lain. Tetapkan tahap jika berkenaan. Lihat Ahli.

Bagaimana sistem dompet berfungsi?

Setiap ahli mempunyai baki dompet. Apabila anda menambah nilai dompet, satu kredit dompet dibuat dengan jumlah tertentu dan jenis kredit (dibayar, bonus, manual, dll.). Semasa sesi, dompet digunakan secara automatik. Kredit boleh mempunyai tarikh luput dan sekatan peranti. Lihat Dompet Ahli.

Apakah kredit dompet?

Kredit dompet adalah entri diskret baki dompet yang dibuat oleh satu tambah nilai. Setiap kredit menjejaki jumlahnya sendiri, jenis kredit (dibayar, bonus, manual), status (aktif, luput, digunakan), dan sekatan peranti yang layak. Kredit digunakan mengikut urutan (paling lama dahulu). Lihat Dompet Ahli.

Bagaimana tahap kesetiaan dan mata berfungsi?

Ahli memperoleh mata melalui aktiviti (perbelanjaan, lawatan, tambah nilai, pesanan). Setiap tahap mempunyai ambang mata. Apabila ahli mengumpulkan mata yang mencukupi, mereka maju ke tahap seterusnya. Tahap yang lebih tinggi boleh mempunyai kadar diskaun yang lebih baik. Lihat Tahap Kesetiaan.

Bagaimana cara menambah nilai dompet ahli?

Pilih ahli dalam halaman Ahli, klik pilihan pembayaran/tambah nilai, masukkan jumlah, pilih jenis kredit dan kaedah pembayaran, dan sahkan. Kredit dompet baru dibuat. Lihat Dompet Ahli.

Bolehkah ahli menggunakan baki dompet mereka untuk kedua-dua PC dan konsol?

Ia bergantung pada sekatan peranti kredit. Kredit boleh dihadkan kepada "PC sahaja", "konsol sahaja", atau "kedua-duanya". Apabila membeli pakej, sekatan peranti ditentukan oleh konfigurasi pakej. Lihat Pakej.

Apa yang berlaku apabila kredit dompet luput?

Apabila kredit mencapai tarikh luputnya, statusnya berubah menjadi "luput" dan baki yang tinggal tidak lagi tersedia untuk digunakan. Jumlah yang luput dicatat dalam sejarah transaksi ahli.

Bagaimana cara melihat sejarah transaksi ahli?

Pilih ahli dalam halaman Ahli. Panel butiran ahli menunjukkan lejar transaksi dengan semua muatan dompet, perbelanjaan, bayaran balik, dan pelarasan dengan cap waktu dan jumlah.


Produk, Pesanan, dan Inventori

Bagaimana cara menambah produk ke katalog?

Navigasi ke Produk dan klik Add Product. Masukkan nama, kategori, unit, kod bar, harga jualan, harga kos, dan kadar VAT. Tukar aktif/tidak aktif. Lihat Produk.

Bagaimana cara membuat pesanan untuk pelanggan?

Navigasi ke Pesanan, klik New Order, secara opsional tetapkan kepada PC atau tambah nota, tambah item dari katalog produk dengan kuantiti, kemudian tutup pesanan dengan kaedah pembayaran. Lihat Pesanan.

Bagaimana cara membatalkan atau memulangkan pesanan?

Buka pesanan dari halaman Pesanan dan klik Cancel. Pesanan dibatalkan dan tiada pembayaran direkodkan. Untuk bayaran balik pada pesanan yang ditutup, gunakan aliran kerja bayaran balik yang sesuai.

Bagaimana penjejakan stok berfungsi?

Setiap produk mempunyai tahap stok. Log stok menjejaki perubahan dengan sebab: jualan (dikurangkan secara automatik pada penutupan pesanan), pembelian (dari entri inventori), pelarasan, pembaziran, dan pemulangan. Lihat Produk dan Inventori.


Kempen dan Pakej

Bagaimana cara membuat kempen?

Navigasi ke Kempen dan klik Add Campaign. Masukkan nama, deskripsi, tetapkan sebagai aktif, dan konfigurasikan tarikh luput jika berkenaan. Kemudian tambah pakej ke kempen. Lihat Kempen.

Apakah perbezaan antara pakej berasaskan minit dan berasaskan wang?

Pakej berasaskan minit memberikan ahli masa (minit) yang boleh digunakan untuk sesi. Pakej berasaskan wang menambah dana ke dompet ahli. Kedua-duanya boleh termasuk jumlah bonus. Lihat Pakej.

Bagaimana sistem bonus dalam pakej berfungsi?

Satu pakej boleh termasuk bonus di atas hak asas. Sebagai contoh, satu pakej mungkin menawarkan "60 minit + 15 minit bonus" atau "$10 + $2 bonus". Bonus mencipta entri kredit berasingan yang ditandai dengan jenis kredit "Bonus".

Bagaimana sekatan peranti berfungsi pada pakej?

Setiap pakej menentukan sekatan peranti: klien (PC), konsol (konsol), kedua-duanya, PC sahaja, atau konsol sahaja. Apabila pakej dibeli, kredit dompet/masa yang dibuat mewarisi sekatan ini dan hanya boleh digunakan pada jenis peranti yang sepadan.


Pengurusan Juruwang

Bagaimana cara membuat akaun juruwang?

Navigasi ke Pengurusan > Juruwang. Klik Tambah Juruwang, masukkan nama pengguna dan kata laluan, dan tetapkan peranan. Juruwang kemudian boleh log masuk dengan kelayakan ini. Lihat Peranan Juruwang.

Bagaimana cara menetapkan kebenaran untuk peranan juruwang?

Navigasi ke Pengurusan > Peranan Juruwang. Buat peranan baru atau edit yang sedia ada. Tandakan atau hapus tanda bendera kebenaran individu dalam setiap 6 kategori (Pengesahan, Ahli, Konsol, Log, Laporan, Kaedah Pembayaran). Lihat Peranan Juruwang.

Apakah 6 kategori kebenaran?

Pengesahan (1 bendera), Ahli (6 bendera: lihat, tambah, hapus, kemas kini, tunjuk email, tunjuk telefon), Konsol (4 bendera: lihat, tambah, hapus, kemas kini), Log (4 bendera: lihat, sejarah penuh, hari ini sahaja, hapus), Laporan (3 bendera: lihat, sejarah penuh, hari ini sahaja), Kaedah Pembayaran (4 bendera: urus, tambah, hapus, kemas kini). Jumlah: 22 bendera kebenaran individu.

Bagaimana perlindungan brute-force berfungsi pada log masuk juruwang?

Selepas 5 percubaan log masuk yang gagal dalam masa 10 minit, akaun dikunci selama 15 minit. Semua percubaan yang gagal direkodkan dalam jejak audit dengan amaran keselamatan.

Bagaimana cara melihat laporan syif juruwang?

Buka halaman Laporan Tunai. Tapis mengikut nama juruwang untuk melihat transaksi yang diproses oleh juruwang tertentu semasa syif mereka. Ringkasan syif menunjukkan jumlah dan pecahan mengikut kaedah pembayaran.


Tetapan dan Konfigurasi

Bagaimana cara menukar bahasa?

Navigasi ke Tetapan > Umum dan pilih bahasa anda dari dropdown. HandyCafe menyokong 24 bahasa. Antara muka dikemas kini serta-merta. Lihat Tetapan Umum.

Bagaimana cara menyediakan log masuk Google OAuth?

Navigasi ke Tetapan > OAuth. Aktifkan OAuth secara global, kemudian aktifkan Google. Masukkan Google Client ID dan Client Secret anda (dari Google Cloud Console). Secara opsional import fail kredensial JSON. Uji dengan memulakan log masuk OAuth dari PC klien. Lihat Tetapan OAuth.

Bagaimana cara mengkonfigurasi grid jadual harga?

Navigasi ke Tetapan > Jadual Harga. Aktifkan jadual, buat slot berwarna dengan pengganda, kemudian klik/seret pada grid 7x24 jam untuk mewarnakan blok masa dengan slot yang diingini. Lihat Tetapan Jadual Harga.

Bagaimana cara menyesuaikan skrin idle klien?

Navigasi ke Tetapan > Klien > tab Skrin Idle. Aktifkan tayangan slaid, tambah imej atau video, tetapkan tempoh dan peralihan. Secara opsional aktifkan overlay jam dan nama kafe. Lihat Skrin Idle Klien.

Bagaimana cara menukar tema penampilan klien?

Navigasi ke Tetapan > Klien > tab Penampilan. Pilih tema (Neon Arena, Crimson Pulse, Emerald Depth), pilih preset susun atur, dan konfigurasikan latar belakang, ketumpatan kad, dan efek. Lihat Penampilan Klien.

Bagaimana cara menyediakan notifikasi bunyi?

Navigasi ke Tetapan > Bunyi. Aktifkan togol bunyi utama, kemudian pilih bunyi untuk setiap acara (Panggil Juruwang, Pesanan Baru, Tamat Sesi, Permintaan Log Masuk) dari 15 pilihan terbina dalam. Lihat Tetapan Bunyi.

Apakah kunci sambungan dan mengapa ia penting?

Kunci sambungan adalah rahsia bersama yang digunakan untuk pengesahan kriptografi antara server dan klien. Ia menghalang peranti yang tidak sah daripada menyambung ke server anda. Semua klien mesti menggunakan kunci yang sama seperti server. Konfigurasikannya dalam Tetapan Rangkaian.


Pengurusan Jauh

Bagaimana cara mengambil tangkapan skrin jauh dari PC klien?

Pilih klien dalam Panel Admin dan klik Screenshot pada kad. Penonton tangkapan skrin memaparkan imej yang ditangkap. Anda boleh menyegarkan untuk tangkapan baru atau memuat turun imej tersebut. Lihat Tangkapan Skrin.

Bagaimana cara menggunakan desktop jauh untuk mengawal PC klien?

Pilih kad klien dan klik Remote Desktop. Satu tetingkap dibuka dengan penstriman video H.264 secara langsung. Anda boleh mengawal tetikus dan papan kekunci dari jauh dan penyelarasan papan klip berfungsi antara server dan klien. Lihat Desktop Jauh.

Bagaimana sistem penyelarasan fail berfungsi?

Konfigurasikan direktori untuk diselaraskan dalam Tetapan > Sync Explorer. Apabila dicetuskan, server mencipta manifest fail. Klien membandingkan manifest dengan fail tempatan dan memuat turun hanya fail yang berubah atau baru menggunakan pemindahan berasaskan chunk. Lihat Penyelarasan Fail.

Bagaimana cara melihat aplikasi apa yang sedang berjalan pada PC klien?

Pilih klien dalam Panel Admin dan klik Running Apps pada kad. Satu panel menunjukkan semua proses yang sedang berjalan dengan nama dan butiran. Anda juga boleh melihat Startup Apps, Installed Apps, dan Windowed Apps dari butang tindakan yang sama.

Bagaimana cara menghantar mesej kepada PC klien?

Pilih kad klien dan klik Send Message. Taip mesej anda dan sahkan. Mesej muncul di skrin pelanggan.

Bagaimana cara mematikan atau memulakan semula PC klien dari jauh?

Pilih kad klien dan klik Shutdown atau Reboot. Anda juga boleh memilih berbilang klien untuk operasi pukal. Wake on LAN tersedia untuk menghidupkan PC offline yang menyokongnya.


Laporan dan Analitik

Bagaimana cara melihat laporan tunai?

Navigasi ke Laporan Tunai dari bar sisi. Laporan menunjukkan kad ringkasan, sejarah transaksi, pendapatan peranti, dan carta. Gunakan penapis tarikh untuk mengecilkan julat masa. Lihat Laporan Tunai.

Bagaimana cara mengeksport data laporan?

Dalam Laporan Tunai, gunakan fungsi eksport/salin untuk menyalin data transaksi ke papan klip anda dalam format CSV. Anda kemudian boleh menampalnya ke dalam Excel atau mana-mana aplikasi spreadsheet.

Apakah analitik yang tersedia di halaman Statistik?

Sembilan tab analitik: Trend pendapatan, Analitik jualan, Penjejakan perbelanjaan, Statistik sesi, Penggunaan konsol, Penggunaan aplikasi, Kadar penggunaan komputer, Aktiviti ahli, dan Prestasi juruwang. Lihat Statistik.

Bagaimana cara memeriksa kadar penggunaan komputer?

Navigasi ke Statistik > tab Penggunaan Komputer. Ini menunjukkan peratusan penggunaan per-PC, masa operasi, dan pendapatan per mesin. Ia juga mengenal pasti PC anda yang paling sibuk. Lihat Statistik Sesi & Komputer.


Penyelesaian Masalah

Klien menunjukkan "offline" tetapi PC dihidupkan. Apa yang perlu saya lakukan?

Periksa bahawa: 1) HandyCafe Client berjalan pada PC, 2) Kedua-dua PC berada dalam rangkaian/subnet yang sama, 3) Firewall membenarkan port TCP 5001-5003, 4) Kunci sambungan sepadan antara server dan klien. Lihat Penyelesaian Masalah.

Harga sesi nampaknya tidak betul. Bagaimana cara saya mengesahkan?

Periksa tetapan harga (Tetapan > Harga) untuk kadar asas setiap jam dan VAT. Periksa jadual harga (Tetapan > Jadual Harga) untuk pengganda aktif pada masa sesi. Semak segmen harga sesi dalam butiran transaksi untuk melihat bagaimana setiap segmen dikira.

Log masuk OAuth tersekat pada "pending." Bagaimana cara menyelesaikannya?

Pastikan admin telah meluluskan permintaan pada halaman Permintaan. Jika permintaan tersekat, periksa: 1) Kredensial penyedia OAuth adalah betul dalam Tetapan > OAuth, 2) Server mempunyai akses internet untuk mencapai API penyedia, 3) Kod peranti belum luput (biasanya luput dalam 15-30 minit).

Desktop jauh lambat. Bagaimana cara meningkatkan prestasi?

Turunkan bitrate dalam tetapan aliran (cuba 1000-2000 kbps untuk LAN). Periksa lebar jalur rangkaian antara server dan klien. Pastikan port UDP 5004 tidak disekat. Gunakan Ethernet berwayar dan bukannya WiFi untuk hasil terbaik.

Lesen saya menunjukkan "over_limit." Apa maksudnya?

Lebih banyak PC klien disambungkan daripada yang dibenarkan oleh lesen anda. Putuskan sambungan klien yang tidak digunakan atau tingkatkan lesen anda. Server tidak akan memulakan sesi baru sehingga bilangan klien yang disambungkan berada pada atau di bawah had.

Seorang juruwang terkunci selepas terlalu banyak percubaan log masuk yang gagal. Bagaimana cara membuka kunci?

Tunggu 15 minit untuk kunci automatik tamat. Jika mendesak, admin boleh menguruskan akaun juruwang melalui antara muka pengurusan.


Kafeteria

Bagaimana pelanggan membuat pesanan dari meja mereka?

Mereka mengimbas kod QR di meja dengan telefon mereka, masukkan kod keselamatan 6 digit yang diberikan kepada mereka oleh staf, semak menu dalam bahasa mereka sendiri, tambah item ke troli, dan hantar dengan pembayaran Tunai atau Online (Stripe). Pesanan muncul di papan pemuka Pesanan Kafeteria anda dalam masa 3 saat. Lihat Menu Pelanggan.

Bagaimana cara mengaktifkan modul Kafeteria?

Buka Tetapan > Kafeteria dan togol Aktifkan Kafeteria. Server menggunakan lesen HandyCafe anda sebagai kebenaran secara automatik. Wizard penyediaan meminta slug anda, nama paparan, negara, mata wang, dan zon waktu. Lihat Gambaran Keseluruhan Kafeteria dan Cara Menyediakan Kafeteria.

Bahasa apa yang disokong oleh menu pelanggan?

Menu pelanggan di handy.cafe/{slug} menyokong 24 bahasa. Lawatan pertama memilih padanan terbaik dari header Accept-Language pelayar. Pelanggan boleh menukar bahasa bila-bila masa dengan pemilih di atas.

Adakah Kafeteria berfungsi tanpa internet?

Tidak. Kafeteria adalah berasaskan awan. Penyediaan, penyelarasan menu, dan pengundian pesanan semuanya memerlukan akses internet keluar. Halaman yang berhadapan dengan pelanggan disajikan oleh awan dan tidak bergantung pada server tempatan anda yang boleh dicapai dari internet.


Klien Warisan

Adakah HandyCafe menyokong klien V3 atau V4 lama saya?

Ya. Aktifkan sokongan runtime dalam Tetapan > Klien Warisan dan server memulakan pendengar pada port warisan asal (UDP 710/711, TCP 712, pemindahan fail 717). Klien sedia ada anda menyambung tanpa sebarang perubahan pada pihak mereka. Mereka muncul dalam Panel Admin dengan set tindakan yang dikurangkan (Login, Logout, Add Time, Screenshot, Logoff, Reboot, Shutdown). Lihat Klien Warisan.

Bolehkah klien warisan dan moden berjalan pada server yang sama pada masa yang sama?

Ya. Dua tumpukan protokol menggunakan port yang berbeza dan tidak bertembung. Anda boleh mencampurkan klien lama dan baru pada LAN yang sama dan menguruskannya dari Panel Admin yang sama.

Bolehkah saya membawa data saya dari pemasangan HandyCafe yang lebih lama?

Ya, pada Windows. Buka Tetapan > Klien Warisan, tatal ke Migrasi Pangkalan Data, dan klik Mula Migrasi. Ahli, harga, produk, pesanan, transaksi, dan log diimport. Fail asal tidak diubah atau dipadamkan. Jika hasilnya tidak seperti yang anda harapkan, klik Batalkan Migrasi untuk mengembalikan semula. Lihat Cara Berpindah dari Pemasangan Warisan.

Apakah perbezaan antara varian protokol STE dan Standard?

Bingkai STE (Smart/Turbo Edition) termasuk awalan info lesen 70-byte; saiz bingkai adalah 1337 byte. Bingkai Standard tidak termasuk awalan; saiz bingkai adalah 1267 byte. Pilih varian yang sepadan dengan cara server warisan anda dibina. Memilih varian yang salah menyebabkan bingkai terjatuh atau salah dibaca.