تتبع استخدام الخدمة ورصيدها

يوفر نظام استخدام الخدمة مراقبة في الوقت الحقيقي لاستهلاك العملاء للبيانات والمكالمات الصوتية والرسائل القصيرة والأرصدة النقدية. تتكامل هذه الميزة مع نظام OCS (نظام الشحن عبر الإنترنت) لعرض الاستخدام الحالي، والبدلات المتبقية، ومعلومات انتهاء صلاحية الرصيد لكل من العملاء (عبر بوابة الخدمة الذاتية) والموظفين.

نظرة عامة

يمكن تتبع الاستخدام:

• عرض الرصيد في الوقت الحقيقي - عرض الاستخدام الحالي والبدلات المتبقية
• أنواع رصيد متعددة - تتبع أرصدة البيانات والمكالمات الصوتية والرسائل القصيرة والنقدية في نفس الوقت
• مراقبة انتهاء الصلاحية - رؤية متى تنتهي صلاحية الأرصدة
• تفصيل الرصيد - عرض تفصيلي لسلل الرصيد الفردية
• تحديث تلقائي - تحديثات الاستخدام كل 3 ثوانٍ تلقائيًا

الوصول إلى استخدام الخدمة

من قائمة الخدمات:

1. انتقل إلى الخدمات → قائمة الخدمات
2. انقر على قائمة الإجراءات (⋮) بجوار خدمة
3. اختر "الاستخدام"

من تفاصيل الخدمة:

1. افتح صفحة تفاصيل الخدمة
2. انقر على علامة التبويب "الاستخدام"

من صفحة العميل:

1. افتح نظرة عامة على العميل
2. انتقل إلى علامة التبويب الخدمات
3. انقر على "عرض الاستخدام" بجوار أي خدمة

يفتح نموذج الاستخدام أو الصفحة ويظهر بيانات الاستهلاك في الوقت الحقيقي.

عرض الاستخدام

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

{.align-center width="800px"}

بطاقات الملخص

تظهر الصف العلوي بطاقات عرض سريعة لكل نوع من أنواع الرصيد:

معلومات البطاقة:

• نوع الرصيد - أيقونة وملصق (بيانات، صوت، رسائل قصيرة، نقدية)
• المبلغ المتبقي - الرصيد الحالي بالوحدات المناسبة
• وقت انتهاء الصلاحية - الأيام/الساعات حتى انتهاء صلاحية الرصيد
• زر المزيد من المعلومات - انقر للتوسع في التفصيل المفصل

شرائط التقدم

أسفل البطاقات، تظهر شرائط التقدم الاستهلاك بصريًا مع أجزاء ممتلئة تشير إلى الرصيد المتبقي.

ميزات شريط التقدم:

• مؤشر بصري - الجزء المملوء يظهر الرصيد المتبقي
• النسبة المئوية - النسبة المئوية الرقمية من الرصيد المتبقي
• القيم المطلقة - تظهر المستخدمة مقابل الإجمالي (على سبيل المثال، "12.5GB / 20GB")
• ترميز الألوان:
  • أخضر: >50% متبقي
  • أصف��: 20-50% متبقي
  • أحمر: <20% متبقي
• قابل للنقر - انقر للتوسع في التفصيل المفصل

أنواع الأرصدة

رصيد البيانات

يتتبع استهلاك بيانات الإنترنت.

الوحدات: جيجابايت (GB) أو ميجابايت (MB)

تنسيق العرض:

التقدم: 12.5GB / 20GB (62%)

السيناريوهات الشائعة:

• خطط البيانات المتنقلة - 5GB، 10GB، 20GB بدلات شهرية
• اللاسلكي الثابت - غير محدود أو محدد بمبالغ عالية (500GB، 1TB)
• إعادة الشحن - بيانات إضافية تم شراؤها في منتصف الدورة
• خدمات الدونجل - بيانات مسبقة الدفع لأجهزة النقاط الساخنة

سلل متعددة:

غالبًا ما تحتوي الخدمات على أرصدة بيانات متعددة:

