HandyCafe Docs
owner cashier it-admin

Troubleshooting

Sinasaklaw ng page na ito ang mga solusyon para sa mga karaniwang isyu na naka-organize ayon sa kategorya.

Mga Isyu sa Connection

Hindi mahanap ng client ang server

Mga sintomas: Ipakita ng client ang "Searching for server" o "No server found."

Mga solusyon:

  1. I-verify na tumatakbo ang HandyCafe Server sa management PC.
  2. I-confirm na parehong PC ay nasa parehong subnet (hal., pareho sa 192.168.1.x).
  3. Suriin na hindi naka-block ng network switch o router mo ang mDNS.
  4. Subukan ang manual connection: direktang ilagay ang IP address ng server sa client settings.
  5. I-verify na walang ibang software na gumagamit ng TCP port ng server (default: 5001).

Kumokonekta ang client pagkatapos ay agad na nadidisconnect

Mga sintomas: Sandaling ipinapakita ng client ang "Connected" pagkatapos ay bumabalik sa "Searching."

Mga solusyon:

  1. I-verify na magkatugma ang connection key sa parehong server at client.
  2. Suriin kung may network instability (packet loss, cable issues).
  3. Tiyaking hindi naabot ng server ang license PC limit nito.
  4. Suriin ang server logs para sa authentication failure messages.

Ipinapakita ng client na "Offline" sa server ngunit tumatakbo ang PC

Mga solusyon:

  1. Sa client PC, i-verify na tumatakbo talaga ang HandyCafe Client (suriin ang system tray).
  2. Suriin ang network connection sa client PC (maaari bang mag-ping sa server?).
  3. I-verify ang firewall rules: TCP ports 5001-5003 ay dapat bukas sa parehong server at client.
  4. I-restart ang HandyCafe Client sa apektadong PC.

Hindi makakonekta pagkatapos baguhin ang network settings

Mga solusyon:

  1. Tiyaking na-update ang mga client gamit ang bagong port numbers at connection key.
  2. I-restart ang HandyCafe Server pagkatapos baguhin ang network settings.
  3. I-update ang firewall rules para payagan ang mga bagong ports.

Mga Problema sa Session

Hindi maka-start ng session sa client

Mga solusyon:

  1. Suriin ang license status. Kung nasa read-only mode, hindi maaaring mag-start ng bagong sessions.
  2. I-verify na "Idle" ang client status.
  3. Suriin ang cashier permissions. Ang tungkulin ay dapat may AUTH_CLIENT_LOGIN na pahintulot.
  4. Tiyaking naka-configure ang pricing (Settings > Pricing ay dapat may valid hourly rate).

Maling oras ang ipinapakita ng session timer

Mga solusyon:

  1. Suriin ang system clocks sa parehong server at client PCs. Dapat synchronized ang mga ito (gumamit ng NTP).
  2. Kung na-pause ang session, hindi ibinibilang ang paused duration.
  3. Para sa prepaid sessions, ipinapakita ng timer ang remaining time at hindi elapsed time.

Mukhang mali ang session cost

Mga solusyon:

  1. Suriin ang pricing schedule. Maaaring dumaan ang session sa maraming pricing slots na may iba't ibang multipliers.
  2. Suriin ang mga setting ng pagpepresyo: base hourly rate, VAT, startup fee, rounding.
  3. Suriin ang pricing segments ng session sa transaction details para sa breakdown.
  4. I-verify ang commission at fixed fees ng payment method.

Mga Isyu sa Payment

Nawawala ang payment method sa dropdown

Mga solusyon:

  1. I-verify na umiiral ang paraan ng pagbabayad sa Management > Payment Methods.
  2. Suriin na active ang payment method.
  3. Suriin ang cashier permissions. Kailangang granted ang PAYMENT_MANAGE para makita ang lahat ng methods.

Mukhang mali ang commission calculation

Mga solusyon:

  1. I-verify ang commission rate at fixed fee ng payment method.
  2. Formula ng komisyon: komisyon = (halagang sisingilin * rate ng komisyon / 100) + fixed fee.

Mga Isyu sa Client Display

Blangko ang client idle screen

Mga solusyon:

  1. I-verify na naka-enable ang idle screen sa Settings > Clients > Idle Screen.
  2. Suriin na naidagdag ang kahit isang media item.
  3. I-verify na valid ang media files.

Hindi nagpapakita ng apps ang client menu

Mga solusyon:

  1. I-verify na naka-configure ang mga app at mga kategorya sa Settings > Clients > Content.
  2. Suriin na naka-toggle on ang visibility ng categories at apps.
  3. I-restart ang client kung hindi nag-apply ang real-time sync.

Mga Isyu sa Remote Desktop

Mabagal o choppy ang remote desktop

Mga 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. Tiyaking hindi naka-block ang UDP port 5004.

Itim ang screen ng remote desktop

Mga solusyon:

  1. I-verify na online ang client (subukang mag-take muna ng screenshot).
  2. Suriin na bukas ang UDP port 5004 nang bidirectional.
  3. Maaaring kailanganin ng pag-update ang graphics driver ng client.

Hindi makontrol ang mouse o keyboard nang remote

Mga solusyon:

  1. I-verify na bukas ang remote management port (TCP 5003).
  2. Suriin na may naaangkop na system permissions ang client application.

Mga Isyu sa Licensing

Ipinapakita ng license na "offline_grace"

Mga solusyon:

  1. Ibalik ang internet connectivity sa server PC.
  2. Suriin ang DNS resolution.
  3. Mayroon kang 72 oras para ibalik ang connectivity bago ma-lock ang server.

Ipinapakita ng license na "over_limit"

Mga solusyon:

  1. Idisconnect ang mga idle clients na hindi ginagamit.
  2. I-upgrade ang iyong license para sa mas maraming PC capacity.
  3. Ang mga console ay ibinibilang sa kabuuang PC limit.

Ipinapakita ng license na "expired" o "revoked"

Mga solusyon:

  1. I-renew ang iyong license sa pamamagitan ng HandyCafe website.
  2. Para sa revoked licenses, makipag-ugnayan sa HandyCafe support.

Mga Pangkalahatang Isyu

Hindi nase-save ang mga pagbabago sa settings

Mga solusyon:

  1. Tiyaking i-click ang Save button pagkatapos gumawa ng mga pagbabago.
  2. Suriin kung may validation errors.
  3. I-verify na mayroon kang admin permissions.

Nawawalang entries sa audit logs

Mga solusyon:

  1. Suriin ang log filters. Tiyaking tama ang napiling category at date range.
  2. I-verify na nabigyan ng LOG_DISPLAY_FULL na pahintulot.