HandyCafe Docs
owner cashier it-admin

การแก้ไขปัญหา

หน้านี้ครอบคลุมถึงวิธีแก้ปัญหาสำหรับปัญหาทั่วไปที่จัดตามหมวดหมู่


ปัญหาการเชื่อมต่อ

ลูกค้าไม่พบเซิร์ฟเวอร์

อาการ: ไคลเอนต์แสดง "กำลังค้นหาเซิร์ฟเวอร์" หรือ "ไม่พบเซิร์ฟเวอร์"

แนวทางแก้ไข:

  1. ตรวจสอบว่าเซิร์ฟเวอร์ HandyCafe ทำงานบนพีซีการจัดการ
  2. ยืนยันว่าพีซีทั้งสองเครื่องอยู่บนเครือข่ายย่อยเดียวกัน (เช่น ทั้งสองเครื่องบน 192.168.1.x)
  3. ตรวจสอบว่า mDNS ไม่ได้ถูกบล็อกโดยสวิตช์เครือข่ายหรือเราเตอร์ของคุณ
  4. ลองใช้การเชื่อมต่อด้วยตนเอง: ป้อนที่อยู่ IP ของเซิร์ฟเวอร์โดยตรงในการตั้งค่าไคลเอนต์
  5. ตรวจสอบว่าไม่มีซอฟต์แวร์อื่นที่ใช้พอร์ต TCP ของเซิร์ฟเวอร์ (ค่าเริ่มต้น: 5001)

ลูกค้าเชื่อมต่อแล้วยกเลิกการเชื่อมต่อทันที

อาการ: ลูกค้าแสดงข้อความ "เชื่อมต่อแล้ว" สั้นๆ จากนั้นจึงกลับไปที่ "กำลังค้นหา"

แนวทางแก้ไข:

  1. ตรวจสอบ คีย์การเชื่อมต่อ ที่ตรงกันทั้งบนเซิร์ฟเวอร์และไคลเอนต์ รหัสถูกตั้งค่าไว้ในการตั้งค่า > เครือข่ายบนเซิร์ฟเวอร์
  2. ตรวจสอบความไม่เสถียรของเครือข่าย (แพ็กเก็ตสูญหาย ปัญหาสายเคเบิล)
  3. ตรวจสอบให้แน่ใจว่าเซิร์ฟเวอร์ไม่ถึงขีดจำกัดสิทธิ์การใช้งานพีซี
  4. ตรวจสอบบันทึกเซิร์ฟเวอร์เพื่อดูข้อความแสดงความล้มเหลวในการตรวจสอบสิทธิ์

ไคลเอนต์แสดง "ออฟไลน์" บนเซิร์ฟเวอร์ แต่พีซีกำลังทำงานอยู่

อาการ: พีซีไคลเอนต์เปิดอยู่และแอปพลิเคชันไคลเอนต์กำลังทำงานอยู่ แต่เซิร์ฟเวอร์แสดงสถานะเป็นออฟไลน์

แนวทางแก้ไข:

  1. บนพีซีไคลเอนต์ ให้ตรวจสอบว่า HandyCafe Client กำลังทำงานอยู่จริง (ตรวจสอบถาดระบบ)
  2. ตรวจสอบการเชื่อมต่อเครือข่ายบนพีซีไคลเอนต์ (สามารถ ping ไปยังเซิร์ฟเวอร์ได้หรือไม่)
  3. ตรวจสอบกฎไฟร์วอลล์: ต้องเปิดพอร์ต TCP 5001-5003 บนทั้งเซิร์ฟเวอร์และไคลเอนต์
  4. รีสตาร์ท HandyCafe Client บนพีซีที่ได้รับผลกระทบ
  5. หากใช้ VLAN ตรวจสอบให้แน่ใจว่า VLAN ของเซิร์ฟเวอร์และไคลเอนต์สามารถสื่อสารกันได้

ไม่สามารถเชื่อมต่อได้หลังจากเปลี่ยนการตั้งค่าเครือข่าย

อาการ: หลังจากเปลี่ยนพอร์ตหรือคีย์การเชื่อมต่อ ไคลเอนต์ไม่สามารถเชื่อมต่อได้

แนวทางแก้ไข:

  1. ตรวจสอบให้แน่ใจว่าไคลเอนต์ได้รับการอัพเดตด้วยหมายเลขพอร์ตและคีย์การเชื่อมต่อใหม่
  2. รีสตาร์ท HandyCafe Server หลังจากเปลี่ยนการตั้งค่าเครือข่าย
  3. อัปเดตกฎไฟร์วอลล์เพื่ออนุญาตพอร์ตใหม่
  4. ไคลเอนต์ทั้งหมดจะต้องได้รับการกำหนดค่าใหม่ด้วยค่าใหม่

