HandyCafe Docs
owner cashier it-admin

Penyelesaian Masalah

Halaman ini merangkumi penyelesaian untuk isu biasa yang disusun mengikut kategori.

Isu Sambungan

Klien tidak dapat menemui pelayan

Gejala: Klien menunjukkan "Mencari pelayan" atau "Pelayan tidak ditemui."

Penyelesaian:

  1. Sahkan HandyCafe Server sedang berjalan pada PC pengurusan.
  2. Sahkan kedua-dua PC berada pada subnet yang sama (cth. kedua-duanya pada 192.168.1.x).
  3. Semak bahawa mDNS tidak disekat oleh suis rangkaian atau penghala anda.
  4. Cuba sambungan manual: masukkan alamat IP pelayan terus dalam tetapan klien.
  5. Sahkan tiada perisian lain menggunakan port TCP pelayan (lalai: 5001).

Klien menyambung kemudian memutuskan sambungan serta-merta

Gejala: Klien menunjukkan "Disambungkan" seketika kemudian kembali ke "Mencari."

Penyelesaian:

  1. Sahkan kunci sambungan sepadan pada kedua-dua pelayan dan klien. Kunci ditetapkan dalam Tetapan > Rangkaian pada pelayan.
  2. Semak ketidakstabilan rangkaian (kehilangan paket, isu kabel).
  3. Pastikan pelayan belum mencapai had PC lesennya.
  4. Semak log pelayan untuk mesej kegagalan pengesahan.

Klien menunjukkan "Luar Talian" pada pelayan tetapi PC sedang berjalan

Gejala: PC klien dihidupkan dan aplikasi klien berjalan tetapi pelayan menunjukkannya sebagai luar talian.

Penyelesaian:

  1. Pada PC klien, sahkan HandyCafe Client benar-benar berjalan (semak dulang sistem).
  2. Semak sambungan rangkaian pada PC klien (bolehkah ia ping pelayan?).
  3. Sahkan peraturan firewall: port TCP 5001-5003 mesti dibuka pada kedua-dua pelayan dan klien.
  4. Mulakan semula HandyCafe Client pada PC yang terjejas.
  5. Jika menggunakan VLAN, pastikan VLAN pelayan dan klien boleh berkomunikasi.

Tidak dapat menyambung selepas menukar tetapan rangkaian

Gejala: Selepas menukar port atau kunci sambungan, klien tidak dapat menyambung.

Penyelesaian:

  1. Pastikan klien dikemas kini dengan nombor port dan kunci sambungan baharu.
  2. Mulakan semula HandyCafe Server selepas menukar tetapan rangkaian.
  3. Kemas kini peraturan firewall untuk membenarkan port baharu.
  4. Semua klien mesti dikonfigurasikan semula dengan nilai baharu.

Masalah Sesi

Tidak dapat memulakan sesi pada klien

Gejala: Butang Mula dinyahaktifkan atau tindakan mula gagal dengan ralat.

Penyelesaian:

  1. Semak status lesen. Jika dalam mod baca sahaja, sesi baharu tidak boleh dimulakan.
  2. Sahkan status klien ialah "Melahu". Sesi hanya boleh dimulakan pada klien yang melahu.
  3. Semak kebenaran juruwang. Peranan mesti mempunyai kebenaran AUTH_CLIENT_LOGIN.
  4. Pastikan harga dikonfigurasikan (Tetapan > Harga mesti mempunyai kadar sejam yang sah).

Pemasa sesi menunjukkan masa yang salah

Gejala: Masa yang dipaparkan tidak sepadan dengan masa sebenar yang telah berlalu.

Penyelesaian:

  1. Semak jam sistem pada kedua-dua PC pelayan dan klien. Ia perlu disegerakkan (gunakan NTP).
  2. Jika sesi dijeda, tempoh jeda tidak dikira.
  3. Untuk sesi prabayar, pemasa menunjukkan masa baki, bukan masa yang telah berlalu.

Kos sesi kelihatan salah

Gejala: Jumlah yang dicaj tidak sepadan dengan jangkaan.

Penyelesaian:

  1. Semak jadual harga. Jika diaktifkan, sesi mungkin telah melalui pelbagai slot harga dengan pengganda berbeza.
  2. Semak tetapan harga: kadar sejam asas, VAT, yuran permulaan, pembundaran.
  3. Semak segmen harga sesi dalam butiran transaksi untuk pecahan.
  4. Sahkan komisen dan yuran tetap kaedah pembayaran.
  5. Untuk sesi prabayar, semak sama ada mod "Kunci pada Pembelian" atau "Jadual Langsung" aktif.

Sesi yang dijeda tidak boleh disambung semula

Gejala: Tindakan sambung semula gagal atau tidak tersedia.

Penyelesaian:

  1. Sahkan PC klien masih disambungkan ke pelayan.
  2. Semak status klien menunjukkan "Dijeda" (oren).
  3. Jika klien memutuskan sambungan semasa jeda, ia mungkin perlu disambung semula dahulu.

Isu Pembayaran

Kaedah pembayaran tiada dari dropdown

Gejala: Kaedah pembayaran yang dijangka tidak muncul apabila menutup sesi atau pesanan.

Penyelesaian:

  1. Sahkan kaedah pembayaran wujud dalam Pengurusan > Kaedah Pembayaran.
  2. Semak bahawa kaedah pembayaran aktif (tidak dipadam atau dinyahaktifkan).
  3. Semak kebenaran juruwang. PAYMENT_MANAGE mesti diberikan untuk melihat semua kaedah.

Pengiraan komisen kelihatan salah

