حلول سريعة لمشكلات BigLedger الشائعة وأدلة شاملة لحل المشكلات. يساعدك هذا القسم على حل المشكلات بسرعة والعودة إلى العمل المنتج.

حل المشكلات السريع

أكثر المشكلات شيوعًا

يتناول دليل استكشاف الأخطاء وإصلاحها الشامل هذا أكثر مشكلات BigLedger شيوعًا مع رموز أخطاء محددة وحلول خطوة بخطوة وتدابير وقائية.

مشكلات تسجيل الدخول والوصول

• تعذّر تسجيل الدخول: إعادة تعيين كلمة المرور وحالة الحساب ومشكلات المتصفح
• ميزات مفقودة: مشكلات الصلاحيات وتوفّر التطبيقات المصغّرة
• أداء بطيء: تحسين المتصفح ومشكلات الشبكة
• انتهاء مهلة الجلسة: إعدادات الأمان وتهيئة المتصفح

مشكلات إدخال البيانات

• تعذّر حفظ السجلات: أخطاء التحقق والحقول المطلوبة
• خيارات القائمة المنسدلة مفقودة: إعداد البيانات الرئيسية والصلاحيات
• فشل الاستيراد: تنسيق البيانات وأخطاء التعيين
• سجلات مكررة: التحقق من البيانات وإجراءات الدمج

مشكلات المعاملات

• أخطاء معالجة الطلبات: مشكلات سير العمل وسلاسل الموافقة
• مشكلات التسعير: تهيئة نظام الأسعار وإعدادات العملاء
• تناقضات المخزون: تعديلات المخزون ومشكلات الموقع
• أخطاء التقارير: الوصول إلى البيانات وإعدادات المعاملات

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

1. تحديد المشكلة

• توثيق الأعراض - ما الذي يحدث بالضبط؟
• إعادة إنتاج المشكلة - هل يمكنك جعلها تحدث مرة أخرى؟
• التحقق من التوقيت - متى بدأ حدوث هذا؟
• جمع السياق - ما الذي كنت تحاول إنجازه؟

2. جمع المعلومات

• رسائل الخطأ - انسخ نص الخطأ ورموزه بدقة
• لقطات الشاشة - دليل مرئي على المشكلة
• تفاصيل حساب المستخدم - معلومات الصلاحيات والدور
• بيئة النظام - معلومات المتصفح والجهاز والشبكة

3. تجربة الحلول الأساسية

• التحديث/إعادة التحميل - تحديث بسيط للمتصفح
• مسح التخزين المؤقت - التخزين المؤقت للمتصفح وملفات تعريف الارتباط
• متصفح مختلف - الاختبار بمتصفح آخر
• التحقق من الصلاحيات - التحقق من حقوق الوصول

4. التشخيصات المتقدمة

• التحقق من حالة النظام - هل يعمل النظام بشكل طبيعي؟
• مراجعة التغييرات الأخيرة - ما الذي تغيّر مؤخرًا؟
• الاختبار ببيانات مختلفة - هل المشكلة خاصة بالبيانات؟
• الرجوع إلى التوثيق - راجع أدلة المستخدم ذات الصلة

رموز أخطاء BigLedger وحلولها

رموز أخطاء النظام (ERR-SYS-XXXX)

ERR-SYS-0001: تم رفض الوصول

• السبب: يفتقر المستخدم إلى الصلاحيات اللازمة للعملية المطلوبة
• التفاصيل التقنية: فشل التحقق من الصلاحيات على مستوى الوحدة أو الميزة
• الحل الفوري:
  1. اتصل بمسؤول النظام
  2. تحقق من تعيينات دور المستخدم في إدارة المستخدمين
  3. تحقق من الصلاحيات الخاصة بالوحدة
• الوقاية طويلة الأجل:
  • نفّذ عمليات تدقيق منتظمة للصلاحيات (ربع سنوية)
  • استخدم التحكم في الوصول القائم على الأدوار (RBAC) باستمرار
  • وثّق متطلبات الصلاحيات لكل وظيفة عمل

