انتقل إلى المحتوى الرئيسي

دليل العمليات

📖 العودة إلى الوثائق الرئيسية

يغطي هذا المستند ميزات المراقبة والإدارة التشغيلية المتاحة في لوحة التحكم.

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

الوثائق الأساسية​

أدوات المراقبة والاختبار​

معالجة المكالمات والخدمات​

واجهات التكامل​

العمليات​

تغطي هذه القسم ميزات المراقبة والإدارة التشغيلية المتاحة في لوحة التحكم OmniTAS.

جدول المحتويات​

عرض المشتركين​

يوفر عرض المشتركين مراقبة في الوقت الحقيقي لتسجيلات المشتركين في IMS المخزنة في قاعدة بيانات تسجيل SIP الخاصة بـ Sofia.

الوصول: انتقل إلى /subscribers في لوحة التحكم

الميزات​

  • قائمة التسجيلات: عرض جميع تسجيلات المشتركين النشطة
  • تفاصيل التسجيل: انقر على أي تسجيل لعرض التفاصيل الكاملة بما في ذلك:
    • مستخدم SIP والمجال
    • URI الاتصال
    • حالة التسجيل والانتهاء
    • معلومات الشبكة (IP، المنفذ، اسم المضيف)
    • تفاصيل المصادقة
    • موقع برج الهاتف المحمول (عند توفره عبر P-Access-Network-Info)
      • MCC/MNC، نوع الراديو، TAC/LAC، معرف البرج
      • الإحداثيات الجغرافية ونطاق التغطية
      • عرض خريطة تفاعلية مدعومة من بيانات OpenStreetMap وOpenCellID

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

يتم استعلام بيانات التسجيل مباشرة من قاعدة بيانات تسجيل Sofia، مما يوفر رؤية في الوقت الحقيقي لحالة ارتباط المشتركين. يتم حل مواقع أبراج الهاتف المحمول باستخدام قاعدة بيانات OpenCellID عندما يقدم المشتركون رؤوس P-Access-Network-Info في رسائل SIP REGISTER الخاصة بهم.

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

  • مراقبة تسجيلات المشتركين النشطة
  • التحقق من حالة ارتباط المشتركين
  • استكشاف مشكلات التسجيل
  • تدقيق اتصال المشتركين

سجلات تفاصيل المكالمات (CDR)​

يوفر عرض CDR الوصول إلى سجلات تفاصيل المكالمات المخزنة بواسطة TAS لأغراض الفوترة واستكشاف الأخطاء وتحليل البيانات.

الوصول: انتقل إلى /cdr في لوحة التحكم

الميزات​

  • عرض مقسم: تصفح سجلات المكالمات (100 لكل صفحة مع عناصر التحكم السابقة/التالية)
  • بحث متقدم: بحث قوي يدعم المطابقة الدقيقة، العكس/الاستبعاد، والعديد من المصطلحات
  • اختيار الأعمدة: تخصيص الحقول التي سيتم عرضها
    • انقر على زر "الأعمدة" لفتح نافذة اختيار الأعمدة
    • حدد/ألغِ تحديد الأعمدة الفردية
    • إجراءات سريعة تحديد الكل / إلغاء تحديد الكل
    • يستمر الاختيار عبر الجلسات (يتم حفظه في localStorage للمتصفح)
    • يظهر عداد "X / Y الأعمدة"
  • أعمدة قابلة للفرز: انقر على أي رأس عمود للفرز (تصاعدي/تنازلي)
    • مؤشرات بصرية (▲ تصاعدي، ▼ تنازلي)
    • يتم تمييز العمود المفروز باللون الأزرق
    • يتم إعادة تعيينه إلى الصفحة 1 عند تغيير الفرز
  • خيارات تصفية متعددة:
    • بحث نصي: البحث عبر جميع الحقول مع مشغلين متقدمين
    • تصفية نطاق التاريخ: التصفية حسب تاريخ ووقت البدء/الانتهاء (اختيار التاريخ والوقت)
    • تصفية محددة بالحقول: التصفية حسب قيمة حقل معينة (سبب الإنهاء، معرف المتصل، الوجهة، السياق)
    • عرض التصفية النشطة: تظهر الشرائح البصرية الفلاتر النشطة حاليًا
    • مسح الكل: إزالة جميع الفلاتر النشطة بنقرة واحدة
  • معلومات مفصلة: انقر على أي صف CDR للتوسع وعرض جميع الحقول:
    • أطراف المكالمة (اسم/رقم معرف المتصل، رقم الوجهة)
    • الطوابع الزمنية (البداية، الإجابة، النهاية)
    • المدة والثواني المفوترة
    • سبب الإنهاء (ملون: أخضر=طبيعي، أصفر=ملغي، أحمر=خطأ)
    • UUIDs للمكالمة (A-leg وB-leg)
    • السياق ورمز الحساب
    • جميع الحقول المتاحة في قاعدة البيانات بترتيب أبجدي
  • أسباب الإنهاء الملونة:
    • 🟢 أخضر: NORMAL_CLEARING
    • 🟡 أصفر: المكالمات الملغاة
    • 🔴 أحمر: حالات الخطأ
  • العدد الإجمالي: عرض في الوقت الحقيقي للعدد الإجمالي للسجلات المطابقة
  • تصميم متجاوب: تلتف الفلاتر بشكل مناسب على الشاشات الأصغر

كيفية الاستخدام​

  1. عرض أساسي:

    • يتم تحميل الصفحة مع أحدث 100 سجل CDR (مرتبة حسب start_stamp تنازليًا)
    • يتم عرض العدد الإجمالي للسجلات في الزاوية العليا اليمنى
    • استخدم أزرار السابق / التالي للتنقل بين الصفحات
    • انقر على أي صف للتوسع ورؤية جميع الحقول

  2. تخصيص الأعمدة:

    • انقر على زر "الأعمدة" في الزاوية العليا اليمنى
    • تظهر نافذة تحتوي على جميع الحقول المتاحة
    • تحقق/ألغِ تحديد الحقول لعرض/إخفاء الأعمدة
    • استخدم "تحديد الكل" أو "إلغاء تحديد الكل" للاختيار السريع
    • يتم حفظ الإعدادات تلقائيًا في المتصفح
    • أغلق النافذة لتطبيق التغييرات

  3. فرز البيانات:

    • انقر على أي رأس عمود للفرز حسب هذا الحقل
    • النق�� الأول: تنازلي (▼)
    • النقر الثاني: تصاعدي (▲)
    • النقر الثالث: العودة إلى التنازلي
    • يتم تمييز العمود المفروز باللون الأزرق

  4. البحث عن السجلات:

    • أدخل استعلام البحث في مربع "البحث"
    • يدعم مشغلين متقدمين (انظر بناء جملة البحث أدناه)
    • يبحث عبر عدة حقول: caller_id_number، destination_number، uuid، caller_id_name، hangup_cause
    • انقر على "تطبيق" لتنفيذ البحث

  5. تصفية حسب نطاق التاريخ:

    • استخدم اختيارات التاريخ "تاريخ البدء" و**"تاريخ الانتهاء"**
    • يتطلب كلا التاريخين لتصفية التاريخ
    • يدعم اختيار التاريخ والوقت
    • انقر على "تطبيق" للتصفية

  6. تصفية حسب حقل محدد:

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

  7. دمج الفلاتر:

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

  8. عرض التفاصيل:

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

بناء جملة البحث المتقدم​

يدعم مربع البحث بناء جملة قوي لاستعلام دقيق عبر سجلات متعددة في وقت واحد.

كيف يعمل البحث:

يتحقق محرك البحث من جميع الحقول القابلة للبحث في كل سجل CDR. يتم تضمين سجل في النتائج عندما يتطابق مع معايير البحث الخاصة بك في أي من هذه الحقول:

  • caller_id_number
  • destination_number
  • uuid
  • caller_id_name
  • hangup_cause

