دليل دمج نظام التنبيهات الشامل

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

1. أقسام التنبيهات ونقاط الوصول (API Endpoints)

يتم تصنيف التنبيهات حسب الغرض منها. يمكن جلب البيانات لكل تبويب باستخدام الروابط المخصصة التالية:

2. مصفوفة الإجراءات (The Action Matrix)

عند النقر على التنبيه، يجب فحص حقل action لتحديد كيفية التنقل داخل التطبيق.

3. معالجة البيانات الإضافية (Metadata Handling)

بالنسبة لتنبيهات "الفريق" أو التنبيهات المتقدمة، يوفر حقل metadata بيانات بتنسيق JSON لعرض واجهات غنية بالوسائط.

مثال لإنجاز رفع المستوى (Level Up):

{
    "type": "team",
    "metadata": {
        "user": {
            "id": 4,
            "name": "User Name",
            "image": "https://.../user.jpg"
        },
        "level": {
            "order": 50,
            "image": "https://.../celebration_art.png"
        }
    }
}

4. منطق التنفيذ (Implementation Logic)

مثال بلغة Dart لتطبيق Flutter يوضح كيفية التعامل مع ضغطة التنبيه:

void onNotificationTap(Map<String, dynamic> notification) {
  final action = notification['action'];
  final path = notification['action_path'];

  if (action == 'user') {
    Navigator.push(context, MaterialPageRoute(builder: (context) => ProfilePage(userId: path)));
  } else if (action == 'room') {
    JoinRoom(roomUid: path);
  } else if (action == 'url') {
    launchURL(path);
  } else if (action == 'post') {
    ViewPost(postId: path);
  }
}

5. ملخص الحقول (Summary of Fields)