ERR-SYS-0002: انتهت الجلسة

• السبب: انتهاء مهلة الأمان بسبب عدم النشاط (الافتراضي: 60 دقيقة)
• التفاصيل التقنية: تجاوز رمز الجلسة الحد الأقصى لمدة الصلاحية
• الحل الفوري:
  1. سجّل الخروج بالكامل ثم سجّل الدخول مرة أخرى
  2. امسح التخزين المؤقت للمتصفح وملفات تعريف الارتباط
  3. عطّل الحفظ التلقائي للمتصفح للبيانات الحساسة
• خيارات التهيئة:

  Session Settings (Admin > Security):
  • Timeout Period: 30-480 minutes
  • Idle Warning: 5 minutes before expiry
  • Concurrent Sessions: Allow/Restrict
  • Remember Me: Enable/Disable

ERR-SYS-0003: فشل الاتصال بقاعدة البيانات

• السبب: انقطاع الشبكة أو عدم توفّر خادم قاعدة البيانات
• التفاصيل التقنية: استنفاد مجمّع الاتصالات أو صيانة قاعدة البيانات
• الحل الفوري:
  1. انتظر 2-3 دقائق ثم أعد المحاولة
  2. تحقق من حالة النظام على status.bigledger.com
  3. اتصل بالدعم إذا استمرت المشكلة أكثر من 5 دقائق
• الوقاية: راقب صحة قاعدة البيانات واستخدام مجمّع الاتصالات

أخطاء التحقق من البيانات (ERR-VAL-XXXX)

ERR-VAL-1001: حقل مطلوب مفقود

• السبب: ترك حقل إلزامي فارغًا أثناء إدخال البيانات
• أنواع الحقول: رمز العميل، اسم المنتج، مبلغ المعاملة، إلخ
• خطوات الحل:
  1. راجع النموذج بحثًا عن الحقول المميّزة بعلامة نجمية حمراء (*)
  2. املأ جميع المعلومات المطلوبة
  3. تحقق من تنسيق البيانات (التواريخ والأرقام والبريد الإلكتروني)
  4. احفظ السجل مرة أخرى
• الحقول المفقودة الشائعة:

  Customer Records: Name, Tax ID, Contact Info
  Product Records: Code, Name, Unit of Measure
  Transactions: Date, Amount, Account Code

ERR-VAL-1002: تنسيق بيانات غير صالح

• السبب: البيانات لا تطابق التنسيق المتوقع أو قواعد العمل
• السيناريوهات الشائعة:
  • تنسيق بريد إلكتروني غير صالح (رمز @ مفقود)
  • تنسيق تاريخ غير صحيح (مطلوب DD/MM/YYYY)
  • تنسيق رقم هاتف غير صالح (+60-XXX-XXXXXXX)
  • تنسيق الرقم الضريبي لا يطابق المعايير الماليزية
• الحل:
  1. تحقق من تلميحات تنسيق الحقل وأمثلته
  2. استخدم أدوات التحقق من التنسيق حيثما توفّرت
  3. انسخ والصق من مصادر موثّقة

أخطاء المعاملات (ERR-TXN-XXXX)

ERR-TXN-2001: مخزون غير كافٍ

• السبب: محاولة بيع/تخصيص مخزون أكثر من المتوفر
• التفاصيل التقنية: فشل فحص المخزون الفوري
• الحل المفصّل:
  1. تحقق من مستويات المخزون الحالية: Inventory > Stock Inquiry
  2. تحقق من موقع المخزون وتوفّره
  3. فكّر في هذه الخيارات:
     • تقليل الكمية إلى المخزون المتوفر
     • نقل المخزون من مواقع أخرى
     • إنشاء طلب مؤجّل للكمية المتبقية
     • تحديث المخزون إذا كان جرد المخزون غير صحيح