• بدل شهري (تنتهي شهريًا)
• بيانات إضافية (تنتهي بعد فترة الحملة)
• بيانات إعادة الشحن (انتهاء صلاحية أقصر، تُستهلك أولاً)

رصيد الصوت

يتتبع دقائق المكالمات الهاتفية.

الوحدات: دقائق (min)

تنسيق العرض:

التقدم: 125 min / 500 min (25%)

تتبع مدة المكالمات:

• المكالمات الواردة (إذا كانت مدفوعة)
• المكالمات الصادرة
• المكالمات الدولية (سلّة منفصلة إذا كانت قابلة للتطبيق)
• الأرقام المميزة

الحساب:

يتم حساب استخدام الصوت حسب مدة المكالمة بالنانoseconds داخليًا، ويتم تحويلها إلى دقائق للعرض.

رصيد الرسائل القصيرة

يتتبع استخدام الرسائل النصية.

الوحدات: رسائل (msgs)

تنسيق العرض:

التقدم: 45 / 250 (18%)

أنواع الرسائل:

• SMS القياسية (160 حرفًا)
• SMS الطويلة (عدة مقاطع)
• MMS (إذا تم تتبعها بشكل منفصل)

رصيد النقد

يتتبع رصيد الائتمان المسبق الدفع أو رصيد الحساب.

الوحدات: عملة (£، $، €، إلخ.)

تنسيق العرض:

التقدم: £15.50 / £20.00 (77%)

الاستخدام:

• تستخدم الحسابات المسبقة الدفع الرصيد النقدي لدفع الاستخدام
• يتم تقليل الائتمان م�� استخدام العميل للخدمات
• يمكن إعادة شحنه عبر الدفع أو القسيمة
• قد تنتهي صلاحيته إذا لم يتم استخدامه خلال فترة الصلاحية

تفصيل الرصيد المفصل

انقر على "المزيد من المعلومات" على أي بطاقة أو انقر على شريط التقدم لتوسيع التفصيل المفصل.

عرض موسع:

📦 بدل شهري 20GB

: المتبقي: 12.5 GB المستخدم: 7.5 GB تنتهي صلاحيته: 25 يناير 2025 (15 يومًا) الوزن: 10

📦 بيانات إضافية 5GB

: المتبقي: 5.0 GB المستخدم: 0 GB تنتهي صلاحيته: 31 يناير 2025 (21 يومًا) الوزن: 20

📦 بيانات إعادة الشحن 3GB

: المتبقي: 0 GB المستخدم: 3.0 GB تنتهي صلاحيته: 18 يناير 2025 (منتهية الصلاحية) الوزن: 30

المجموع المتبقي: 17.5 GB

حقول سلة الرصيد:

• ID/الاسم - معرف لسلة الرصيد
• المتبقي - المبلغ المتبقي في هذه السلة المحددة
• المستخدم - المبلغ المستهلك من هذه السلة
• تاريخ انتهاء ��لصلاحية - متى تنتهي صلاحية هذا الرصيد
• الوزن - ترتيب الأولوية (يتم استهلاك الوزن الأعلى أولاً)

نظام الوزن

تمتلك الأرصدة قيمة وزن تحدد ترتيب الاستهلاك:

• وزن أعلى = يُستهلك أولاً
• وزن أقل = يُستهلك آخرًا

أمثلة على الأوزان:

• بيانات إعادة الشحن: الوزن 30 (يُستهلك أولاً، انتهاء صلاحية أقصر)
• البيانات الإضافية: الوزن 20 (يُستهلك ثانيًا)
• بدل شهري: الوزن 10 (يُستهلك آخرًا، انتهاء صلاحية أطول)

هذا يضمن أن الأرصدة التي على وشك الانتهاء تُستخدم قبل الأرصدة الأطول عمراً.

التحديثات في الوقت الحقيقي

تتجدد بيانات الاستخدام تلقائيًا كل 3 ثوانٍ عبر الاستطلاع.

ما يتم تحديثه:

• المبالغ الحالية للرصيد
• شرائط تقدم الاستخدام
• مؤقتات انتهاء الصلاحية
• تفاصيل سلة الرصيد الفردية