��شغلات البحث (يمكن دمجها):

  1. بحث يحتوي (افتراضي):

    • بناء الجملة: term (بدون علامات اقتباس)
    • المطابقة: السجلات حيث أي حقل يحتوي على المصطلح في أي مكان داخلها
    • SQL: يستخدم LIKE '%term%' عبر جميع الحقول القابلة للبحث المرتبطة بـ OR
    • مثال: 61480 يتطابق مع "61480123456"، "55561480999"، إلخ.

  2. مطابقة دقيقة:

    • بناء الجملة: "term" (مع علامات اقتباس مزدوجة)
    • المطابقة: السجلات حيث أي حقل يساوي بالضبط المصطلح
    • SQL: يستخدم = 'term' عبر جميع الحقول القابلة للبحث المرتبطة بـ OR
    • مثال: "911" يتطابق فقط مع "911" بالضبط، وليس "9115" أو "1911"

  3. عكس/استبعاد:

    • بناء الجملة: !term (علامة التعجب في المقدمة، بدون علامات اقتباس)
    • المطابقة: السجلات حيث لا يوجد حقل يحتوي على المصطلح
    • SQL: يستخدم NOT LIKE '%term%' عبر جميع الحقول القابلة للبحث المرتبطة بـ AND
    • مثال: !NORMAL يستبعد أي سجل يحتوي على "NORMAL" في أي حقل

  4. عكس/استبعاد دقيق:

    • بناء الجملة: !"term" (علامة التعجب + علامات اقتباس مزدوجة)
    • المطابقة: السجلات حيث لا يوجد حقل يساوي بالضبط المصطلح
    • SQL: يستخدم != 'term' عبر جميع الحقول القابلة للبحث المرتبطة بـ AND
    • مثال: !"NORMAL_CLEARING" يستبعد السجلات حيث أي حقل يساوي بالضبط "NORMAL_CLEARING"

  5. مصطلحات متعددة مع AND:

    • بناء الجملة: term1 AND term2 (AND غير حساسة لحالة الأحرف)
    • المطابقة: السجلات التي تطابق جميع المصطلحات (يمكن أن تتطابق كل مصطلح مع حقول مختلفة)
    • تتم معالجة كل مصطلح بمشغل خاص به (علامات الاقتباس، !، إلخ.)
    • يتم دمج المصطلحات مع AND في SQL
    • مثال: "911" AND "12345" يجد السجلات التي تحتوي على "911" في حقل واحد و "12345" في آخر

منطق تنفيذ البحث:

لكل سجل CDR:
  للبحث العادي (بدون !):
    - تحقق مما إذا كان أي حقل يحتوي/يساوي المصطلح → تضمين إذا كان TRUE
    - SQL: field1 LIKE '%term%' OR field2 LIKE '%term%' OR ...

  للبحث العكسي (!):
    - تحقق مما إذا كانت جميع الحقول لا تحتوي/تساوي المصطلح → تضمين إذا كان TRUE
    - SQL: field1 NOT LIKE '%term%' AND field2 NOT LIKE '%term%' AND ...

  للبحث باستخدام AND:
    - يتم تقييم كل مصطلح بشكل منفصل
    - يجب أن تكون جميع شروط المصطلح TRUE → تضمين إذا كان TRUE
    - SQL: (term1_conditions) AND (term2_conditions) AND ...

أمثلة بحث معقدة:

الاستعلامكيف يعملالنتيجة
61480بحث يحتوي عبر جميع الحقولجميع السجلات التي تحتوي على "61480" في أي مكان (المتصل، الوجهة، UUID، إلخ.)
"911"مطابقة دقيقة عبر جميع الحقولالسجلات حيث أي حقل يساوي بالضبط "911"
!NORMAL_CLEARINGبحث عكسي يحتوييستبعد السجلات التي تحتوي على "NORMAL_CLEARING" في أي حقل (المكالمات الفاشلة)
!"NORMAL_CLEARING"عكس دقيقيستبعد السجلات حيث أي حقل يساوي بالضبط "NORMAL_CLEARING"
"911" AND "12345""911" دقيقة و "12345" دقيقةالسجلات التي تحتوي على كلا القيمتين (مثل، المتصل="12345"، الوجهة="911")
!NORMAL AND 61480عكس يحتوي على "NORMAL" و يحتوي على "61480"مكالمات غير طبيعية تتضمن "61480"
!"ANSWER" AND !NORMALعكس دقيق "ANSWER" و عكس يحتوي على "NORMAL"استبعاد المكالمات الم answered وأي شيء يحتوي على "NORMAL"
61480 AND !NORMAL_CLEARINGيحتوي على "61480" و عكس يحتوي على "NORMAL_CLEARING"مكالمات فاشلة تتضمن "61480"

حالات الاستخدام العملية:

  • البحث عن رقم محدد: 61480123456 - بحث يحتوي يجد المطابقات الجزئية
  • البحث عن مكالمات الطوارئ الدقيقة: "911" - فقط المكالمات إلى "911" بالضبط
  • جميع المكالمات الفاشلة: !NORMAL_CLEARING - استبعاد المكالمات الناجحة
  • مكالمات فاشلة لمتصل محدد: "61480123456" AND !NORMAL - دمج المتصل الدقيق مع العكس
  • استبعاد الأرقام التجريبية: !test AND !demo - عمليات بحث عكسية متعددة
  • استكشاف الأخطاء المعقدة: 61480 AND !"ANSWER" AND !CANCEL - يحتوي على مصطلح واحد، استبعاد الآخرين الدقيقة والجزئية

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

يتم استعلام بيانات CDR مباشرة من قاعدة بيانات CDR SQLite الخاصة بـ TAS.

قد يختلف المخطط بين النشر بناءً على المتطلبات المحددة.

خيارات تصدير CDR​

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

مخطط قاعدة بيانات CDR وتنسيقات التصدير تعتمد على النشر. عند إعداد نظامك، يرجى طلب تنسيقات مخرجات CDR المحددة التي تحتاجها من مهندس التكامل الخاص بك. تشمل تنسيقات التصدير الشائعة:

  • CSV (قيم مفصولة بفواصل)
  • JSON (للتكامل مع API)
  • XML
  • الوصول المباشر إلى قاعدة البيانات
  • تصديرات بتنسيق مخصص

يمكن لمهندس التكامل الخاص بك تكوين آليات تصدير CDR مصممة لتلبية احتياجاتك التشغيلية والفوترة.

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

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

التكوين​

الأعمدة المرئية الافتراضية​

يمكنك تكوين الحقول التي يتم عرضها افتراضيًا في LiveView عن طريق تعيين cdrs_field_list في config/runtime.exs الخاص بك:

config :tas,
  cdrs_field_list: [
    "caller_id_number",
    "destination_number",
    "start_stamp",
    "duration",
    "hangup_cause"
  ]

السلوك:

  • إذا لم يتم تعيين cdrs_field_list: يتم عرض جميع حقول CDR المتاحة افتراضيًا
  • إذا تم تعيين cdrs_field_list: يتم عرض الحقول المحددة فقط افتراضيًا، ولكن تظل جميع الحقول الأخرى متاحة في مختار الأعمدة
  • إذا كان حقل في القائمة غير موجود في بيانات CDR، فسيتم تخطيه تلقائيًا
  • يمكن تحديد أسماء الحقول كسلاسل أو ذرات
  • يمكن للمستخدمين اختيار أعمدة إضافية يدويًا من مختار الأعمدة في أي وقت

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

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

مثال على التكوين:

# عرض معلومات المكالمات الأساسية فقط افتراضيًا
cdrs_field_list: [
  "start_stamp",
  "caller_id_number",
  "destination_number",
  "duration",
  "billsec",
  "hangup_cause"
]

