HandyCafe Docs
owner cashier it-admin

Pag-troubleshoot

Sinasaklaw ng pahinang ito ang mga solusyon para sa karaniwang mga isyu na nakaayos ayon sa kategorya.

Mga Isyu sa Koneksyon

Hindi mahanap ng kliyente ang server

Sintomas: Ipinapakita ng kliyente ang "Searching for server" o "No server found."

Solusyon:

  1. Siguraduhing tumatakbo ang HandyCafe Server sa management PC.
  2. Tiyakin na parehong nasa iisang subnet ang mga PC (hal., parehong nasa 192.168.1.x).
  3. Suriin na hindi naka-block ang mDNS ng iyong network switch o router.
  4. Subukan ang manual na koneksyon: ilagay ang IP address ng server nang direkta sa mga setting ng kliyente.
  5. Siguraduhin na walang ibang software na gumagamit ng TCP port ng server (default: 5001).

Kumokonekta ang kliyente at agad na nagdi-disconnect

Sintomas: Sandaling ipinapakita ng kliyente ang "Connected" pagkatapos ay bumabalik sa "Searching."

Solusyon:

  1. Siguraduhin na ang connection key ay magkatugma sa parehong server at kliyente. Ang key ay nakatakda sa Settings > Network sa server.
  2. Suriin ang network instability (packet loss, problema sa kable).
  3. Tiyakin na hindi pa naabot ng server ang limitasyon ng lisensya para sa PC.
  4. Suriin ang mga log ng server para sa mga mensahe ng authentication failure.

Ipinapakita ng kliyente ang "Offline" sa server ngunit tumatakbo ang PC

Sintomas: Ang client PC ay naka-power on at ang client application ay tumatakbo ngunit ipinapakita ito ng server bilang offline.

Solusyon:

  1. Sa client PC, tiyakin na ang HandyCafe Client ay talagang tumatakbo (suriin ang system tray).
  2. Suriin ang koneksyon ng network sa client PC (maaari ba itong mag-ping sa server?).
  3. Siguraduhin na ang mga patakaran ng firewall: ang TCP ports 5001-5003 ay dapat na bukas sa parehong server at kliyente.
  4. I-restart ang HandyCafe Client sa apektadong PC.
  5. Kung gumagamit ng VLANs, tiyakin na ang server at client VLANs ay maaaring mag-communicate.

Hindi makakonekta pagkatapos baguhin ang mga setting ng network

Sintomas: Pagkatapos baguhin ang mga port o connection key, hindi makakonekta ang mga kliyente.

Solusyon:

  1. Siguraduhin na ang mga kliyente ay na-update sa mga bagong numero ng port at connection key.
  2. I-restart ang HandyCafe Server pagkatapos baguhin ang mga setting ng network.
  3. I-update ang mga patakaran ng firewall upang payagan ang mga bagong port.
  4. Ang lahat ng kliyente ay dapat na muling i-configure sa mga bagong halaga.

Mga Problema sa Session

Hindi makapagsimula ng session sa isang kliyente

Sintomas: Hindi ma-enable ang Start button o nabibigo ang start action na may error.

Solusyon:

  1. Suriin ang status ng lisensya. Kung nasa read-only mode, hindi makapagsimula ng mga bagong session.
  2. Siguraduhin na ang status ng kliyente ay "Idle". Ang mga session ay maaari lamang magsimula sa idle na mga kliyente.
  3. Suriin ang mga pahintulot ng cashier. Ang role ay dapat may AUTH_CLIENT_LOGIN permission.
  4. Tiyakin na ang pricing ay naka-configure (Settings > Pricing ay dapat may wastong hourly rate).

Ipinapakita ng session timer ang maling oras

Sintomas: Ang ipinapakitang oras ay hindi tumutugma sa aktwal na lumipas na oras.

