ساختار پوشهها و فایلهای دوره
در این سامانه، هر دوره به عنوان یک پوشه استاندارد با فایلهای ساختاریافته JSON، HTML و Python ذخیره میشود. این طراحی امکان نسخه کنترلی کامل با Git، کار تیمی میان چند استاد و دستیار، و بکاپگیری آسان را فراهم میسازد.
۱. ساختار درختی یک درس کامل
course/
├── infoCourse.json # اطلاعات کلی درس و پیکربندی اصلی
├── courseInstances/ # دورههای فصلی یا ترمها (نیمسالها)
│ └── Fa1405/
│ ├── infoCourseInstance.json
│ └── assessments/ # آزمونها و تکالیف مربوط به این ترم
│ ├── HW1/
│ │ └── infoAssessment.json
│ └── Exam1/
│ └── infoAssessment.json
├── questions/ # بانک مرکزی سوالات درس
│ ├── addVectors/
│ │ ├── info.json # عنوان، مبحث و برچسبهای سوال
│ │ ├── question.html # ساختار بصری و المانهای تعاملی سوال
│ │ ├── server.py # اسکریپت تولید دادههای تصادفی و پاسخ صحیح
│ │ └── clientFilesQuestion/ (اختیاری: تصاویر یا فایلهای استاتیک)
│ └── pythonFibonacci/
│ ├── info.json
│ ├── question.html
│ └── tests/ # فایلهای تستکیس داوری خودکار
└── serverFilesCourse/ # کتابخانههای مشترک پایتون برای تمام سوالات
۲. همگامسازی دیسک (Sync from Disk)
زمانی که فایلی را در ادیتور خود (یا از طریق Git) تغییر میدهید:
- در نوار بالای سامانه، دکمه «همگامسازی دیسک» را کلیک کنید.
- سامانه در کمتر از یک ثانیه تغییرات سوالات، بارمها و پیکربندی را مجدداً بارگذاری کرده و بدون نیاز به ریستارت سرور در اختیار دانشجویان قرار میدهد.