ملاحظة: يقوم هذا التكوين بتعيين الأعمدة المرئية الافتراضية. تظل جميع حقول CDR متاحة في مختار "الأعمدة" - يمكن للمستخدمين عرض/إخفاء أي حقل يحتاجونه يدويًا.

الوصول إلى API / برمجي​

لتحليل CDR الآلي، يدعم API Elixir الأساسي جميع ميزات البحث:

# أمثلة API Elixir
Tas.Cdr.get_filtered_records(search: "911")
Tas.Cdr.get_filtered_records(search: "\"911\"")
Tas.Cdr.get_filtered_records(search: "!NORMAL_CLEARING")
Tas.Cdr.get_filtered_records(search: "\"911\" AND \"12345\"")

انظر lib/cdr/cdr.ex للحصول على الوثائق الكاملة لـ API.

استكشاف الأخطاء​

لم يتم العثور على نتائج​
  1. تحقق من الأخطاء المطبعية في مصطلحات البحث
  2. حاول إزالة علامات الاقتباس للبحث بشكل أوسع
  3. تحقق من وجود المصطلح في الحقول القابلة للبحث
  4. تحقق من أن نطاق التاريخ ليس صارمًا جدًا
الكثير من النتائج​
  1. أضف المزيد من المصطلحات AND لتضييق النطاق
  2. استخدم المطابقة الدقيقة مع علامات الاقتباس
  3. طبق فلاتر نطاق التاريخ
  4. استخدم الفلاتر المحددة بالحقول
نتائج غير متوقعة​
  1. تذكر أن البحث ينطبق على جميع الحقول القابلة للبحث
  2. تحقق مما إذا كان المصطلح يظهر في حقل غير متوقع (مثل UUID)
  3. استخدم المطابقة الدقيقة لتجنب المطابقات الجزئية
  4. تحقق من منطق العكس (AND مقابل OR)

نصائح​

  • اختيار الأعمدة: إخفاء الأعمدة غير المستخدمة للتركيز على البيانات ذات الصلة وتحسين الأداء
  • دمج الفلاتر: استخدم البحث + نطاق التاريخ + تصفية الحقل معًا لاستعلامات ��قيقة
  • أداء نطاق التاريخ: نطاقات التاريخ الضيقة تعيد نتائج أسرع لقاعدة بيانات كبيرة
  • الفرز للتحليل: الفرز حسب المدة للعثور على المكالمات الطويلة/القصيرة، أو حسب الطابع الزمني لرؤية أنماط المكالمات
  • شرائح الفلاتر النشطة: استخدم الشرائح البصرية للتحقق من الفلاتر النشطة حاليًا
  • الإعدادات الدائمة: يتم حفظ اختيارات الأعمدة لكل متصفح، مما يفيد في مهام التحليل المختلفة
  • التشفير بالألوان: مسح سريع لأسباب الإنهاء - الأخضر جيد، الأحمر يحتاج إلى التحقيق
  • تفاصيل قابلة للتوسيع: انقر على الصفوف لرؤية جميع الحقول دون تشويش العرض الرئيسي
  • مشغلات البحث: اتقن بناء جملة البحث لتصفية قوية:
    • استخدم علامات الاقتباس للمطابقات الدقيقة: "911"
    • استخدم ! للاستبعاد: !NORMAL_CLEARING
    • دمج مع AND: "61480" AND !NORMAL
  • الصفحات: تذكر أن الفلاتر تستمر عبر الصف��ات - استخدم الصفحات لمراجعة مجموعات النتائج الكبيرة

مراقبة المكالمات النشطة​

يعرض عرض المكالمات النشطة معلومات في الوقت الحقيقي حول المكالمات الجارية عبر النظام.

الوصول: انتقل إلى /calls في لوحة التحكم

الميزات​

  • حالة في الوقت الحقيقي: عرض مباشر لجلسات المكالمات النشطة
  • تفاصيل المكالمة: عرض متغيرات القناة ومعلومات حالة المكالمة
  • تتبع UUID: مراقبة معرفات المكالمات لكل من A-leg وB-leg

خادم مؤتمرات IMS​

يوفر خادم مؤتمرات IMS قدرات مؤتمرات متعددة الأطراف تتوافق مع معايير IMS الخاصة بـ 3GPP (RFC 4579، RFC 4575، TS 24.147).

الوصول: انتقل إلى /conference في لوحة التحكم

الوثائق: انظر دليل مستخدم خادم مؤتمرات IMS للحصول على الوثائق التفصيلية

الميزات​

  • مراقبة في الوقت الحقيقي: عرض مباشر للمؤتمرات النشطة والمشاركين
  • ل��حة إحصائيات المؤتمر:
    • عدد المؤتمرات النشطة
    • إجمالي المشاركين عبر جميع المؤتمرات
    • عدد مؤتمرات الفيديو
    • عدد المؤتمرات المقفلة
    • تفاصيل تكوين الخادم (النطاق، MNC/MCC، الحد الأقصى للمشاركين)
  • قائمة المؤتمرات: عرض جميع المؤتمرات النشطة مع:
    • معرف المؤتمر وURI SIP
    • عدد المشاركين الحاليين
    • هوية منشئ المؤتمر
  • تفاصيل المؤتمر: انقر على أي مؤتمر للتوسع وعرض:
    • معلومات المؤتمر الكاملة (الحالة، حالة الفيديو، حالة القفل، حالة التسجيل)
    • قائمة المشاركين الكاملة مع الأدوار والحالات
    • حالة فيديو المشاركين
  • إجراءات التحكم في المؤتمر:
    • قفل/فتح المؤتمرات للتحكم في الوصول
    • تمكين/تعطيل الفيديو للمؤتمرات
    • تحديثات الحالة في الوقت الحقيقي مع ملاحظات الإجراءات
  • تحديث تلقائي: تحديث تلقائي قابل للتكوين (افتراضي: 5 ثواني) للمراقبة في الوقت ا��حقيقي

إدارة وحدة التحكم OmniTAS​

جميع عمليات المؤتمر متاحة أيضًا من خلال وحدة تحكم OmniTAS باستخدام أمر ims_conference:

ims_conference list                    # قائمة بجميع المؤتمرات النشطة
ims_conference info <conf_id>          # عرض تفاصيل المؤتمر
ims_conference stats                   # عرض إحصائيات الخادم
ims_conference lock <conf_id>          # قفل مؤتمر
ims_conference unlock <conf_id>        # فتح مؤتمر
ims_conference video <conf_id> on|off  # التحكم في الفيديو
ims_conference record <conf_id> start|stop  # التحكم في التسجيل
ims_conference add <conf_id> <sip_uri>     # إضافة مشارك
ims_conference remove <conf_id> <uuid>     # إزالة مشارك
ims_conference destroy <conf_id>       # إنهاء المؤتمر

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

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

الامتثال لـ 3GPP​

يطبق خادم المؤتمر المواصفات الرئيسية لمؤتمرات IMS الخاصة بـ 3GPP:

  • TS 24.147: المؤتمرات باستخدام نظام شبكة IM Core
  • RFC 4579: SIP Call Control - المؤتمرات لوكلاء المستخدمين
  • RFC 4575: حزمة حدث SIP لحالة المؤتمر
  • RFC 5239: إطار عمل للمؤتمرات المركزية

حالة البوابة​

راقب حالة وصحة بوابات SIP/الخطوط المتصلة بـ TAS.

الوصول: انتقل إلى /gw في لوحة التحكم

الميزات​

  • حالة التسجيل: عرض حالة تسجيل البوابة
  • إحصائيات المكالمات: تتبع المكالمات الواردة/الصادرة والإخفاقات
  • مراقبة Ping: أوقات ping SIP OPTIONS وقابلية الوصول
  • تفاصيل البوابة: معلومات التكوين والحالة الكاملة