Solusyon:

  1. Suriin ang mga orasan ng system sa parehong server at client PCs. Dapat silang naka-synchronize (gamitin ang NTP).
  2. Kung ang session ay na-pause, ang tagal ng pag-pause ay hindi binibilang.
  3. Para sa prepaid sessions, ang timer ay nagpapakita ng natitirang oras, hindi ang lumipas na oras.

Mukhang mali ang halaga ng session

Sintomas: Ang halagang sinisingil ay hindi tumutugma sa inaasahan.

Solusyon:

  1. Suriin ang pricing schedule. Kung naka-enable, ang session ay maaaring dumaan sa maraming pricing slots na may iba't ibang multipliers.
  2. Suriin ang mga setting ng pricing: base hourly rate, VAT, startup fee, rounding.
  3. Suriin ang mga pricing segments ng session sa mga detalye ng transaksyon para sa breakdown.
  4. Tiyakin ang commission at fixed fees ng payment method.
  5. Para sa prepaid sessions, suriin kung ang "Lock at Purchase" o "Live Schedule" mode ay aktibo.

Hindi ma-resume ang paused session

Sintomas: Nabibigo ang resume action o hindi ito available.

Solusyon:

  1. Siguraduhin na ang client PC ay konektado pa rin sa server.
  2. Suriin na ang status ng kliyente ay nagpapakita ng "Paused" (orange).
  3. Kung ang kliyente ay nag-disconnect habang naka-pause, maaaring kailanganin itong muling kumonekta muna.

Mga Isyu sa Pagbabayad

Nawawala ang payment method sa dropdown

Sintomas: Ang inaasahang payment method ay hindi lumalabas kapag nagsasara ng session o order.

Solusyon:

  1. Siguraduhin na ang payment method ay umiiral sa Management > Payment Methods.
  2. Suriin na ang payment method ay aktibo (hindi tinanggal o naka-disable).
  3. Suriin ang mga pahintulot ng cashier. Dapat ay may PAYMENT_MANAGE upang makita ang lahat ng methods.

Mukhang mali ang pagkalkula ng komisyon

Sintomas: Ang ibinawas na komisyon ay hindi tumutugma sa inaasahang rate.

Solusyon:

  1. Suriin ang commission rate (bilang porsyento) at fixed fee ng payment method.
  2. Formula ng komisyon: commission = (amount charged * commission rate / 100) + fixed fee.
  3. Suriin kung ang cashier ay nag-apply ng manual override sa halagang sinisingil.

Mga Isyu sa Display ng Kliyente

Blangko ang idle screen ng kliyente

Sintomas: Walang ipinapakita ang idle screen sa halip na ang naka-configure na slideshow.

Solusyon:

  1. Siguraduhin na ang idle screen ay naka-enable sa Settings > Clients > Idle Screen.
  2. Suriin na may naidagdag na kahit isang media item (larawan o video).
  3. Siguraduhin na ang mga media files ay valid at hindi corrupted.
  4. I-trigger ang sync upang itulak ang pinakabagong mga setting sa kliyente.

Hindi ipinapakita ng client menu ang mga apps

Sintomas: Walang laman ang app launcher o nawawala ang mga kategorya.

Solusyon:

  1. Siguraduhin na ang mga apps at kategorya ay naka-configure sa Settings > Clients > Content.
  2. Suriin na ang mga kategorya at apps ay naka-toggle on ang visibility.
  3. Siguraduhin na natanggap ng kliyente ang pinakabagong menu data (ang mga pagbabago ay awtomatikong ipinapadala sa pamamagitan ng TCP).
  4. I-restart ang kliyente kung hindi na-apply ang real-time sync.

Hindi na-aapply ang tema ng hitsura ng kliyente

Sintomas: Ipinapakita ng kliyente ang default na hitsura sa halip na ang naka-configure na tema.

Solusyon:

  1. Siguraduhin na ang mga setting ng tema ay naka-save sa Settings > Clients > Appearance.
  2. I-trigger ang settings push sa mga kliyente.
  3. I-restart ang client application.

Mga Isyu sa Remote Desktop