Gejala: Komisen yang dipotong tidak sepadan dengan kadar yang dijangka.

Penyelesaian:

  1. Sahkan kadar komisen kaedah pembayaran (sebagai peratusan) dan yuran tetap.
  2. Formula komisen: komisen = (jumlah dicaj * kadar komisen / 100) + yuran tetap.
  3. Semak jika juruwang menggunakan pengatasan manual ke jumlah yang dicaj.

Isu Paparan Klien

Skrin tunggu klien kosong

Gejala: Skrin tunggu tidak menunjukkan apa-apa dan bukan tayangan slaid yang dikonfigurasikan.

Penyelesaian:

  1. Sahkan skrin tunggu diaktifkan dalam Tetapan > Klien > Skrin Tunggu.
  2. Semak bahawa sekurang-kurangnya satu item media (imej atau video) telah ditambah.
  3. Sahkan fail media sah dan tidak rosak.
  4. Cetuskan penyegerakan untuk menolak tetapan terkini ke klien.

Menu klien tidak menunjukkan aplikasi

Gejala: Pelancar aplikasi kosong atau kategori tiada.

Penyelesaian:

  1. Sahkan aplikasi dan kategori dikonfigurasikan dalam Tetapan > Klien > Kandungan.
  2. Semak bahawa kategori dan aplikasi mempunyai keterlihatan ditogol hidup.
  3. Sahkan klien telah menerima data menu terkini (perubahan ditolak secara automatik melalui TCP).
  4. Mulakan semula klien jika penyegerakan masa nyata tidak terpakai.

Tema penampilan klien tidak digunakan

Gejala: Klien menunjukkan penampilan lalai dan bukan tema yang dikonfigurasikan.

Penyelesaian:

  1. Sahkan tetapan tema disimpan dalam Tetapan > Klien > Penampilan.
  2. Cetuskan tolakan tetapan ke klien.
  3. Mulakan semula aplikasi klien.

Isu Desktop Jauh

Desktop jauh lambat atau tersendat

Gejala: Suapan video tertangguh, tersekat atau mempunyai kadar bingkai rendah.

Penyelesaian:

  1. Turunkan kadar bit (cuba 1000-2000 kbps untuk penggunaan LAN standard).
  2. Kurangkan tetapan FPS.
  3. Gunakan Ethernet berwayar dan bukan WiFi.
  4. Semak kesesakan rangkaian atau penggunaan lebar jalur tinggi dari aplikasi lain.
  5. Pastikan port UDP 5004 tidak disekat atau dihadkan kadarnya.

Desktop jauh menunjukkan skrin hitam

Gejala: Tetingkap desktop jauh dibuka tetapi hanya menunjukkan hitam.

Penyelesaian:

  1. Sahkan klien dalam talian dan responsif (cuba ambil tangkapan skrin dahulu).
  2. Semak port UDP 5004 dibuka secara dua arah.
  3. Pemacu grafik klien mungkin perlu dikemas kini.
  4. Cuba minta muat semula bingkai utama.

Tidak dapat mengawal tetikus atau papan kekunci secara jauh

Gejala: Anda boleh melihat skrin jauh tetapi klik dan ketukan kekunci tiada kesan.

Penyelesaian:

  1. Sahkan port pengurusan jauh (TCP 5003) dibuka.
  2. Semak bahawa aplikasi klien mempunyai kebenaran sistem yang sesuai.
  3. Sesetengah permainan skrin penuh mungkin menghalang input jauh.

Isu Pelesenan

Lesen menunjukkan "offline_grace"

Gejala: Status lesen menunjukkan offline_grace dengan kira detik.

Penyelesaian:

  1. Pulihkan sambungan internet pada PC pelayan.
  2. Semak resolusi DNS. Pelayan mesti boleh mencapai pelayan pelesenan.
  3. Semak untuk proksi atau firewall yang menghalang sambungan HTTPS keluar.
  4. Anda mempunyai 72 jam untuk memulihkan sambungan sebelum pelayan dikunci.

Lesen menunjukkan "over_limit"

Gejala: Lebih banyak klien disambungkan daripada yang dibenarkan oleh lesen.

Penyelesaian:

  1. Putuskan sambungan klien melahu yang tidak digunakan.
  2. Semak kiraan klien semasa berbanding had lesen anda.
  3. Naik taraf lesen anda untuk kapasiti PC yang lebih banyak.
  4. Nota: konsol dikira terhadap jumlah had PC.

Lesen menunjukkan "expired" atau "revoked"

Gejala: Pelayan memasuki mod terhad.

Penyelesaian:

  1. Semak tarikh luput lesen anda.
  2. Perbaharui lesen anda melalui laman web HandyCafe.
  3. Untuk lesen yang dibatalkan, hubungi sokongan HandyCafe.

Isu Am

Perubahan tetapan tidak disimpan

Gejala: Perubahan kembali asal selepas menavigasi dari tetapan.

Penyelesaian:

  1. Pastikan anda mengklik butang Simpan selepas membuat perubahan.
  2. Semak untuk ralat pengesahan (medan yang diserlahkan dengan mesej ralat).
  3. Sahkan anda mempunyai kebenaran pentadbir.

Entri log audit tiada

Gejala: Tindakan yang dijangka tidak muncul di halaman Log.

Penyelesaian:

  1. Semak penapis log. Pastikan kategori dan julat tarikh yang betul dipilih.
  2. Sahkan kebenaran LOG_DISPLAY_FULL diberikan (jika tidak, hanya log hari ini ditunjukkan).
  3. Cari menggunakan medan carian teks untuk tindakan tertentu.