• أفضل ممارسات إدارة المخزون:

  • Set reorder points for all active items
  • Monitor stock levels daily
  • Implement automatic reorder notifications
  • Regular cycle counting for accuracy

ERR-TXN-2002: السعر غير موجود

• السبب: لا يوجد سعر صالح مُهيّأ لمجموعة الصنف/العميل
• فحص التسلسل الهرمي للأسعار:
  1. التسعير الخاص بالعميل
  2. تسعير مجموعة العملاء
  3. التسعير الترويجي
  4. قائمة الأسعار القياسية
  5. سعر التكلفة الأساسي
• خطوات التهيئة:
  1. انتقل إلى Sales > Price Management
  2. أعدّ أنظمة الأسعار حسب نوع العميل
  3. هيّئ فترات التسعير الترويجي
  4. اضبط الأسعار الافتراضية للمنتجات الجديدة
  5. اختبر التسعير بمعاملات عينة

أخطاء الامتثال الماليزي (ERR-MYS-XXXX)

ERR-MYS-4001: خطأ في حساب ضريبة SST

• السبب: مشكلة في حساب أو تهيئة ضريبة المبيعات والخدمات
• قواعد SST:
  • المعدل القياسي: 6% (معظم السلع والخدمات)
  • المعدل الصفري: 0% (الصادرات والسلع المعفاة)
  • معفى: لا تنطبق ضريبة SST
• فحص التهيئة:
  1. إعداد المنتج: تحقق من تعيين رمز SST
  2. إعداد العميل: تحقق من حالة الإعفاء من SST
  3. إعدادات الضريبة: راجع قواعد حساب SST
  4. تحديثات المعدلات: تأكد من تحميل معدلات SST الحالية

ERR-MYS-4002: فشل إنشاء الفاتورة الإلكترونية

• السبب: خطأ في التكامل مع MyInvois أو فشل التحقق
• متطلبات الفاتورة الإلكترونية لدى LHDN:

  Mandatory Fields:
  • Supplier TIN (Tax Identification Number)
  • Buyer TIN (for B2B transactions)
  • Invoice date and time
  • Unique invoice number
  • Product/service description
  • SST details
• أخطاء التحقق:
  1. تنسيق TIN: يجب أن يكون بتنسيق TIN ماليزي صالح
  2. التاريخ/الوقت: يجب أن يكون ضمن الإطار الزمني لتقديم MyInvois
  3. العملة: MYR والعملات الأجنبية المعتمدة فقط
  4. نوع المستند: يجب أن يطابق الأنواع المعتمدة من LHDN

أخطاء التكامل (ERR-INT-XXXX)

ERR-INT-3001: فشل المزامنة - الخدمات المصرفية

• السبب: فشل اتصال التكامل المصرفي أو انتهاء صلاحية المصادقة
• البنوك المحددة المدعومة: Maybank وCIMB وPublic Bank وRHB وHong Leong
• خطوات استكشاف الأخطاء وإصلاحها:
  1. تحقق من بيانات الاعتماد: تحقق من تفاصيل تسجيل الدخول المصرفي في Finance > Bank Integration
  2. اختبر الاتصال: استخدم زر “Test Connection”
  3. حدّث الرموز: أعد المصادقة إذا كنت تستخدم OAuth
  4. فحص الشبكة: تأكد من أن جدار الحماية يسمح بالاتصالات المصرفية
  5. حالة البنك: تحقق مما إذا كان نظام البنك متوقفًا للصيانة

ERR-INT-3002: خطأ مزامنة التجارة الإلكترونية

• السبب: مشكلات اتصال مع منصات المتاجر الإلكترونية
• المنصات المدعومة: Shopee وLazada وWooCommerce وMagento وShopify
• الأنواع الفرعية للخطأ:

  3002-A: Authentication failure
  3002-B: Product catalog sync failed
  3002-C: Order download error
  3002-D: Inventory update failed
  3002-E: Pricing sync error
