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

تغطي هذه الصفحة حلول المشكلات الشائعة مُنظّمة حسب الفئة.

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

العميل لا يجد الخادم

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

الحلول:

1. تأكد من أن خادم HandyCafe يعمل على جهاز الإدارة.
2. تأكد من أن كلا الجهازين على نفس الشبكة الفرعية (مثلًا كلاهما على 192.168.1.x).
3. تحقق من أن mDNS غير محظور من محوّل الشبكة أو جهاز التوجيه.
4. جرّب الاتصال اليدوي: أدخل عنوان IP الخادم مباشرة في إعدادات العميل.
5. تحقق من عدم استخدام برنامج آخر لمنفذ TCP الخادم (الافتراضي: 5001).

العميل يتصل ثم ينقطع فورًا

الأعراض: يعرض العميل "متصل" لفترة وجيزة ثم يعود إلى "البحث".

الحلول:

1. تحقق من تطابق مفتاح الاتصال على كل من الخادم والعميل. يُعدّ المفتاح في الإعدادات > الشبكة على الخادم.
2. تحقق من استقرار الشبكة (فقدان الحزم ومشاكل الكابلات).
3. تأكد من أن الخادم لم يبلغ حد الأجهزة في الترخيص.
4. راجع سجلات الخادم بحثًا عن رسائل فشل المصادقة.

العميل يظهر "غير متصل" على الخادم رغم أن الجهاز يعمل

الأعراض: الجهاز مُشغّل وتطبيق العميل يعمل لكن الخادم يعرضه كغير متصل.

الحلول:

1. على جهاز العميل تحقق من أن عميل HandyCafe يعمل فعلًا (تحقق من منطقة الإشعارات).
2. تحقق من اتصال الشبكة على جهاز العميل (هل يمكنه عمل ping للخادم؟).
3. تحقق من قواعد جدار الحماية: يجب أن تكون منافذ TCP 5001-5003 مفتوحة على كل من الخادم والعميل.
4. أعد تشغيل عميل HandyCafe على الجهاز المتأثر.
5. إذا كنت تستخدم VLANs تأكد من أن الخادم والعميل يمكنهما التواصل.

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

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

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

الحلول:

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

مؤقت الجلسة يعرض وقتًا خاطئًا

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

الحلول:

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

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

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

الحلول:

1. تحقق من جدول التسعير. إذا كان مُفعّلًا قد تكون الجلسة مرت عبر خانات تسعير متعددة بمضاعفات مختلفة.
2. راجع إعدادات التسعير: السعر الأساسي بالساعة والضريبة ورسوم البدء والتقريب.
3. تحقق من شرائح تسعير الجلسة في تفاصيل المعاملة للحصول على تفصيل.
4. تحقق من عمولة طريقة الدفع ورسومها الثابتة.
5. للجلسات المدفوعة مسبقًا تحقق من وضع "القفل عند الشراء" أو "الجدول المباشر" النشط.

مشاكل الدفع

طريقة الدفع مفقودة من القائمة المنسدلة

الأعراض: طريقة الدفع المتوقعة لا تظهر عند إغلاق جلسة أو طلب.

الحلول:

1. تحقق من وجود طريقة الدفع في الإدارة > طرق الدفع.
2. تحقق من أن طريقة الدفع نشطة (غير محذوفة أو معطّلة).
3. تحقق من أذونات الكاشير. يجب منح PAYMENT_MANAGE لرؤية جميع الطرق.

حساب العمولة يبدو خاطئًا

الأعراض: العمولة المخصومة لا تتطابق مع المعدل المتوقع.

الحلول:

1. تحقق من معدل عمولة طريقة الدفع (كنسبة مئوية) ورسومها الثابتة.
2. صيغة العمولة: العمولة = (المبلغ المُحمّل * معدل العمولة / 100) + الرسوم الثابتة.
3. تحقق مما إذا كان الكاشير قد طبّق تجاوزًا يدويًا على المبلغ المُحمّل.

مشاكل عرض العميل

شاشة خمول العميل فارغة

الأعراض: تعرض شاشة الخمول لا شيء بدلًا من عرض الشرائح المُعدّ.

الحلول:

1. تحقق من تفعيل شاشة الخمول في الإعدادات > العملاء > شاشة الخمول.
2. تحقق من إضافة عنصر وسائط واحد على الأقل (صورة أو فيديو).
3. تحقق من أن ملفات الوسائط صالحة وغير تالفة.
4. شغّل مزامنة لدفع أحدث الإعدادات إلى العميل.

قائمة العميل لا تعرض التطبيقات

الأعراض: مشغّل التطبيقات فارغ أو الفئات مفقودة.

الحلول:

1. تحقق من إعداد التطبيقات والفئات في الإعدادات > العملاء > المحتوى.
2. تحقق من تفعيل ظهور الفئات والتطبيقات.
3. تحقق من أن العميل تلقى أحدث بيانات القائمة (تُدفع التغييرات تلقائيًا عبر TCP).
4. أعد تشغيل العميل إذا لم تُطبّق المزامنة الفورية.

مشاكل سطح المكتب عن بُعد

سطح المكتب عن بُعد بطيء أو متقطّع

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

الحلول:

1. خفّض معدل البت (جرّب 1000-2000 كيلوبت/ثانية للاستخدام العادي على الشبكة المحلية).
2. خفّض إعداد FPS.
3. استخدم Ethernet سلكي بدلًا من WiFi.
4. تحقق من ازدحام الشبكة أو استهلاك عرض النطاق العالي من تطبيقات أخرى.
5. تأكد من أن منفذ UDP 5004 غير محظور أو محدود السرعة.

سطح المكتب عن بُعد يعرض شاشة سوداء

الأعراض: تُفتح نافذة سطح المكتب عن بُعد لكنها تعرض أسود فقط.

الحلول:

1. تحقق من أن العميل متصل ويستجيب (جرّب أخذ لقطة شاشة أولًا).
2. تحقق من فتح منفذ UDP 5004 ثنائي الاتجاه.
3. قد يحتاج تعريف الرسوميات على العميل للتحديث.
4. جرّب طلب تحديث إطار رئيسي.

مشاكل الترخيص

الترخيص يعرض "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. ابحث باستخدام حقل البحث النصي عن الإجراء المحدد.