ปัญหาเซสชัน

ไม่สามารถเริ่มเซสชันบนไคลเอนต์ได้

อาการ: ปุ่ม Start ถูกปิดใช้งานหรือการดำเนินการเริ่มต้นล้มเหลวโดยมีข้อผิดพลาด

แนวทางแก้ไข:

  1. ตรวจสอบสถานะใบอนุญาต หากอยู่ในโหมดอ่านอย่างเดียว เซสชันใหม่จะไม่สามารถเริ่มต้นได้
  2. ตรวจสอบสถานะไคลเอ็นต์เป็น "ไม่ได้ใช้งาน" เซสชันสามารถเริ่มต้นได้บนไคลเอ็นต์ที่ไม่ได้ใช้งานเท่านั้น
  3. ตรวจสอบสิทธิ์แคชเชียร์ บทบาทต้องมีสิทธิ์ AUTH_CLIENT_LOGIN
  4. ตรวจสอบให้แน่ใจว่าได้กำหนดราคาไว้แล้ว (การตั้งค่า > ราคาต้องมีอัตรารายชั่วโมงที่ถูกต้อง)

ตัวจับเวลาเซสชันแสดงเวลาที่ไม่ถูกต้อง

อาการ: เวลาที่แสดงไม่ตรงกับเวลาที่ผ่านไปจริง

แนวทางแก้ไข:

  1. ตรวจสอบนาฬิการะบบทั้งบนเซิร์ฟเวอร์และพีซีไคลเอนต์ ควรซิงโครไนซ์ (ใช้ NTP)
  2. หากเซสชันถูกหยุดชั่วคราว ระยะเวลาที่หยุดชั่วคราวจะไม่นับ
  3. สำหรับเซสชันแบบชำระเงินล่วงหน้า ตัวจับเวลาจะแสดงเวลาที่เหลืออยู่ ไม่ใช่เวลาที่ผ่านไป

ค่าใช้จ่ายเซสชันดูเหมือนไม่ถูกต้อง

อาการ: จำนวนเงินที่เรียกเก็บไม่ตรงกับที่คาดหวัง

แนวทางแก้ไข:

  1. ตรวจสอบตารางราคา หากเปิดใช้งาน เซสชันอาจผ่านช่องราคาหลายช่องซึ่งมีตัวคูณต่างกัน
  2. ตรวจสอบการตั้งค่าราคา: อัตรารายชั่วโมงพื้นฐาน, VAT, ค่าธรรมเนียมเริ่มต้น, การปัดเศษ
  3. ตรวจสอบส่วนการกำหนดราคาของเซสชันในรายละเอียดธุรกรรมเพื่อดูรายละเอียด
  4. ตรวจสอบค่าคอมมิชชั่นและค่าธรรมเนียมคงที่ของวิธีการชำระเงิน
  5. สำหรับเซสชันแบบชำระเงินล่วงหน้า ตรวจสอบว่าโหมด "ล็อคเมื่อซื้อ" หรือ "กำหนดการสด" ทำงานอยู่หรือไม่

เซสชันที่หยุดชั่วคราวไม่สามารถดำเนินการต่อได้

อาการ: การดำเนินการต่อล้มเหลวหรือไม่สามารถใช้งานได้

แนวทางแก้ไข:

  1. ตรวจสอบว่าพีซีไคลเอนต์ยังคงเชื่อมต่อกับเซิร์ฟเวอร์
  2. ตรวจสอบว่าสถานะไคลเอนต์แสดง "หยุดชั่วคราว" (สีส้ม)
  3. หากไคลเอนต์ยกเลิกการเชื่อมต่อระหว่างการหยุดชั่วคราว อาจจำเป็นต้องเชื่อมต่อใหม่ก่อน

ปัญหาการชำระเงิน

วิธีการชำระเงินหายไปจากเมนูแบบเลื่อนลง

อาการ: วิธีการชำระเงินที่คาดไว้ไม่ปรากฏขึ้นเมื่อปิดเซสชันหรือคำสั่งซื้อ

แนวทางแก้ไข:

  1. ตรวจสอบวิธีการชำระเงินที่มีอยู่ในการจัดการ > วิธีการชำระเงิน
  2. ตรวจสอบว่าวิธีการชำระเงินใช้งานได้ (ไม่ถูกลบหรือปิดใช้งาน)
  3. ตรวจสอบสิทธิ์แคชเชียร์ ต้องให้สิทธิ์ PAYMENT_MANAGE เพื่อดูวิธีการทั้งหมด