• الحلول الخاصة بكل منصة:
  • Shopee: تحقق من مفتاح API والسر في Seller Center
  • Lazada: تحقق من تفويض التطبيق في Seller Center
  • WooCommerce: اختبر بيانات اعتماد REST API
  • Shopify: حدّث صلاحيات التطبيق الخاص

المشكلات الخاصة بالمتصفح

مشكلات Chrome

• مشكلات التخزين المؤقت: امسح بيانات التصفح، وأعد ضبط إعدادات Chrome
• تعارضات الإضافات: عطّل الإضافات، واختبر في وضع التصفح المتخفي
• مشكلات الذاكرة: أغلق علامات التبويب غير المستخدمة، وأعد تشغيل المتصفح

مشكلات Firefox

• إعدادات الأمان: اضبط تفضيلات الأمان لـ BigLedger
• تعارضات الإضافات: اختبر مع تعطيل الإضافات
• إعدادات ملفات تعريف الارتباط: تأكد من تمكين ملفات تعريف الارتباط لـ BigLedger

مشكلات Safari

• إعدادات JavaScript: مكّن JavaScript لنطاق BigLedger
• إعدادات الخصوصية: اضبط إعدادات الخصوصية لتطبيقات الأعمال
• مشكلات التخزين المؤقت: امسح بيانات الموقع لـ BigLedger

مشكلات متصفح الهاتف المحمول

• التصميم المتجاوب: استخدم الوضع الأفقي للشاشات المعقّدة
• واجهة اللمس: استخدم الإيماءات المناسبة للتنقل
• اتصال البيانات: تأكد من استقرار اتصال الإنترنت

تحسين الأداء

أداء النظام

تحسين الأداء المفصّل

تحديد اختناقات الأداء

1. لوحة معلومات أداء النظام

   • انتقل إلى Admin > System Health
   • راقب أداء وحدة المعالجة المركزية والذاكرة وقاعدة البيانات
   • تحقق من جلسات المستخدمين النشطة والعمليات المتزامنة
   • راجع سجلات النظام بحثًا عن أنماط الأخطاء

2. مراقبة تجربة المستخدم

   • تتبّع أوقات تحميل الصفحات عبر الوحدات المختلفة
   • راقب سرعات إنشاء التقارير
   • حلّل مدد جلسات المستخدمين وانتهاء المهل
   • حدّد الميزات بطيئة الأداء المستخدمة بكثرة

تحسين الأداء على جانب المتصفح

Recommended Browser Settings:
✓ Enable JavaScript and cookies
✓ Disable unnecessary browser extensions
✓ Clear cache weekly
✓ Update to latest browser version
✓ Allow pop-ups for BigLedger domain
✓ Set sufficient memory allocation

تحسين الشبكة

• متطلبات النطاق الترددي: 10 ميجابت/ثانية كحد أدنى للأداء الأمثل
• اعتبارات زمن الاستجابة: زمن استجابة أقل من 100 مللي ثانية إلى خوادم BigLedger
• استقرار الاتصال: تُفضّل الاتصالات السلكية على WiFi
• تأثير VPN: اختبر الأداء مع/بدون VPN
• تهيئة جدار الحماية: أضف نطاقات ومنافذ BigLedger إلى القائمة البيضاء

ضبط أداء قاعدة البيانات

• تحسين الاستعلامات: استخدم المرشحات والنطاقات الزمنية المناسبة
• إدارة الفهارس: تأكد من الفهرسة الصحيحة للحقول المستعلَم عنها بكثرة
• أرشفة البيانات: أرشف البيانات القديمة لتحسين أداء الاستعلامات
• المستخدمون المتزامنون: راقب حدود اتصال قاعدة البيانات
• نوافذ الصيانة: جدول صيانة قاعدة بيانات منتظمة

التحسين على جانب العميل

• صيانة المتصفح: مسح التخزين المؤقت بانتظام، وتحديث المتصفح
• تحسين الشبكة: اتصال إنترنت مستقر، وتجنّب ساعات الذروة
• أداء الجهاز: ذاكرة وصول عشوائي كافية، وإغلاق التطبيقات غير الضرورية
• دقة الشاشة: حسّن إعدادات العرض لـ BigLedger

