{

  "mode": "multiple_choice",

  "title": "عنوان الاختبار",
  "slug": "quiz-slug",
  "description": "وصف قصير للاختبار",
  "image": "https://example.com/image.jpg",

  "category": "إسلاميات",
  "level": "سهل",

  "badge": "اختبار قرآني",

  "showReview": true,

  "nextText": "التالي",
  "finishText": "اكتشف النتيجة",
  "requiredMessage": "اختر إجابة قبل المتابعة",

  "questions": [
    {
      "q": "نص السؤال",

      "answers": [
        {
          "text": "الإجابة الأولى",
          "correct": true
        },
        {
          "text": "الإجابة الثانية",
          "correct": false
        }
      ],

      "correctOrder": [
        "عنصر 1",
        "عنصر 2"
      ],

      "explain": "شرح الإجابة"
    }
  ],

  "results": [
    {
      "min": 80,
      "title": "ممتاز",
      "message": "أداء رائع"
    },
    {
      "min": 50,
      "title": "جيد",
      "message": "نتيجة جيدة"
    },
    {
      "min": 0,
      "title": "تحتاج مراجعة",
      "message": "حاول مرة أخرى"
    }
  ]
}

Required fields

{
  "mode": "",
  "title": "",
  "questions": [],
  "results": []
}

Modes

1. Multiple Choice

"mode": "multiple_choice"

Only ONE correct answer.

Example:

{
  "q": "كم عدد أركان الإسلام؟",
  "answers": [
    {"text":"3","correct":false},
    {"text":"5","correct":true},
    {"text":"6","correct":false}
  ]
}

2. Multiple Select

"mode": "multiple_select"

Can select MANY answers.

Example:

{
  "q": "اختر الأنبياء",
  "answers": [
    {"text":"موسى","correct":true},
    {"text":"عيسى","correct":true},
    {"text":"خالد","correct":false}
  ]
}

3. Boolean / True False

"mode": "boolean"

Usually:

{
  "q": "الصلاة خمس صلوات",
  "answers": [
    {"text":"صح","correct":true},
    {"text":"خطأ","correct":false}
  ]
}

4. Ordering / Sequencing

"mode": "ordering"

Uses:

{
  "q": "رتب أركان الإسلام",
  "answers": [
    "حج البيت",
    "الشهادتان",
    "إقام الصلاة"
  ],

  "correctOrder": [
    "الشهادتان",
    "إقام الصلاة",
    "حج البيت"
  ]
}

Optional top-level fields

Image

"image": "https://example.com/image.jpg"

Level

"level": "سهل"

Category

"category": "القرآن الكريم"

Badge

"badge": "اختبار خاص"

Show Review

"showReview": true

Show answers review after finish.

Optional texts

"nextText": "التالي"
"finishText": "عرض النتيجة"
"requiredMessage": "اختر إجابة أولاً"

Question fields

Required

{
  "q": "",
  "answers": []
}

Optional

Explanation

"explain": "شرح السؤال"

correctOrder

ONLY for ordering mode.

"correctOrder": []

Results system

Must be ordered from highest to lowest.

"results": [
  {
    "min": 80,
    "title": "ممتاز",
    "message": "أداء رائع"
  },
  {
    "min": 50,
    "title": "جيد",
    "message": "أداء جيد"
  },
  {
    "min": 0,
    "title": "ضعيف",
    "message": "حاول مرة أخرى"
  }
]

Full production example

{
  "mode": "multiple_choice",

  "title": "اختبار القرآن الكريم",
  "slug": "quran-quiz",
  "description": "اختبر معلوماتك القرآنية",
  "image": "https://example.com/quran.jpg",

  "category": "القرآن الكريم",
  "level": "متوسط",

  "badge": "اختبار إسلامي",

  "showReview": true,

  "nextText": "التالي",
  "finishText": "عرض النتيجة",

  "questions": [
    {
      "q": "كم عدد أجزاء القرآن؟",
      "answers": [
        {"text":"20","correct":false},
        {"text":"30","correct":true},
        {"text":"40","correct":false}
      ],
      "explain": "القرآن الكريم يتكون من 30 جزء."
    }
  ],

  "results": [
    {
      "min": 80,
      "title": "ممتاز",
      "message": "ما شاء الله عليك"
    },
    {
      "min": 50,
      "title": "جيد",
      "message": "أداء جميل"
    },
    {
      "min": 0,
      "title": "تحتاج مراجعة",
      "message": "حاول مرة أخرى"
    }
  ]
}