رفتن به متن
باغ ریاضی
assessment-setup
تنظیمات مطالعه
تنظیمات مطالعه

assessment-setup

مستندات اشتراکی · داکیومنت سامانه آزمون آنلاین

پیکربندی آزمون‌ها و تکالیف (infoAssessment.json)

آزمون‌ها و تکالیف در مسیر courseInstances/<term>/assessments/<assessment_name>/ تعریف می‌شوند و تمامی تنظیمات نمره‌دهی، استخرهای سوالات و قوانین دسترسی در فایل infoAssessment.json قرار می‌گیرند.


۱. پیش‌نیاز حیاتی: مجموعه‌های ارزیابی (assessmentSets)

در فایل infoAssessment.json فیلد "set" مشخص‌کننده دسته‌بندی ارزیابی است (مانند تکلیف، کوییز یا آزمون پایان‌ترم). این نام باید حتماً از قبل در فایل infoCourse.json تعریف شده باشد:

// در فایل infoCourse.json
{
  "assessmentSets": [
    { "name": "Homework", "abbreviation": "HW", "heading": "تکالیف کلاسی", "color": "blue1" },
    { "name": "Quiz", "abbreviation": "Q", "heading": "کوییزهای هفتگی", "color": "purple1" },
    { "name": "Exam", "abbreviation": "E", "heading": "آزمون‌های میان‌ترم و پایان‌ترم", "color": "red1" }
  ]
}

۲. کالبدشکافی ساختار فایل infoAssessment.json

یک نمونه کامل از آزمون دانشگاهی با زمان‌سنج و دسترسی مشخص:

{
  "uuid": "8b23c5e8-42f1-482a-bc93-a442812903de",
  "type": "Exam",
  "title": "آزمون میان‌ترم برنامه‌نویسی پایتون",
  "set": "Exam",
  "number": "1",
  "text": "مدت زمان آزمون ۹۰ دقیقه است. استفاده از مراجع و اینترنت مجاز نمی‌باشد.",
  "timeLimitMin": 90,
  "allowRealTimeGrading": true,
  "zones": [ ... ],
  "allowAccess": [ ... ]
}

۳. بخش‌ها (Zones) و استخرهای سوالات (Question Pools)

برای جلوگیری از تقلب، آزمون‌ها به چندین بخش (Zone) تقسیم می‌شوند و در هر بخش، سامانه سوالاتی را به صورت تصادفی از میان گزینه‌های هم‌تراز (Alternatives) برای هر دانشجو انتخاب می‌کند.

ساختار استاندارد استخر سوالات:

"zones": [
  {
    "title": "بخش ۱: مبانی و مفاهیم الگوریتم",
    "comment": "یک سوال تصادفی از میان ۳ سوال این بخش انتخاب می‌شود",
    "maxPoints": 20,
    "questions": [
      {
        "numberChoose": 1,
        "autoPoints": 20,
        "alternatives": [
          { "id": "algorithm_complexity_variant_a" },
          { "id": "algorithm_complexity_variant_b" },
          { "id": "algorithm_complexity_variant_c" }
        ]
      }
    ]
  },
  {
    "title": "بخش ۲: پیاده‌سازی و کدنویسی",
    "bestQuestions": 2,
    "questions": [
      { "id": "python_binary_search", "autoPoints": 30 },
      { "id": "python_quick_sort", "autoPoints": 30 },
      { "id": "python_merge_sort", "autoPoints": 30 }
    ]
  }
]

ویژگی‌های پیشرفته بخش‌ها (Zones):

  • numberChoose: تعداد سوالاتی که باید به صورت تصادفی از این استخر به دانشجو اختصاص داده شود.
  • maxPoints: حداکثر سقف امتیازی که دانشجو می‌تواند از این بخش کسب کند.
  • bestQuestions: محاسبه نمره نهایی بخش تنها از nn سوالی که دانشجو بالاترین امتیاز را در آن‌ها آورده است.
  • lockpoint: true: پس از این که دانشجو پاسخ‌های این بخش را ارسال کرد و به بخش بعدی رفت، امکان ویرایش یا بازگشت به این بخش قفل می‌شود.

۴. قوانین دسترسی و سیاست‌های زمانی (allowAccess)