العوامل على جانب الخادم

• أوقات الاستخدام في الذروة: افهم أنماط حمل النظام
• حجم البيانات: التقارير والاستعلامات الكبيرة تؤثر على الأداء
• حمل التكامل: عمليات التكامل المتزامنة المتعددة تؤثر على السرعة
• نوافذ الصيانة: الصيانة المجدولة تؤثر على التوفّر

أداء البيانات

• تحسين الاستعلامات: استخدم المرشحات والنطاقات الزمنية المناسبة
• كفاءة التقارير: قيّد نطاق البيانات للتقارير الكبيرة
• المعالجة الدفعية: اجمع العمليات المتشابهة معًا
• استراتيجية الأرشفة: أرشف البيانات القديمة لتحسين الأداء

إجراءات التصعيد

متى تصعّد

• الحوادث الأمنية: تصعيد فوري لخروقات الأمان
• انقطاعات النظام: عندما يكون النظام غير متاح تمامًا
• تلف البيانات: أي مشكلات مشتبهة في سلامة البيانات
• التأثير التجاري الحرج: المشكلات التي تؤثر على عمليات العمل الأساسية

كيفية التصعيد

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

موارد الخدمة الذاتية

قاعدة المعرفة

• قسم الأسئلة الشائعة - إجابات على الأسئلة المتكررة
• الدروس المرئية - أدلة مرئية خطوة بخطوة
• منتديات المستخدمين - دعم مدفوع من المجتمع
• التوثيق - أدلة مستخدم شاملة

أدوات التشخيص

• فحص صحة النظام - تشخيصات نظام مدمجة
• اختبار الاتصال - اختبار الشبكة والتكامل
• مدقق الصلاحيات - التحقق من حقوق وصول المستخدم
• مراقب الأداء - مقاييس أداء النظام

استراتيجيات الوقاية

الصيانة الاستباقية

• التحديثات المنتظمة: أبقِ المتصفح والنظام محدّثين
• برامج التدريب: تعليم وتدريب مستمر للمستخدمين
• مراقبة النظام: فحوصات صحة منتظمة ومراقبة الأداء
• النسخ الاحتياطي للبيانات: حافظ على نسخ احتياطية حالية وإجراءات استرداد

أفضل الممارسات

• التوثيق: أبقِ الإجراءات موثّقة وحديثة
• الاختبار: اختبر التغييرات في بيئة التجهيز قبل الإنتاج
• التواصل: أبلغ المستخدمين بتغييرات النظام وتحديثاته
• المراقبة: أعدّ تنبيهات لمقاييس النظام الحرجة

الحصول على المساعدة

قنوات الدعم

• 📧 دعم البريد الإلكتروني: vincent@bigledger.com للمشكلات التقنية
• 💬 دردشة سريعة: تيليجرام @leehongfay للأسئلة الفورية
• 📞 الدعم الهاتفي: متاح خلال ساعات العمل
• 🌐 بوابة الدعم: نظام تذاكر عبر الإنترنت وقاعدة معرفة

معلومات الدعم التي يجب تقديمها

• وصف المشكلة: شرح واضح للمشكلة
• خطوات إعادة الإنتاج: كيفية إعادة إنشاء المشكلة
• رسائل الخطأ: النص الدقيق لأي رسائل خطأ
• معلومات المستخدم: تفاصيل الحساب والصلاحيات
• تفاصيل النظام: معلومات المتصفح والجهاز والشبكة
• التأثير التجاري: كيف تؤثر المشكلة على عملياتك

توقعات وقت الاستجابة

• المشكلات الحرجة: وقت استجابة 1-2 ساعة
• الأولوية العالية: وقت استجابة 4-8 ساعات
• المشكلات العادية: وقت استجابة 1-2 يوم عمل
• طلبات التحسين: تُراجَع في دورات التخطيط الشهرية