Skip to content

About

افزونه کروم برنامه‌ریز انتخاب واحد دانشگاه گیلان برای استخراج هوشمند دروس از سامانه سادا، تطبیق با چارت درسی و تولید خودکار برنامه‌های کلاسی بدون تداخل

Topics

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

نمای افزونه برنامه‌ریز انتخاب واحد دانشگاه گیلان

برنامه‌ریز انتخاب واحد دانشگاه گیلان

افزونه‌ای محلی برای خواندن دروس ارائه‌شده در سامانه سادا، تطبیق چارت درسی و ساخت برنامه‌های بدون تداخل کلاسی و امتحانی.

Version 1.0.0 Chrome Manifest V3 MIT License

✨ معرفی

برنامه‌ریز انتخاب واحد دانشگاه گیلان یک افزونه Chrome برای ساده‌تر کردن بررسی دروس ارائه‌شده در سامانه سادا است. افزونه جدول فعلی دروس را از صفحه باز سامانه می‌خواند، امکان تطبیق آن با فایل چارت درسی را فراهم می‌کند، درس‌های پاس‌شده را دستی یا از کارنامه ترمی می‌خواند و بر اساس محدودیت‌ها و ترجیح‌های کاربر، برنامه‌های پیشنهادی می‌سازد.

مهم: این پروژه مستقل است و وابستگی رسمی به دانشگاه گیلان ندارد.

🧩 قابلیت‌ها

قابلیت توضیح
دریافت دروس خواندن جدول فعلی و قابل‌مشاهده دروس از دامنه sada.guilan.ac.ir
تطبیق چارت پردازش فایل DOCX، تطبیق درس‌ها و بازبینی موارد مبهم
جست‌وجو و فیلتر فیلتر بر اساس نام درس، استاد، روز، مقطع، ترم، واحد، جنسیت، ظرفیت و وضعیت چارت
ساخت برنامه پیشنهاد برنامه با جلوگیری از تداخل کلاس و امتحان
کنترل انتخاب‌ها تعیین گروه‌های اجباری، ترجیحی یا حذف‌شده و ثبت درس‌های گذرانده‌شده
مقایسه برنامه‌ها مقایسه هم‌زمان حداکثر دو برنامه پیشنهادی
خروجی PDF آماده‌سازی نسخه A4 از طریق پنجره چاپ Chrome و گزینه Save as PDF
پردازش محلی پردازش داده‌ها و فایل چارت در مرورگر، بدون اتصال به API یا سرور خارجی

🚀 شروع سریع

برای استفاده از نسخه فعلی، مخزن را دریافت کنید و پوشه extension را مستقیماً در Chrome بارگذاری کنید. پروژه مرحله build جداگانه‌ای ندارد.

نصب از سورس

  1. مخزن را Clone کنید:
git clone https://github.com/ariaramin/guilan-university-course-scheduler.git
cd guilan-university-course-scheduler

یا از منوی Code → Download ZIP در GitHub، سورس پروژه را دانلود و استخراج کنید.

  1. در Chrome آدرس زیر را باز کنید:
chrome://extensions
  1. گزینه Developer mode را فعال کنید.
  2. روی Load unpacked کلیک کنید.
  3. پوشه زیر را انتخاب کنید:
extension/
  1. صفحه فهرست دروس در سامانه سادا را باز یا بازخوانی کنید و سپس روی آیکن افزونه کلیک کنید.
نکته: در حال حاضر Release عمومی در مخزن منتشر نشده است؛ بنابراین نصب از سورس روش قابل‌تأیید پروژه است.

🧭 راهنمای استفاده

  1. وارد سامانه سادا شوید و صفحه‌ای را باز کنید که جدول دروس ارائه‌شده در آن نمایش داده می‌شود.
  2. روی آیکن افزونه کلیک کنید تا صفحه برنامه‌ریز باز شود.
  3. وضعیت دریافت داده را بررسی کنید؛ افزونه فقط جدول فعلی و قابل‌مشاهده صفحه را می‌خواند.
  4. در صورت نیاز، فایل چارت درسی با فرمت DOCX را بارگذاری و موارد شناسایی‌شده را بازبینی کنید.
  5. واحد هدف، تعداد درس و فیلترهای موردنظر را تنظیم کنید.
  6. در بخش «درس‌های گذرانده‌شده»، نام درس را دستی ثبت کنید یا با بازبودن «کارنامه ترمی ← دروس ترمی» دکمه استخراج را بزنید؛ نمره‌های زیر ۱۰ نادیده گرفته می‌شوند.
  7. برنامه‌های پیشنهادی را بررسی یا حداکثر دو مورد را مقایسه کنید.
  8. برای دریافت PDF، روی دانلود PDF بزنید و در پنجره چاپ Chrome گزینه Save as PDF را انتخاب کنید.

درس‌های گذرانده‌شده

  1. در تب اصلی سادا، کارنامه ترمی را باز کنید و بخش دروس ترمی را نمایش دهید.
  2. در برنامه‌ریز، بخش «درس‌های گذرانده‌شده» را باز و «استخراج از کارنامهٔ باز» را انتخاب کنید.
  3. فقط درس‌های دارای نمرهٔ عددی ۱۰ یا بیشتر ثبت می‌شوند؛ واحد، مجموع ستون‌های نظری، عملی و کارگاهی است.
  4. برای اصلاح یا افزودن موردی، نام درس را دستی وارد کنید؛ کد و واحد اختیاری‌اند.