سامانه قوانین دسترسی را به ترتیب از بالا به پایین ارزیابی می‌کند؛ اولین قانونی که شرایط آن صادق باشد، تعیین‌کننده دسترسی دانشجو خواهد بود:

"allowAccess": [
  {
    "mode": "Public",
    "uids": ["special_student@university.ac.ir"],
    "comment": "استثنا: وقت اضافه ۵۰٪ برای دانشجوی دارای گواهی پزشکی",
    "startDate": "2026-11-20T08:00:00",
    "endDate": "2026-11-20T11:00:00",
    "timeLimitMin": 135
  },
  {
    "mode": "Public",
    "comment": "بازه زمان اصلی آزمون با رمز عبور و محدودیت IP سالن امتحانات",
    "startDate": "2026-11-20T08:00:00",
    "endDate": "2026-11-20T10:00:00",
    "password": "Exam2026Secure!",
    "ipRanges": ["192.168.10.0/24", "172.16.0.0/16"],
    "credit": 100
  },
  {
    "mode": "Public",
    "comment": "فرصت تاخیر با کسر ۲۰ درصد از سقف نمره",
    "startDate": "2026-11-20T10:00:01",
    "endDate": "2026-11-20T12:00:00",
    "credit": 80
  },
  {
    "mode": "Public",
    "comment": "دسترسی آزاد فقط برای مرور و تمرین بدون تاثیر در نمره نهایی",
    "startDate": "2026-11-20T12:00:01",
    "active": true,
    "credit": 0
  }
]

نکات کلیدی قوانین دسترسی:

  1. قانون اولویت ترتیبی: همیشه استثناهای اشخاص (uids) یا گروه‌های خاص باید بالاتر از قوانین عمومی قرار گیرند.
  2. سیاست credit در تاخیر: اگر دانشجو در بازه ۱۰۰٪ نمره کامل بگیرد، ورود به بازه ۸۰٪ نمره او را کسر نمی‌کند. این فیلد سقف نمرات تلاش‌های جدید است.

۵. فعال‌سازی ابزارهای کمکی آزمون (مانند ماشین‌حساب علمی)

اساتید می‌توانند ابزارهای کمکی مجاز در جلسه آزمون را به سادگی از طریق آبجکت tools در فایل infoAssessment.json فعال کنند:

{
  "uuid": "8b23c5e8-42f1-482a-bc93-a442812903de",
  "type": "Exam",
  "title": "آزمون محاسبات عددی",
  "set": "Exam",
  "number": "1",
  "tools": {
    "calculator": true
  }
}
  • با فعال‌سازی "calculator": true، دکمه کشویی «ماشین‌حساب» با امکانات محاسبات پایه‌ای، علمی، مثلثاتی و تاریخچه محاسبات در نوار کناری آزمون برای کلیه سوالات در دسترس دانشجو قرار خواهد گرفت. همچنین می‌توان این ابزار را تنها به یک zone مشخص از آزمون محدود ساخت.

۶. پروژه‌ها و ارزیابی‌های گروهی (Group Work)

برای تکالیف یا پروژه‌های پایانی که دانشجویان به صورت تیمی روی آن کار می‌کنند، می‌توان کار گروهی را به صورت بومی فعال کرد:

{
  "uuid": "4fa8192a-33c9-4081-a901-cd8126e01723",
  "type": "Homework",
  "title": "پروژه برنامه‌نویسی گروهی",
  "set": "Homework",
  "number": "2",
  "groupWork": true,
  "groupMinSize": 2,
  "groupMaxSize": 4,
  "studentGroupCreate": true,
  "studentGroupJoin": true,
  "studentGroupLeave": true
}

ویژگی‌های کار گروهی:

  • تلاش اشتراکی: تمام اعضای گروه یک واریانت مشترک از سوال را مشاهده می‌کنند و با ارسال پاسخ توسط یک نفر، نمره و تاریخچه برای تمام اعضای تیم ثبت می‌شود.
  • تشکیل خودکار یا توسط دانشجو: با فعال بودن studentGroupCreate دانشجویان می‌توانند گروه‌های خود را تشکیل دهند و کد دعوت به هم‌تیمی‌های خود بدهند؛ در غیر این صورت استاد می‌تواند گروه‌بندی را از فایل CSV بارگذاری کند.

حالت ارائه