Laggy o choppy ang remote desktop

Sintomas: Naantala, nag-stutter, o mababa ang frame rate ng video feed.

Solusyon:

  1. Babaan ang bitrate (subukan ang 1000-2000 kbps para sa standard LAN use).
  2. Bawasan ang FPS setting.
  3. Gumamit ng wired Ethernet sa halip na WiFi.
  4. Suriin ang network congestion o mataas na bandwidth usage mula sa ibang applications.
  5. Siguraduhin na ang UDP port 5004 ay hindi naka-block o rate-limited.

Itim na screen ang ipinapakita ng remote desktop

Sintomas: Bumubukas ang remote desktop window ngunit itim lamang ang ipinapakita.

Solusyon:

  1. Siguraduhin na ang kliyente ay online at tumutugon (subukang kumuha ng screenshot muna).
  2. Suriin na ang UDP port 5004 ay bukas sa parehong direksyon.
  3. Maaaring kailanganin ng update ang graphics driver ng kliyente.
  4. Subukang humiling ng keyframe refresh.

Hindi makontrol ang mouse o keyboard nang remote

Sintomas: Nakikita mo ang remote screen ngunit walang epekto ang mga pag-click at keystroke.

Solusyon:

  1. Siguraduhin na ang remote management port (TCP 5003) ay bukas.
  2. Suriin na ang client application ay may naaangkop na system permissions.
  3. Ang ilang fullscreen games ay maaaring mag-block ng remote input.

Mga Isyu sa Paglilisensya

Ipinapakita ng lisensya ang "offline_grace"

Sintomas: Ipinapakita ng status ng lisensya ang offline_grace na may countdown.

Solusyon:

  1. Ibalik ang koneksyon sa internet sa server PC.
  2. Suriin ang DNS resolution. Dapat maabot ng server ang licensing server.
  3. Suriin para sa proxy o firewall na nagba-block ng outbound HTTPS connections.
  4. Mayroon kang 72 oras upang maibalik ang koneksyon bago mag-lock ang server.

Ipinapakita ng lisensya ang "over_limit"

Sintomas: Higit pang mga kliyente ang nakakonekta kaysa sa pinapayagan ng lisensya.

Solusyon:

  1. I-disconnect ang mga idle clients na hindi ginagamit.
  2. Suriin ang kasalukuyang bilang ng kliyente kumpara sa limitasyon ng iyong lisensya.
  3. I-upgrade ang iyong lisensya para sa mas maraming PC capacity.
  4. Tandaan: ang mga console ay binibilang sa kabuuang limitasyon ng PC.

Ipinapakita ng lisensya ang "expired" o "revoked"

Sintomas: Pumapasok ang server sa restricted mode.

Solusyon:

  1. Suriin ang petsa ng pag-expire ng iyong lisensya.
  2. I-renew ang iyong lisensya sa pamamagitan ng HandyCafe website.
  3. Para sa mga revoked na lisensya, makipag-ugnayan sa HandyCafe support.

Mga Pangkalahatang Isyu

Hindi nasusunod ang mga pagbabago sa setting

Sintomas: Ang mga pagbabago ay bumabalik pagkatapos umalis sa mga setting.

Solusyon:

  1. Siguraduhin na i-click ang Save button pagkatapos gumawa ng mga pagbabago.
  2. Suriin para sa mga validation error (mga naka-highlight na field na may mga mensahe ng error).
  3. Siguraduhin na mayroon kang admin permissions.

Nawawala ang mga entry sa audit logs

Sintomas: Ang inaasahang mga aksyon ay hindi lumalabas sa Logs page.

Solusyon:

  1. Suriin ang mga filter ng log. Siguraduhin na ang tamang kategorya at saklaw ng petsa ay napili.
  2. Siguraduhin na ang LOG_DISPLAY_FULL permission ay ibinigay (kung hindi, ang mga log lamang ng araw na ito ang ipinapakita).
  3. Maghanap gamit ang text search field para sa partikular na aksyon.