ดูเหมือนว่าการคำนวณค่าคอมมิชชันจะไม่ถูกต้อง

อาการ: ค่าคอมมิชชั่นที่หักไม่ตรงกับอัตราที่คาดไว้

แนวทางแก้ไข:

  1. ตรวจสอบอัตราค่าคอมมิชชั่นของวิธีการชำระเงิน (เป็นเปอร์เซ็นต์) และค่าธรรมเนียมคงที่
  2. สูตรค่าคอมมิชชั่น: ค่าคอมมิชชั่น = (จำนวนเงินที่เรียกเก็บ * อัตราค่าคอมมิชชั่น / 100) + ค่าธรรมเนียมคงที่
  3. ตรวจสอบว่าแคชเชียร์ใช้การแทนที่ด้วยตนเองกับจำนวนเงินที่เรียกเก็บหรือไม่

ปัญหาการแสดงผลของลูกค้า

หน้าจอไคลเอ็นต์ไม่ได้ใช้งานว่างเปล่า

อาการ: หน้าจอว่างไม่แสดงอะไรเลยนอกจากสไลด์โชว์ที่กำหนดค่าไว้

แนวทางแก้ไข:

  1. ตรวจสอบว่าหน้าจอไม่ได้ใช้งานเปิดใช้งานอยู่ในการตั้งค่า > ลูกค้า > หน้าจอไม่ได้ใช้งาน
  2. ตรวจสอบว่ามีการเพิ่มรายการสื่อ (รูปภาพหรือวิดีโอ) อย่างน้อยหนึ่งรายการ
  3. ตรวจสอบว่าไฟล์มีเดียถูกต้องและไม่เสียหาย
  4. ทริกเกอร์การซิงค์เพื่อส่งการตั้งค่าล่าสุดไปยังไคลเอนต์

เมนูไคลเอนต์ไม่แสดงแอพ

อาการ: ตัวเรียกใช้งานแอปว่างเปล่าหรือหมวดหมู่หายไป

แนวทางแก้ไข:

  1. ตรวจสอบว่าแอปและหมวดหมู่ได้รับการกำหนดค่าในการตั้งค่า > ลูกค้า > เนื้อหา
  2. ตรวจสอบว่าหมวดหมู่และแอปเปิดการมองเห็นไว้แล้ว
  3. ตรวจสอบว่าไคลเอ็นต์ได้รับข้อมูลเมนูล่าสุด (การเปลี่ยนแปลงจะพุชโดยอัตโนมัติผ่าน TCP)
  4. รีสตาร์ทไคลเอ็นต์หากไม่ได้ใช้การซิงค์แบบเรียลไทม์

ไม่ได้ใช้ธีมลักษณะที่ปรากฏของไคลเอ็นต์

อาการ: ไคลเอนต์แสดงรูปลักษณ์เริ่มต้นแทนธีมที่กำหนดค่าไว้

แนวทางแก้ไข:

  1. ตรวจสอบว่าการตั้งค่าธีมถูกบันทึกไว้ในการตั้งค่า > ลูกค้า > ลักษณะที่ปรากฏ
  2. ทริกเกอร์การตั้งค่าที่ส่งไปยังไคลเอนต์
  3. รีสตาร์ทแอปพลิเคชันไคลเอนต์

ปัญหาเดสก์ท็อประยะไกล

เดสก์ท็อประยะไกลทำงานช้าหรือขาด ๆ หาย ๆ

อาการ: ฟีดวิดีโอล่าช้า กระตุก หรือมีอัตราเฟรมต่ำ

แนวทางแก้ไข:

  1. ลดบิตเรต (ลอง 1,000-2,000 kbps สำหรับการใช้งาน LAN มาตรฐาน)
  2. ลดการตั้งค่า FPS
  3. ใช้อีเธอร์เน็ตแบบมีสายแทน WiFi
  4. ตรวจสอบความแออัดของเครือข่ายหรือการใช้แบนด์วิธสูงจากแอปพลิเคชันอื่น
  5. ตรวจสอบให้แน่ใจว่าพอร์ต UDP 5004 ไม่ได้ถูกบล็อกหรือจำกัดอัตรา

เดสก์ท็อประยะไกลแสดงหน้าจอสีดำ

อาการ: หน้าต่างเดสก์ท็อประยะไกลเปิดขึ้นแต่แสดงเฉพาะสีดำ