الق��اسات المراقبة​

  • حالة تسجيل SIP
  • وقت ping (متوسط وقت استجابة SIP OPTIONS)
  • وقت التشغيل (بالثواني منذ إعادة تشغيل الملف الشخصي)
  • المكالمات الواردة / المكالمات الصادرة
  • المكالمات الفاشلة الواردة / المكالمات الفاشلة الصادرة
  • آخر وقت ping وتكراره

حالة نظير Diameter​

راقب اتصال نظير Diameter لواجهات Sh وRo.

الوصول: انتقل إلى /diameter في لوحة التحكم

الميزات​

  • حالة النظير: حالة الاتصال لكل نظير تم تكوينه
  • دعم التطبيق: عرض التطبيقات المدعومة من Diameter (Sh، Ro)
  • حالة مراقبة Watchdog: مراقبة Watchdog Diameter

عارض السجلات​

عارض سجلات موحد في الوقت الحقيقي لكل من TAS Backend (Elixir) وTAS Call Processing (FreeSWITCH).

الوصول: انتقل إلى /logs في لوحة التحكم

الميزات​

  • تيار سجلات موحد: عرض السجلات من كل من TAS Backend وCall Processing في واجهة واحدة
  • تحديثات في الوقت الحقيقي: بث حي لرسائل السجلات أثناء حدوثها (تحديث تلقائي كل 1 ثانية)
  • مستويات السجلات الملونة:
    • 🟣 الكونسول - رسائل خاصة بالكونسول (بنفسجي/ماجنتا)
    • 🔴 تنبيه/حرج - مشكلات عاجلة تتطلب اهتمامًا فوريًا (أحمر)
    • 🟠 خطأ - حالات الخطأ (أحمر فاتح)
    • 🟡 تحذير - رسائل تحذيرية (أصفر)
    • 🔵 إشعار - رسائل معلوماتية ملحوظة (سماوي)
    • 🔵 معلومات - رسائل معلوماتية عامة (أزرق)
    • ⚪ تصحيح - تسجيلات تصحيح/تفصيلية (رمادي)
  • شارات المصدر:
    • 🔵 TAS Backend - سجلات تطبيق Elixir (شارة زرقاء)
    • 🟣 TAS Call Processing - سجلات FreeSWITCH (شارة بنفسجية)
  • مؤشرات الحدود اليسرى: حدود يسارية ملونة تتطابق مع مستوى السجل للتمرير البصري السريع
  • فلاتر متعددة:
    • فلتر المصدر: جميع المصادر / TAS Backend / TAS Call Processing
    • فلتر المستوى: الكل / الكونسول / تنبيه / حرج / خطأ / تحذير / إشعار / معلومات / تصحيح
    • بحث نصي: بحث في الوقت الحقيقي عن الكلمات الرئيسية عبر رسائل السجلات
  • إيقاف/استئناف: تجميد تدفق السجلات لتحليل إدخالات معينة دون فقدان السياق
  • مسح السجلات: إزالة جميع إدخالات السجل الحالية من العرض
  • عداد السجلات: يظهر السجلات المصفاة مقابل السجلات الإجمالية (مثل، "عرض 150 من 500 سجل")
  • سلوك الذيل: يحتفظ بآخر 500 إدخال سجل للأداء
  • عرض البيانات الوصفية: اسم الملف ورقم السطر لمراجع الشيفرة المصدرية (عند توفرها)
  • عرض قابل للتمرير: حاوية ثابتة الارتفاع مع تمرير تلقائي لأحدث السجلات

كيفية الاستخدام​

  1. عرض أساسي:

    • يتم تحميل الصفحة مع أحدث 500 إدخال سجل من كلا المصدرين
    • تظهر السجلات في الوقت الحقيقي كما يتم إنشاؤها
    • تظهر أحدث السجلات في الأعلى
    • يتم تحديثها تلقائيًا كل 1 ثانية

  2. تصفية حسب المصدر:

    • اختر من القائمة المنسدلة "المصدر":
      • جميع المصادر - عرض سجلات TAS Backend وCall Processing
      • TAS Backend - سجلات تطبيق Elixir فقط
      • TAS Call Processing - سجلات FreeSWITCH/خطة الاتصال فقط
    • يتم تطبيق الفلتر على الفور

  3. تصفية حسب مستوى السجل:

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

  4. البحث عن الكلمات الرئيسية:

    • اكتب في مربع "بحث السجلات..."
    • بحث غير حساس لحالة الأحرف عبر رسائل السجلات
    • يتم تصفيته في الوقت الحقيقي أثناء الكتابة
    • يتحد مع فلاتر المصدر والمستوى

  5. تجميد/استئناف التدفق:

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

  6. مسح السجلات:

    • انقر على زر "مسح" (أحمر) لإزالة جميع السجلات المعروضة
    • يمسح كل من سجلات TAS Backend وCall Processing
    • ستظهر سجلات جديدة أثناء إنشائها

  7. قراءة إدخالات السجل:

    • الطابع الزمني: يظهر الوقت بتنسيق HH:MM:SS.milliseconds
    • شارة المصدر: تشير إلى TAS Backend (أزرق) أو Call Processing (بنفسجي)
    • مستوى السجل: مستوى ملون في الأقواس [ERROR]، [INFO]، إلخ.
    • الملف/السطر: موقع الشيفرة المصدرية (عند توفرها)
    • الرسالة: محتوى رسالة السجل الفعلي

مستويات السجل موضحة​

المستوىاللونمتى يستخدمالمثال
الكونسولبنفسجيرسائل خاصة بالكونسولإخراج كونسول FreeSWITCH عالي الأولوية
تنبيهأحمريتطلب اتخاذ إجراء فوريفشل مكون النظام
حرجأحمرظروف حرجةفقدان اتصال قاعدة البيانات
خطأأحمر فاتححالات الخطأفشل معالجة المكالمة، تكوين غير صالح
تحذيرأصفرحالات التحذيراستخدام وظيفة مهملة، محاولة إعادة
إشعارسماويأحداث عادية ملحوظةإعادة تحميل التكوين، بدء الخدمة
معلوماتأزرقرسائل معلوماتيةتم الاتصال بالمكالمة، تم إرسال طلب Diameter
تصحيحرماديرسائل مستوى تصحيحدخول/خروج الوظيفة، قيم المتغيرات

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

  • استكشاف الأخطاء في الوقت الحقيقي: مراقبة السجلات أثناء المكالمة النشطة لاستكشاف المشكلات
  • تحقيق الأخطاء: تصفية بمستويات الخطأ/الحرج للعثور على المشكلات
  • تحليل تدفق المكالمات: البحث عن Call-ID أو رقم الهاتف لتتبع مسار المكالمة
  • مراقبة الأداء: مراقبة التحذيرات والأخطاء أثناء اختبار التحميل
  • استكشاف الأخطاء في التكامل: تصفية TAS Backend لرؤية رسائل Diameter/Sh/Ro
  • استكشاف الأخطاء في خطة الاتصال: تصفية TAS Call Processing لرؤية توجيه المكالمات في FreeSWITCH
  • مراقبة صحة النظام: الاحتفاظ بالسجلات مفتوحة لمراقبة الشذوذ
  • التطوير والاختبار: استخدام مستوى التصحيح لرؤية سلوك التطبيق التفصيلي

نصائح​

  • دمج الفلاتر: استخدم المصدر + المستوى + البحث معًا للتصفية الدقيقة
    • مثال: المصدر="TAS Backend" + المستوى="خطأ" + البحث="Diameter" → العثور على أخطاء Diameter
  • تجميد قبل البحث: قم بتجميد التدفق قبل كتابة استعلام البحث لتجنب تمرير السجلات
  • استخدام التصحيح بحكمة: مستوى التصحيح مفصل - قم بتصفية المصدر المحدد لتقليل الضوضاء
  • التشفير بالألوان: مسح سريع للحدود اليسارية - الحدود الحمراء تشير إلى المشكلات
  • شارات المصدر: شارات زرقاء (Backend) للمنطق التطبيق، شارات بنفسجية (Call Processing) للمكالمات
  • دقة الطابع الزمني: تساعد الطوابع الزمنية بالمللي ثانية في مطابقة الأحداث عبر الأنظمة
  • مراجع الملفات: انقر/لاحظ مراجع الملف:السطر للقفز إلى الشيفرة المصدرية
  • مسح بانتظام: امسح السجلات عند تغيير سياقات التحقيق من أجل الوضوح
  • البحث عن UUIDs: ابحث عن Call-ID/UUID لتتبع مكالمة محددة عبر النظام بأكمله
  • بحث الطوارئ: ابحث عن "911" أو "طوارئ" للعثور بسرعة على معالجة المكالمات الطارئة

التفاصيل الفنية​

  • حد السجل: الحد الأقصى لعرض 500 سجل (يتم التخلص من الأقدم عند الوصول إلى الحد)
  • معدل التحديث: تحديث تلقائي كل 1000 مللي ثانية (1 ثانية)
  • البحث: مطابقة فرعية غير حساسة لحالة الأحرف على حقل الرسالة فقط
  • تصفية فارغة: يتم تصفية رسائل السجل الفارغة/المؤقتة تلقائيًا
  • كشف المصدر: يتم وضع علامات على السجلات بـ :elixir أو :freeswitch كمصدر
  • الفرز: يتم فرز السجلات حسب الطابع الزمني تنازليًا (الأحدث أولاً)
  • PubSub: يتم تسليم سجلات Elixir عبر Phoenix PubSub للتحديثات في الوقت الحقيقي
  • سجلات FreeSWITCH: يتم جمعها عبر واجهة مقبس الأحداث (ESI) لمستمع السجل

قاعدة بيانات أبراج الهاتف المحمول​

إدارة واستعلام قاعدة بيانات مواقع أبراج الهاتف المحمول OpenCellID لخدمات الطوارئ والميزات المعتمدة على الموقع.

الوصول: انتقل إلى /cell_towers في لوحة التحكم

الميزات​

  • إحصائيات قاعدة البيانات: عرض إجمالي السجلات، التغطية حسب البلد/الشبكة
  • البحث والاستعلام:
    • البحث حسب MCC (رمز الدولة المحمول)
    • البحث حسب MNC (رمز الشبكة المحمول)
    • البحث حسب نوع الراديو (GSM، UMTS، LTE)
    • البحث حسب سلسلة الموقع
  • إدارة قاعدة ��لبيانات:
    • استيراد بيانات أبراج الهاتف المحمول
    • إعادة تنزيل أحدث مجموعة بيانات من OpenCellID
    • عرض حالة الاستيراد والتقدم
  • حل الموقع: حل معرفات الأبراج إلى إحداثيات جغرافية

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

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

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