تجربة المستخدم:

• لا حاجة لإعادة تحميل ��لصفحة
• تحديثات سلسة دون وميض
• تحميل overlay أثناء التحديث
• شارة الحالة تظهر حالة الخدمة الحالية

حالات الاستخدام:

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

الاستخدام في أنواع الخدمات المختلفة

الخدمات المتنقلة

عرض جميع أنواع الأرصدة الأربعة:

• البيانات (GB)
• الصوت (دقائق)
• الرسائل القصيرة (رسائل)
• النقدية (عملة)

مثال:

البيانات: 12.5GB المتبقية الصوت: 125 min المتبقية الرسائل القصيرة: 45 msgs المتبقية النقدية: £15.50 المتبقية

اللاسلكي الثابت / الإنترنت

عادةً ما يظهر فقط:

• البيانات (GB أو TB)
• النقدية (إذا كانت مسبقة الدفع)

مثال:

البيانات: 450GB / 500GB المتبقية النقدية: £45.00 (رصيد مسبق الدفع)

خدمات النقاط الساخنة / الد��نجل

يظهر تتبع البيانات المحددة للدونجل:

• البيانات (المستهلكة مقابل المسبقة الدفع)
• النقدية (رصيد مسبق الدفع)

وضع العرض:

عندما يكون dongle=true، يخفي المكون الصوت والرسائل القصيرة، ويظهر فقط البيانات ذات الصلة والأرصدة النقدية.

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

الاستخدام يظهر كـ 0 / 0

• السبب: الخدمة غير متكاملة مع OCS أو CGRateS
• الإصلاح:
  • تحقق من أن الخدمة مهيأة في OCS
  • تحقق من اتصال واجهة برمجة التطبيقات OCS
  • مراجعة تعيين UUID الخدمة

الاستخدام لا يتحدث

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

الأرصدة تظهر مبالغ غير صحيحة

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

تاريخ انتهاء الصلاحية مفقود

• السبب: الرصيد ليس له تاريخ انتهاء محدد
• الإصلاح:
  • بعض الأرصدة محددة بأنها لا تنتهي أبدًا (صلاحية غير محدودة)
  • تحقق من تكوين الرصيد في OCS

الأرصدة المتعددة مربكة

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

التكامل مع OCS/CGRateS

تأتي بيانات الاستخدام من OCS (نظام الشحن عبر الإنترنت)، عادةً CGRateS.

تدفق البيانات:

1. يفتح المستخدم عرض الاستخدام
2. يستدعي OmniCRM GET /crm/service/{service_id}
3. تستعلم واجهة برمجة التطبيقات OCS عبر UUID الخدمة
4. تعيد OCS خريطة الرصيد:

{
  "BalanceMap": {
    "*data": [
      {
        "ID": "monthly_data_20GB",
        "Value": 13421772800,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*voice": [
      {
        "ID": "monthly_voice_500min",
        "Value": 7500000000000,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*sms": [
      {
        "ID": "monthly_sms_250",
        "Value": 250,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*monetary": [
      {
        "ID": "prepaid_credit",
        "Value": 1550,
        "ExpiryTime": "2025-02-25T23:59:59Z",
        "Weight": 10
      }
    ]
  }
}

5. تقوم واجهة المستخدم بتحويل القيم إلى وحدات العرض (بايت → GB، نانوثانية → دقائق)
6. يتم عرض شرائط التقدم والبطاقات
7. يستمر الاستطلاع كل 3 ثوانٍ

تعيين أنواع الأرصدة في OCS:

تعود OCS ببيانات الرصيد مع بادئات الأنواع التي تتوافق مع عرض واجهة المستخدم:

• *data → بطاقة البيانات (استخدام الإنترنت)
• *voice → بطاقة الص��ت (دقائق المكالمات)
• *sms → بطاقة الرسائل القصيرة (الرسائل النصية)
• *monetary → بطاقة النقدية (رصيد مسبق الدفع)

يمكن أن تحتوي كل نوع من أنواع الأرصدة على سلال متعددة (على سبيل المثال، بدل شهري + بيانات إضافية + بيانات إعادة الشحن)، جميعها معروضة في عرض التفصيل المفصل.

تحويلات قيمة الرصيد:

• البيانات: بايت → GB (قسم على 1024³)
• الصوت: نانوثانية → دقائق (قسم على 60×10⁹)
• الرسائل القصيرة: العدد (لا تحويل)
• النقدية: سنتات → عملة (قسم على 100)

التجديد التلقائي وخطط العمل

تحتوي الخدمات المفعلة للتجديد التلقائي على خطط عمل مجدولة في OCS.

ما هي خطط العمل؟

خطط العمل هي مهام مجدولة في CGRateS يتم تنفيذها تلقائيًا في أوقات محددة لـ:

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

كيف يعمل التجديد التلقائي:

1. توفير الخدمة:

   • عند إنشاء الخدمة مع auto_renew = true
   • يقوم كتاب توفير الخدمة بإنشاء خطة عمل في OCS
   • يتم تكوين خطة العمل لتعمل شهريًا (أو لكل دورة فواتير)

2. تكوين خطة العمل:

   تحتوي خطة العمل على:

   • معرف الحساب - UUID الخدمة
   • الإجراءات - ما يجب القيام به (إضافة بيانات، صوت، رسائل قصيرة، رصيد نقدي)
   • الجدول الزمني - متى يتم التنفيذ (على سبيل المثال، شهريًا في اليوم الأول عند 00:00 UTC)
   • المبلغ - كم من الرصيد يجب إضافته

3. التنفيذ التلقائي:

   • تنفذ OCS خطة العمل في الوقت المحدد
   • تضيف رصيدًا إلى الحساب (على سبيل المثال، 20GB بيانات، 500 دقيقة صوت)
   • تحدد تاريخ انتهاء صلاحية الرصيد الجديد (على سبيل المثال، 30 يومًا)
   • يتم تحصيل رسوم من العميل عبر طريقة الدفع المسجلة

4. عرض خطط العمل:

   • انتقل إلى تفاصيل الخدمة في عرض OCS
   • يتم سرد خطط العمل مع وقت التنفيذ التالي
   • يظهر: اسم الخطة، تاريخ التشغيل التالي، تفاصيل الإجراء

مثال على خطة العمل:

{
  "ActionPlanId": "ProductID_MonthlyPlan__ProductName_20GB_Mobile__ActionPlan_Monthly_Renew",
  "NextExecTime": "2025-02-01T00:00:00+00:00",
  "ActionName_hr": "التجديد الشهري",
  "PlanName": "20GB Mobile",
  "ActionFrequency_hr": "كل خطة شهرية",
  "custom_NextExecTime_hr": "في 22 يومًا"
}

إدارة التجديد التلقائي:

• تفعيل - يتم تعيينه أثناء إنشاء الخدمة أو تعديلها
• تعطيل - إزالة خطة العمل من OCS (تحتفظ الخدمة بالرصيد الحالي ولكن لن يتم تجديده تلقائيًا)
• تعديل - تغيير مبلغ التجديد أو التكرار عبر تعديل الخدمة

التجديد اليدوي:

إذا تم تعطيل التجديد التلقائي، يجب على العميل يدويًا:

• إعادة الشحن قبل انتهاء صلاحية الرصيد
• أو تتوقف الخدمة عندما ينفد الرصيد

العرض في واجهة المستخدم:

تظهر علامة تبويب الخدمات حالة التجديد التلقائي:

التجديد التالي: 1 فبراير 2025 (في 22 يومًا) مبلغ التجديد: £15.00

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

لفريق الدعم:

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

للعملاء (الخدمة الذاتية):

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

للمسؤولين:

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

الوثائق ذات الصلة

• features_topup_recharge - نظام إعادة الشحن لإضافة الرصيد
• csa_service_management - إدارة الخدمات
• csa_modify - إضافة إضافات لزيادة البدلات
• concepts_products_and_services - تكوين المنتج