แนวทางแก้ไข:

  1. ตรวจสอบว่าไคลเอนต์ออนไลน์และตอบสนอง (ลองถ่ายภาพหน้าจอก่อน)
  2. ตรวจสอบว่าพอร์ต UDP 5004 เปิดแบบสองทิศทาง
  3. ไดรเวอร์กราฟิกของไคลเอ็นต์อาจจำเป็นต้องอัปเดต
  4. ลองขอการรีเฟรชคีย์เฟรม

ไม่สามารถควบคุมเมาส์หรือคีย์บอร์ดจากระยะไกลได้

อาการ: มองเห็นหน้าจอระยะไกลได้ แต่การคลิกและการกดแป้นพิมพ์ไม่มีผลใดๆ

แนวทางแก้ไข:

  1. ตรวจสอบว่าพอร์ตการจัดการระยะไกล (TCP 5003) เปิดอยู่
  2. ตรวจสอบว่าแอปพลิเคชันไคลเอนต์มีสิทธิ์ของระบบที่เหมาะสม
  3. เกมเต็มหน้าจอบางเกมอาจบล็อกการป้อนข้อมูลระยะไกล

ปัญหาใบอนุญาต

ใบอนุญาตแสดง "offline_grace"

อาการ: สถานะใบอนุญาตแสดง Offline_grace พร้อมการนับถอยหลัง

แนวทางแก้ไข:

  1. คืนค่าการเชื่อมต่ออินเทอร์เน็ตบนเซิร์ฟเวอร์พีซี
  2. ตรวจสอบความละเอียด DNS เซิร์ฟเวอร์จะต้องเข้าถึงเซิร์ฟเวอร์สิทธิ์การใช้งาน
  3. ตรวจสอบพร็อกซีหรือไฟร์วอลล์ที่บล็อกการเชื่อมต่อ HTTPS ขาออก
  4. คุณมีเวลา 72 ชั่วโมงในการกู้คืนการเชื่อมต่อก่อนที่เซิร์ฟเวอร์จะล็อค

ใบอนุญาตแสดง "over_limit"

อาการ: มีไคลเอ็นต์เชื่อมต่อกันมากกว่าที่ใบอนุญาตอนุญาต

แนวทางแก้ไข:

  1. ตัดการเชื่อมต่อไคลเอนต์ที่ไม่ได้ใช้งานที่ไม่ได้ใช้งาน
  2. ตรวจสอบจำนวนลูกค้าปัจจุบันเทียบกับขีดจำกัดใบอนุญาตของคุณ
  3. อัปเกรดใบอนุญาตของคุณเพื่อเพิ่มความจุพีซี
  4. หมายเหตุ: คอนโซลนับรวมในขีดจำกัดพีซีทั้งหมด

ใบอนุญาตแสดง "หมดอายุ" หรือ "ถูกเพิกถอน"

อาการ: เซิร์ฟเวอร์เข้าสู่โหมดจำกัด

แนวทางแก้ไข:

  1. ตรวจสอบวันหมดอายุใบอนุญาตของคุณ
  2. ต่ออายุใบอนุญาตของคุณผ่านทางเว็บไซต์ HandyCafe
  3. สำหรับใบอนุญาตที่ถูกเพิกถอน โปรดติดต่อฝ่ายสนับสนุนของ HandyCafe

ปัญหาทั่วไป

การเปลี่ยนแปลงการตั้งค่าไม่ได้รับการบันทึก

อาการ: การเปลี่ยนแปลงจะเปลี่ยนกลับหลังจากออกจากการตั้งค่า

แนวทางแก้ไข:

  1. อย่าลืมคลิกปุ่ม บันทึก หลังจากทำการเปลี่ยนแปลง
  2. ตรวจสอบข้อผิดพลาดในการตรวจสอบความถูกต้อง (ช่องที่ไฮไลต์พร้อมข้อความแสดงข้อผิดพลาด)
  3. ตรวจสอบว่าคุณมีสิทธิ์ของผู้ดูแลระบบ

บันทึกการตรวจสอบไม่มีรายการ

อาการ: การดำเนินการที่คาดหวังไม่ปรากฏในหน้าบันทึก

แนวทางแก้ไข:

  1. ตรวจสอบตัวกรองบันทึก ตรวจสอบให้แน่ใจว่าได้เลือกหมวดหมู่และช่วงวันที่ที่ถูกต้อง
  2. ตรวจสอบว่าได้รับสิทธิ์ LOG_DISPLAY_FULL แล้ว (ไม่เช่นนั้นจะแสดงเฉพาะบันทึกของวันนี้เท่านั้น)
  3. ค้นหาโดยใช้ช่องค้นหาข้อความสำหรับการดำเนินการเฉพาะ