در نسخهٔ جدید افزونه، ابتدا افزونه را در chrome://extensions Reload و سپس صفحهٔ سادا را بازخوانی کنید؛ در غیر این صورت افزونه صریحاً نسخهٔ قدیمی صفحه را گزارش می‌کند.

محدودیت فایل چارت

  • فرمت پیشنهادی و قابل‌پردازش: DOCX
  • حداکثر حجم: 20 MB
  • فایل قدیمی DOC باید ابتدا به DOCX تبدیل شود.
  • فایل‌های PDF، Spreadsheet و متن آزاد به‌عنوان ورودی چارت پشتیبانی نمی‌شوند.

🛠️ توسعه

پروژه با JavaScript ماژولار و Chrome Extension Manifest V3 APIs پیاده‌سازی شده است. وابستگی‌ها با npm مدیریت می‌شوند، اما فایل‌های پوشه extension بدون build جداگانه قابل‌بارگذاری هستند.

پیش‌نیازها

  • Node.js 20 برای هماهنگی با CI
  • npm
  • Google Chrome یا مرورگری سازگار با بارگذاری افزونه‌های Manifest V3

نصب وابستگی‌ها

برای توسعه محلی:

npm install

برای نصب قابل‌تکرار در CI یا محیط تمیز:

npm ci

اجرای تست‌ها

npm test

این فرمان تست‌های پروژه را با Node.js Test Runner اجرا می‌کند.

نکته: در package.json فقط اسکریپت test تعریف شده است. پروژه در حال حاضر اسکریپت جداگانه‌ای برای dev، build، lint یا typecheck ندارد.

بررسی دستی افزونه

  1. صفحه chrome://extensions را باز کنید.
  2. روی دکمه Reload کارت افزونه کلیک کنید.
  3. صفحه سادا را بازخوانی کنید.
  4. جریان دریافت دروس، استخراج کارنامه، فیلترها، بارگذاری چارت، پیشنهاد برنامه و چاپ PDF را بررسی کنید.

🧪 CI و انتشار

Workflow مربوط به CI در Push و Pull Requestهای شاخه main اجرا می‌شود و مراحل زیر را انجام می‌دهد:

npm ci
npm test
Verify extension/manifest.json

Workflow انتشار نیز برای تگ‌های v* آماده شده است. این Workflow نسخه تگ را با نسخه extension/manifest.json تطبیق می‌دهد، تست‌ها را اجرا می‌کند و محتوای پوشه extension را به‌صورت ZIP به GitHub Release اضافه می‌کند.

🔐 حریم خصوصی و دسترسی‌ها

  • مجوزهای افزونه به storage و scripting محدود شده‌اند.
  • دسترسی میزبان فقط برای https://sada.guilan.ac.ir/* تعریف شده است.
  • افزونه به مجوز عمومی tabs، Cookieها یا Session Tokenها دسترسی ندارد.
  • جدول دروس، ترجیح‌ها، درس‌های گذرانده‌شده و داده ساخت‌یافته چارت در chrome.storage.local نگه‌داری می‌شوند.
  • فایل خام چارت ذخیره یا به سرور خارجی ارسال نمی‌شود.
  • افزونه انتخاب واحد را ثبت نمی‌کند و فقط یک ابزار برنامه‌ریزی است.
هشدار: رمز عبور، Cookie، Session Token، شماره دانشجویی یا فایل‌های آموزشی خصوصی را در Issueها و Pull Requestها منتشر نکنید.

🤝 مشارکت

راهنمای کامل مشارکت در CONTRIBUTING.md قرار دارد. روند پیشنهادی:

  1. مخزن را Fork کنید.
  2. یک Branch با نام روشن بسازید.
  3. تغییرات را کوچک و متمرکز نگه دارید.
  4. npm test را اجرا و افزونه را با Load unpacked بررسی کنید.
  5. Pull Request را همراه با توضیح تغییر و نتیجه تست‌ها ارسال کنید.

🐞 گزارش خطا

برای گزارش مشکل، یک Issue جدید ایجاد کنید و این موارد را بنویسید:

  • نسخه افزونه، Chrome و سیستم‌عامل
  • مراحل دقیق بازتولید
  • نتیجه مورد انتظار و نتیجه واقعی
  • اسکرین‌شات یا لاگ غیرحساس

⚠️ محدودیت‌ها

  • دریافت دروس به ساختار فعلی صفحه و جدول سادا وابسته است.
  • فقط داده‌های جدول فعلی و قابل‌مشاهده صفحه استخراج می‌شوند.
  • فایل‌های باینری قدیمی DOC مستقیماً پردازش نمی‌شوند.
  • متن داخل تصویر، Text Box، Header یا Footer فایل Word ممکن است به‌عنوان درس شناسایی نشود.
  • آزمون نهایی روی Session واقعی سادا باید توسط کاربر انجام شود؛ اطلاعات ورود در محدوده پروژه قرار ندارد.

📄 مجوز

این پروژه تحت مجوز MIT منتشر شده است.

About

افزونه کروم برنامه‌ریز انتخاب واحد دانشگاه گیلان برای استخراج هوشمند دروس از سامانه سادا، تطبیق با چارت درسی و تولید خودکار برنامه‌های کلاسی بدون تداخل

Topics

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages