HandyCafe Docs
owner cashier it-admin

استكشاف الأخطاء وإصلاحها

تغطي هذه الصفحة حلولًا للمشاكل الشائعة مرتبة حسب الفئة.


مشاكل الاتصال

العميل لا يمكنه العثور على الخادم

الأعراض: يظهر للعميل "البحث عن الخادم" أو "لم يتم العثور على خادم".

الحلول:

  1. تحقق من أن HandyCafe Server يعمل على جهاز الكمبيوتر الإداري.
  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. إذا كنت تستخدم VLANs، تأكد من أن VLANs الخادم والعميل يمكنها التواصل.

لا يمكن الاتصال بعد تغيير إعدادات الشبكة

الأعراض: بعد تغيير المنافذ أو مفتاح الاتصال، لا يمكن للعملاء الاتصال.

الحلول:

  1. تأكد من تحديث العملاء بأرقام المنافذ الجديدة ومفتاح الاتصال.
  2. أعد تشغيل HandyCafe Server بعد تغيير إعدادات الشبكة.
  3. قم بتحديث قواعد الجدار الناري للسماح بالمنافذ الجديدة.
  4. يجب إعادة تكوين جميع العملاء بالقيم الجديدة.

مشاكل الجلسات

لا يمكن بدء جلسة على العميل

الأعراض: زر البدء معطل أو فشل إجراء البدء مع خطأ.

الحلول:

  1. تحقق من حالة الترخيص. إذا كان في وضع القراءة فقط، لا يمكن بدء جلسات جديدة.
  2. تأكد من أن حالة العميل هي "خامل". يمكن بدء الجلسات فقط على العملاء الخاملين.
  3. تحقق من أذونات الكاشير. يجب أن يكون للدور إذن AUTH_CLIENT_LOGIN.
  4. تأكد من تكوين التسعير (يجب أن يحتوي الإعدادات > التسعير على سعر ساعي صالح).

مؤقت الجلسة يظهر وقتًا غير صحيح

الأعراض: الوقت المعروض لا يتطابق مع الوقت الفعلي المنقضي.

الحلول:

  1. تحقق من ساعات النظام على كل من أجهزة الكمبيوتر الخادم والعميل. يجب أن تكون متزامنة (استخدم NTP).
  2. إذا كانت الجلسة متوقفة مؤقتًا، فإن مدة التوقف المؤقت لا تُحسب.
  3. بالنسبة للجلسات المدفوعة مسبقًا، يظهر المؤقت الوقت المتبقي، وليس الوقت المنقضي.

تكلفة الجلسة تبدو خاطئة

الأعراض: المبلغ المحمل لا يتطابق مع التوقعات.

الحلول:

  1. تحقق من جدول التسعير. إذا كان ممكّنًا، قد تكون الجلسة قد مرت عبر عدة فترات تسعير بمضاعفات مختلفة.
  2. راجع إعدادات التسعير: السعر الأساسي للساعة، ضريبة القيمة المضافة، رسوم البدء، التقريب.
  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. خفض معدل البت (جرب 1000-2000 كيلوبت في الثانية للاستخدام القياسي للشبكة المحلية).
  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. ملاحظة: تُحسب وحدات التحكم ضمن الحد الإجمالي لأجهزة الكمبيوتر.

الترخيص يظهر "expired" أو "revoked"

الأعراض: يدخل الخادم في وضع مقيد.

الحلول:

  1. تحقق من تاريخ انتهاء صلاحية الترخيص الخاص بك.
  2. جدد ترخيصك عبر موقع HandyCafe.
  3. بالنسبة للتراخيص الملغاة، اتصل بدعم HandyCafe.

مشاكل عامة

لا يتم حفظ تغييرات الإعدادات

الأعراض: تعود التغييرات بعد الانتقال بعيدًا عن الإعدادات.

الحلول:

  1. تأكد من النقر على زر حفظ بعد إجراء التغييرات.
  2. تحقق من وجود أخطاء في التحقق (الحقول المظللة برسائل الخطأ).
  3. تحقق من أن لديك أذونات المسؤول.

سجلات التدقيق تفتقد إلى الإدخالات

الأعراض: لا تظهر الإجراءات المتوقعة في صفحة السجلات.

الحلول:

  1. تحقق من عوامل تصفية السجل. تأكد من تحديد الفئة ونطاق التاريخ الصحيحين.
  2. تحقق من منح إذن LOG_DISPLAY_FULL (وإلا ستظهر سجلات اليوم فقط).
  3. ابحث باستخدام حقل البحث النصي عن الإجراء المحدد.