تستمد بيانات أبراج الهاتف المحمول من OpenCellID (https://opencellid.org/)، وهو مشروع مجتمعي تعاوني لإنشاء قاعدة بيانات مجانية لمواقع أبراج الهاتف المحمول في جميع أنحاء العالم.

محاكي المكالمات​

أداة محاكاة المكالمات التفاعلية لاختبار منطق خطة الاتصال دون إجراء مكالمات حقيقية.

الوصول: انتقل إلى /simulator في لوحة التحكم

الوثائق التفصيلية: انظر doc/HLR_AND_CALL_SIMULATOR.md

الميزات​

  • محاكاة أنواع المكالمات: اختبار المكالمات MO، MT، والطوارئ
  • معلمات قابلة للتكوين:
    • أرقام المصدر والوجهة
    • عنوان IP المصدر (لتمثيل SBC/CSCF)
    • فرض تصرف مكالمة محدد
    • تخطي تفويض OCS لاختبارات أسرع
  • نتائج شاملة:
    • مخرجات متغيرات خطة الاتصال الكاملة
    • نتائج بحث Sh/HLR
    • نتيجة تفويض OCS
    • نتائج استعلام SS7 MAP (إذا كان ذلك مناسبًا)
    • XML خطة الاتصال المولدة
  • معالجة خطوة بخطوة: عرض كل مرحلة من مراحل معالجة المكالمة

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

  • اختبار تغييرات خطة الاتصال قبل النشر
  • التحقق من توفير المشتركين
  • استكشاف مشكلات توجيه المكالمات
  • تدريب الموظفين على تدفق المكالمات
  • التحقق من تكامل OCS/HLR
  • اختبار معالجة المكالمات الطارئة

اختبار HLR/MAP​

اختبار عمليات SS7 MAP بما في ذلك استعلام إرسال معلومات التوجيه (SRI) وتوفير رقم التجوال (PRN).

الوصول: انتقل إلى /hlr في لوحة التحكم

الوثائق التفصيلية: انظر doc/HLR_AND_CALL_SIMULATOR.md

الميزات​

  • استعلام SRI: اختبار إرسال معلومات التوجيه لتوجيه المكالمات
  • استعلام PRN: اختبار توفير رقم التجوال للمشتركين المتجولين
  • نتائج حقيقية: استعلامات فعلية إلى بوابة MAP المكونة
  • عرض الاستجابة: عرض MSRN، عنوان MSC، وحالة التوجيه
  • معالجة الأخطاء: عرض واضح لأخطاء MAP ومهلاتها

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

  • التحقق من اتصال HLR
  • اختبار تخصيص رقم التجوال
  • استكشاف توجيه المكالمات إلى المشتركين المتجولين
  • التحقق من تكوين بوابة MAP
  • استكشاف مشكلات تحويل المكالمات

اختبار OCS​

اختبار عمليات Diameter Ro (التحصيل عبر الإنترنت) Credit-Control-Request (CCR) مباشرة ضد OCS الخاص بك.

الوصول: انتقل إلى /ocs_test في لوحة التحكم

الميزات​

  • أنواع CCR مرنة: إرسال طلبات INITIAL، UPDATE، TERMINATION، أو EVENT
  • محاكاة الجلسة: إعادة استخدام نفس معرف المكالمة لمحاكاة دورة حياة جلسة كاملة
  • اختيار نوع الحدث: اختبار كل من الشحن عبر الرسائل القصيرة (استنادًا إلى الحدث) والشحن عبر المكالمات (استنادًا إلى الجلسة)
  • التحكم في الاتجاه: اختبار كل من السيناريوهات الصادرة (MO) والواردة (MT)
  • معلمات اختيارية: تحديد Destination-Host واسم المستخدم للاختبار المتقدم
  • نتائج في الوقت الحقيقي: عرض استجابات CCA (Credit-Control-Answer) الكاملة

كيفية الاستخدام​

  1. إدخال معلمات الاختبار:

    • MSISDN المدعو: رقم الوجهة (مثل، 61400123456)
    • MSISDN المتصل: الرقم الأصلي (مثل، 61400987654)
    • نوع الحدث: اختر sms أو call
      • الرسائل القصيرة افتراضيًا إلى EVENT_REQUEST (النوع 4)
      • المكالمة افتراضيًا إلى INITIAL_REQUEST (النوع 1)
    • الاتجاه: out لـ MO أو in لـ MT

  2. تكوين نوع CCR:

    • Request-Type: اختر نوع CCR:
      • 1 — INITIAL_REQUEST - بدء جلسة جديدة
      • 2 — UPDATE_REQUEST - إعادة تفويض منتصف الجلسة
      • 3 — TERMINATION_REQUEST - إنهاء الجلسة والإبلاغ عن الاستخدام
      • 4 — EVENT_REQUEST - حدث لمرة واحدة (رسائل قصيرة، حدث فوري)
    • Request-Number: يبدأ من 1، يزيد لكل طلب في نفس الجلسة

  3. اختبار الجلسة:

    • Call ID: معرف فريد تم إنشاؤه تلقائيًا للتوافق
    • انقر على "معرف جديد" لإنشاء Call ID جديد لاختبار جديد
    • احتفظ بنفس Call ID لمحاكاة جلسة كاملة:
      • الطلب الأول: INITIAL_REQUEST (النوع 1، الرقم 1)
      • منتصف الجلسة: UPDATE_REQUEST (النوع 2، الرقم 2، 3، 4...)
      • الطلب النهائي: TERMINATION_REQUEST (النوع 3، الرقم N+1)

  4. خيارات متقدمة:

    • Destination-Host: استهداف عقدة OCS معينة (اختياري)
    • اسم المستخدم: تجاوز معرف المشترك (اختياري)

  5. تشغيل ومراجعة:

    • انقر على "تشغيل CCR" لإرسال الطلب
    • عرض الاستجابة الكاملة لـ CCA مع جميع AVPs
    • تحقق من رمز النتيجة، الوحدات الممنوحة، ووقت الصلاحية
    • يظهر الطابع الزمني لآخر تشغيل في الزاوية العليا اليمنى

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

  • اختبار اتصال OCS: التحقق من اتصال Diameter Ro والمصادقة
  • منطق التحكم في الائتمان: اختبار تخصيص الائتمان، الاستهلاك، وسيناريوهات النفاد
  • اختبار تدفق الجلسة: محاكاة دورة حياة المكالمة الكاملة (INITIAL → UPDATE → TERMINATION)
  • التحقق من التصنيف: التحقق من معدلات الشحن الصحيحة لمجموعة متنوعة من الأرقام
  • اختبار الفشل: اختبار تكرار OCS من خلال استهداف Destination-Host معين
  • استكشاف الأخطاء في التكامل: استكشاف مشكلات تكامل OCS مع فحص AVP التفصيلي
  • التحضير لاختبار التحميل: التحقق من سلوك OCS قبل اختبار التحميل
  • تجاوز رقم الطوارئ: التحقق من أن أرقا�� الطوارئ تتجاوز الشحن بشكل صحيح

نصائح​

  • استخدم نفس Call ID مع زيادة Request-Numbers لاختبار استمرارية الجلسة
  • راقب سجلات OCS في نفس الوقت لمطابقة طلبات الاختبار
  • اختبر طلبات UPDATE للتحقق من منطق إعادة التفويض في منتصف الجلسة
  • تحقق من أن طلبات TERMINATION تغلق الجلسات بشكل صحيح وتمنع التسربات
  • اختبر نفاد الائتمان عن طريق إرسال طلبات UPDATE بعد استهلاك الوحدات الممنوحة

اختبار واجهة Sh​

اختبار عمليات Diameter Sh User-Data-Request (UDR) لاسترداد بيانات ملف تعريف المشترك من HSS.

الوصول: انتقل إلى /sh_test في لوحة التحكم

الميزات​

  • مراجع بيانات متعددة: استعلام عن أكثر من 20 نوعًا مختلفًا من بيانات المشتركين
  • استعلامات HSS حقيقية: طلبات Diameter Sh حية إلى HSS المكونة
  • عرض الاستجابة الكاملة: عرض بيانات XML الكاملة للمشترك وAVPs
  • تتبع الجلسة: يظهر اسم المضيف HSS، المجال، ومعرف الجلسة
  • معالجة الأخطاء: عرض واضح لرموز نتائج Diameter وحالات الخطأ

كيفية الاستخدام​

  1. إدخال الهوية العامة:

    • الهوية العامة: الهوية العامة IMS للمشترك
    • التنسيق: sip:61400123456@ims.mncXXX.mccXXX.3gppnetwork.org
    • يمكن أيضًا استخدام التنسيق tel:+61400123456

  2. اختيار مرجع البيانات: اختر نوع بيانات المشترك التي ترغب في استردادها:

    • RepositoryData (0): ملف تعريف المشترك الكامل
    • IMSPublicIdentity (10): قائمة الهوية العامة
    • IMSUserState (11): حالة التسجيل
    • S-CSCFName (12): S-CSCF المعين
    • InitialFilterCriteria (13): مشغلات iFC لخوادم التطبيقات
    • LocationInformation (14): الموقع الحالي
    • ChargingInformation (16): عناوين P-Charging
    • MSISDN (17): رقم الهاتف
    • IMSI (32): هوية المشترك الدولي المحمول
    • IMSPrivateUserIdentity (33): الهوية الخاصة بالمستخدم
    • والعديد غيرها...

  3. تشغيل ومراجعة:

    • انقر على "Fetch SH Data" لإرسال طلب UDR
    • عرض الاستجابة الكاملة لـ User-Data-Answer (UDA)
    • تحقق من XML ملف تعريف المشترك، بيانات الخدمة، وقواعد iFC
    • تظهر بيانات الجلسة أي HSS استجاب

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

  • التحقق من المشترك: تأكيد أن المشترك موجود في HSS
  • استكشاف iFC: مراجعة معايير الفلترة الأولية ونقاط المشغلات
  • استكشاف مشاكل التسجيل: تحقق من حالة المستخدم وتعيين S-CSCF
  • تكوين الشحن: التحقق من عناوين P-Charging-Function
  • اختبار اتصال HSS: التحقق من اتصال Diameter Sh
  • التحقق من الملف الشخصي: التأكد من تعيين ملف الخدمة الصحيح
  • اختبار التكامل: اختبار تكامل HSS بعد تغييرات التوفير
  • تحليل التجوال: تحقق من معلومات الموقع والشبكة الخادمة

نصائح​

  • استخدم IMSPublicIdentity (10) لرؤية جميع الألقاب للمشترك
  • استخدم RepositoryData (0) للحصول على ملف تعريف المشترك الكامل في استعلام واحد
  • تحقق من IMSUserState (11) للتحقق مما إذا كان المشترك مسجلاً
  • InitialFilterCriteria (13) يظهر أي خوادم تطبيقات سيتم تشغيلها
  • يمكن استخدام معرف الجلسة لمطابقة الاستعلامات في سجلات HSS
  • تتضمن استجابات الأخطاء رموز نتائج Diameter (مثل، 5001 = المستخدم غير معروف)

اختبار ترجمة الأرقام​

اختبار قواعد ترجمة الأرقام والتنسيق دون إجراء مكالمات فعلية.

الوصول: انتقل إلى /translate في لوحة التحكم

الميزات​

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

كيفية الاستخدام​

  1. تكوين المعلمات:

    • رمز البلد: سياق الاتصال (مثل، AU، US، NZ)
      • الافتراضي هو القيمة المكونة في Tas.Config.number_translate()[:country_code]
      • يقبل التنسيقات: AU، :AU، au
    • رقم الهاتف: الرقم المراد ترجمته
      • أمثلة: +61400111222، 0400111222، 61400111222
    • التصرف: (اختياري) سياق المكالمة لقواعد شرطية
      • أمثلة: originate، route، emergency

  2. اختبار الترجمة:

    • أدخل القيم في النموذج
    • يتم تشغيل الترجمة تلقائيًا أثناء الكتابة
    • أو انقر على "ترجمة" لتفعيلها يدويًا
    • عرض النتيجة المترجمة على الفور

  3. مراجعة النتائج:

    • مترجم: يظهر الرقم الناتج المنسق
    • خطأ: تعرض أخطاء التحقق أو فشل الترجمة
    • القيمة العائدة الخام (تصحيح): تعرض الزوج Elixir الكامل لأغراض التصحيح

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

  • تطوير خطة الاتصال: اختبار قواعد تنسيق الأرقام قبل النشر
  • التحقق من التنسيق: التأكد من أن تحويل E.164 يعمل بشكل صحيح
  • اختبار رمز البلد: التأكد من التعامل الصحيح مع البادئات الدولية
  • كشف أرقام الطوارئ: التحقق من أن أرقام الطوارئ يتم التعرف عليها بشكل صحيح
  • معالجة الرموز القصيرة: اختبار الرموز الخاصة بالخدمات (البريد الصوتي، إلخ.)
  • إعداد الخطوط: تنسيق الأرقام بشكل صحيح لمتطلبات SIP trunk
  • منطق التصرف: اختبار قواعد مختلفة لسيناريوهات MO مقابل MT
  • استكشاف مشكلات الترجمة: استكشاف لماذا تفشل أرقام معينة في التوجيه

نصائح​

  • اختبار كل من التنسيق المحلي (0400111222) والتنسيق الدولي (+61400111222)
  • التحقق من أن أرقام الطوارئ (000، 112) يتم التعرف عليها بشكل صحيح
  • استخدم حقل التصرف لاختبار قواعد مختلفة (MO، MT، الطوارئ)
  • تحقق من أن الرموز القصيرة والأرقام الداخلية يتم التعامل معها بشكل مناسب
  • تعرض مخرجات التصحيح القيمة العائدة الخام - مفيدة للتحقيق في المشكلات
  • اختبار الحالات الحدية مثل الأصفار الرائدة، البادئات الدولية، والأحرف الخاصة

إدارة البريد الصوتي​

إدارة والاستماع إلى رسائل البريد الصوتي المخزنة في النظام.

الوصول: انتقل إلى /voicemail في لوحة التحكم

الميزات​

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

كيفية الاستخدام​

  1. عرض قائمة البريد الصوتي:

    • يتم تحميل الصفحة تلقائيًا مع جميع سجلات البريد الصوتي
    • تظهر الجدول جميع الحقول من قاعدة بيانات البريد الصوتي
    • يتم تنسيق الطوابع الزمنية تلقائيًا من القيم الزمنية
    • يتم اختصار مسارات الملفات لسهولة القراءة

  2. الاستماع إلى الرسائل:

    • انقر على زر "▶ تشغيل" بجوار أي بريد صوتي
    • يظهر مشغل الصوت مع عناصر التحكم (تشغيل، إيقاف مؤقت، بحث، حجم)
    • يدعم تنسيقات WAV وMP3 وOGG
    • انقر على "إيقاف" لإغلاق مشغل الصوت

  3. حذف الرسائل:

    • انقر على زر "حذف" لإزالة بريد صوتي
    • يمنع تأكيد الحذف الحذف العرضي
    • يتم تحديث الصفحة تلقائيًا بعد الحذف الناجح

  4. تحديث البيانات:

    • انقر على زر "تحديث" في الزاوية العليا اليمنى لإعادة تحميل قائمة البريد الصوتي
    • مفيد بعد ترك رسائل بريد صوتي جديدة

تفاصيل الرسالة المعروضة​

يعرض الجدول ديناميكيًا جميع الحقول المتاحة، والتي تشم�� عادةً:

  • اسم المستخدم: مالك صندوق البريد
  • UUID: معرف الرسالة الفريد
  • تاريخ الإنشاء: عندما تم ترك الرسالة (يتم تنسيقه تلقائيًا إلى تاريخ/وقت قابل للقراءة)
  • تاريخ القراءة: عندما تم الوصول إلى الرسالة (إذا كان ذلك مناسبًا)
  • مسار الملف: موقع ملف الصوت
  • بيانات وصفية إضافية من قاعدة بيانات البريد الصوتي

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

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

نصائح​

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

إدارة تلميحات TTS​

إدارة تلميحات الصوت المولدة بواسطة النص إلى كلام (TTS) المستخدمة في جميع أنحاء النظام.

الوصول: انتقل إلى /prompts في لوحة التحكم

الميزات​

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

كيفية الاستخدام​

  1. مراجعة إعدادات التلميحات:

    • الصوت: صوت TTS المستخدم (مثل، alloy، nova، shimmer)
    • تنسيق الاستجابة: تنسيق الصوت (مثل، wav، mp3، opus)
    • التعليمات: تعليمات خاصة تمرر إلى محرك TTS

  2. التحقق من حالة التسجيل:

    • النص: نص التلميح الذي سيتم نطقه
    • المسار النسبي: حيث يتم تخزين ملف الصوت
    • موجود: "نعم" باللون الأخضر إذا كان الملف موجودًا، "لا" باللون الأصفر إذا كان مفقودًا
    • الحجم: حجم الملف بالبايت/KiB/MiB
    • تعديل: الطابع الزمني لآخر تعديل

  3. إنشاء التلميحات:

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

  4. إدارة التلميحات الفردية:

    • ▶ تشغيل: الاستماع إلى التلميح (مفعل فقط إذا كان الملف موجودًا)
    • 🔄 إعادة تسجيل: إعادة توليد هذا التلميح فقط
      • مفيد إذا كان أحد التلميحات يبدو غير صحيح
      • يستخدم الصوت والإعدادات الحالية

  5. الاستماع إلى التلميحات:

    • انقر على "▶ تشغيل" لسماع التلميح
    • يظهر مشغل الصوت في الأسفل مع جميع عناصر التحكم
    • انقر على "إيقاف" لإغلاق المشغل

تكوين التلميحات​

يتم تكوين التلميحات في تكوين تطبيقك:

config :tas, :prompts,
  voice: "nova",
  response_format: "wav",
  instructions: "تحدث بوضوح واحترافية.",
  recordings: [
    %{path: "/sounds/en/us/callie/voicemail/vm-enter_id.wav",
      text: "يرجى إدخال معرف صندوق البريد الخاص بك متبوعًا بعلامة الجنيه"},
    # ... المزيد من التلميحات
  ]

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

  • الإعداد الأولي: إنشاء جميع التلميحات بعد تثبيت النظام
  • تغييرات الصوت: إعادة تسجيل جميع التلميحات بصوت TTS مختلف
  • تحسين الجودة: إصلاح التلميحات الفردية التي لا تبدو صحيحة
  • تحديث التنسيق: إعادة توليد التلميحات بتنسيق صوتي مختلف (wav → mp3)
  • تحديث النص: إعادة التسجيل بعد تغيير نص التلميح في التكوين
  • اختبار TTS: معاينة كيف ستبدو التلميحات قبل النشر
  • استكشاف مشكلات التشغيل: التحقق من وجود ملفات التلميحات والوصول إليها
  • إدارة التخزين: تحقق من أحجام الملفات وإدارة استخدام القرص

نصائح​

  • استخدم "إنشاء مفقود" للإعداد الأولي - لن يكتب فوق التلميحات الموجودة
  • استخدم "إعادة تسجيل جميع" بعد تغيير الصوت أو التنسيق في التكوين
  • إعادة التسجيل الفردية مفيدة للتكرار على تلميحات معينة
  • استمع إلى التلميحات قبل النشر لضمان الجودة
  • التنسيقات الأكبر (wav) تتمتع بجودة أفضل ولكن تستخدم المزيد من مساحة القرص
  • يمكن أن توجه حقل التعليمات محرك TTS من حيث النغمة والإيقاع
  • قد تستغرق إعادة التسجيل وقتًا إذا كان لديك العديد من التلميحات - كن صبورًا
  • يتم تخزين التلميحات في دليل أصوات FreeSWITCH للوصول السهل

قوالب XML لخطة الاتصال​

عرض وفحص قوالب XML لخطة الاتصال في FreeSWITCH المستخدمة لتوجيه المكالمات.

الوصول: انتقل إلى /routing في لوحة التحكم

الميزات​

  • قائمة القوالب: عرض جميع قوالب XML من دليل priv/templates/
  • تفاصيل الملف: رؤية اسم الملف والطابع الزمني لآخر تعديل لكل قالب
  • تمييز بناء الجملة: عرض XML ملون لسهولة القراءة
    • العلامات باللون الأزرق
    • السمات باللون الأزرق الفاتح
    • القيم باللون البرتقالي/البيج
    • التعليقات باللون الأخضر
  • عرض قابل للتوسع: انقر على أي قالب لعرض محتواه الكامل من XML
  • عرض للقراءة فقط: فحص آمن دون خطر التعديل العرضي
  • محتوى قابل للتمرير: يتم تمرير القوالب الكبيرة ضمن حاوية ثابتة الارتفاع (حد أقصى 600 بكسل)

كيفية الاستخدام​

  1. عرض قائمة القوالب:

    • يتم تحميل الصفحة مع جميع ملفات .xml من دليل القوالب
    • مرتبة أبجديًا حسب اسم الملف
    • تظهر الطابع الزمني للتعديل لكل ملف

  2. فحص القالب:

    • انقر على أي صف للتوسع وعرض محتوى XML
    • يتم عرض القالب مع تمييز بناء الجملة
    • انقر مرة أخرى للانهيار

  3. قراءة محتوى XML:

    • العلامات (بالأزرق): أسماء عناصر XML مثل <extension>، <condition>
    • السمات (بالأزرق الفاتح): أسماء السمات مثل name=، field=
    • القيم (بالبرتقالي): قيم السمات مثل "public"، "destination_number"
    • التعليقات (بالأخضر): تعليقات XML <!-- ... -->

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

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

نصائح​

  • يتم تحميل القوالب من priv/templates/ داخل تطبيق TAS
  • يتم عرض ملفات .xml فقط
  • القوالب للعرض فقط عبر واجهة الويب
  • تساعد الطوابع الزمنية للتعديل في تحديد التغييرات الأخيرة
  • استخدم هذا العرض للتحقق من تطابق القوالب مع توقعات خطة الاتصال الخاصة بك
  • يجعل تمييز بناء الجملة من XML المعقد أسهل في التحليل بصريًا
  • اجمع بين هذا مع عرض /logs لمطابقة سلوك التوجيه مع القوالب

التفاصيل الفنية​

  • الموقع: يتم تخزين القوالب في دليل priv/templates/
  • التنسيق: تنسيق XML لخطة الاتصال في FreeSWITCH
  • امتداد الملف: يتم عرض ملفات .xml فقط
  • الفرز: أبجدي حسب اسم الملف
  • تمييز بناء الجملة: تلوين جانب العميل باستخدام أنماط regex
  • الحد الأقصى لارتفاع العرض: 600 بكسل مع تمرير للقوالب الكبيرة

مشغل أوامر ESL​

تنفيذ أوامر FreeSWITCH Event Socket Layer (ESL) مباشرة من واجهة الويب.

الوصول: انتقل إلى /command في لوحة التحكم

الميزات​

  • تنفيذ الأوامر: تشغيل أي أمر ESL/FreeSWITCH API
  • الإخراج المباشر: رؤية نتائج الأوامر في الوقت الحقيقي
  • تاريخ الأوامر: قائمة منسدلة بالأوامر الأخيرة (آخر 10 أوامر)
  • جاهز للإكمال التلقائي: إدخال أحادي المسافة لدقة إدخال الأوامر
  • معالجة الأخطاء: عرض واضح لأخطاء الأوامر والاستثناءات
  • لا تنفيذ تلقائي: اختيار التاريخ يملأ الإدخال ولكن يتطلب نقرة "تشغيل" صريحة

كيفية الاستخدام​

  1. إدخال الأمر:

    • اكتب أمر ESL في مربع الإدخال
    • أمثلة:
      • status - عرض حالة FreeSWITCH
      • show channels - قائمة المكالمات النشطة
      • uuid_dump <uuid> - تفريغ جميع المتغيرات لمكالمة
      • sofia status - عرض حالة ملف SIP
      • reloadxml - إعادة تحميل XML خطة الاتصال
      • version - عرض إصدار FreeSWITCH

  2. تشغيل الأمر:

    • انقر على زر "تشغيل" لتنفيذ الأمر
    • يظهر الزر "جارٍ التشغيل..." أثناء التنفيذ
    • لا يمكن تشغيل أوامر متعددة في نفس الوقت

  3. عرض الإخراج:

    • تظهر النتائج في قسم "الإخراج" أدناه
    • تظهر الأوامر الناجحة الاستجابة الخام
    • الأخطاء مسبوقة بـ "ERROR:"
    • الإخراج قابل للتمرير مع حد أقصى للارتفاع يبلغ 600 بكسل
    • خط أحادي لمحاذاة البيانات

  4. استخدام تاريخ الأوامر:

    • تظهر الأوامر الأخيرة في القائمة المنسدلة بعد أول تنفيذ
    • اختر من قائمة "الأخيرة:" لملء حقل الإدخال
    • يحتفظ التاريخ بآخر 10 أوامر فريدة
    • الأمر الأكثر حداثة في الأعلى
    • اختيار التاريخ لا ينفذ تلقائيًا (ميزة أمان)

الأوامر الشائعة​

الأمرالوصفمثال على الإخراج
statusحالة النظام ووقت التشغيلمعلومات تشغيل FreeSWITCH
show channelsقائمة بجميع المكالمات النشطةقائمة القنوات أو "0 إجمالي"
show callsملخص المكالمات النشطةملخص عدد المكالمات
uuid_dump <uuid>جميع المتغيرات لمكالمةتفريغ المتغيرات الكاملة
uuid_kill <uuid>إنهاء مكالمة معينة"+OK" أو خطأ
sofia statusحالة ملف SIPقائمة الملفات وحالاتها
sofia status profile <name>تفاصيل ملف محددعدد التسجيلات، إلخ
reloadxmlإعادة تحميل XML خطة الاتصالتأكيد "+OK"
versionمعلومات إصدار FreeSWITCHسلسلة الإصدار
global_getvar <var>الحصول على متغير عالميقيمة المتغير
api helpقائمة الأوامر المتاحةمرجع الأوامر

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

  • استكشاف المكالمات: الحصول على معلومات مفصلة حول المكالمات النشطة باستخدام uuid_dump
  • حالة النظام: التحقق من صحة FreeSWITCH باستخدام status وshow calls
  • استكشاف SIP: فحص ملفات SIP باستخدام sofia status
  • إعادة تحميل خطة الاتصال: تطبيق تغييرات التكوين باستخدام reloadxml
  • إجراءات الطوارئ: إنهاء المكالمات العالقة باستخدام uuid_kill
  • فحص المتغيرات: التحقق من المتغيرات العالمية أو متغيرات القناة

استكشاف الأخطاء​

المشتركين لا يظهرون​

  • تحقق من تشغيل OmniTAS
  • تحقق من أن ملف تعريف Sofia نشط: sofia status profile internal
  • تحقق من أن مسار قاعدة البيانات في التكوين يتطابق مع موقع قاعدة البيانات الفعلي

سجلات CDR لا تظهر​

  • تأكد من تحميل و��دة CDR الخاصة بـ OmniTAS
  • تحقق من وجود قاعدة بيانات CDR في المسار المكون
  • تحقق من تكوين وحدة CDR في OmniTAS

اعتبارات الأداء​

  • قد تتطلب قواعد بيانات CDR الكبيرة (>1M سجلات) فهرسة إضافية لتحقيق الأداء الأمثل
  • النظر في أرشفة سجلات CDR القديمة بشكل دوري
  • استعلامات تسجيل المشتركين عادة ما تكون سريعة حيث أن قاعدة بيانات التسجيل صغيرة

التكوين​

التحكم في الوصول​

يجب نشر لوحة التحكم خلف ضوابط الوصول المناسبة (جدار ناري، VPN، مصادقة) حيث توفر رؤية في نشاط المشتركين وسجلات المكالمات.