افزونهای محلی برای خواندن دروس ارائهشده در سامانه سادا، تطبیق چارت درسی و ساخت برنامههای بدون تداخل کلاسی و امتحانی.
برنامهریز انتخاب واحد دانشگاه گیلان یک افزونه Chrome برای سادهتر کردن بررسی دروس ارائهشده در سامانه سادا است. افزونه جدول فعلی دروس را از صفحه باز سامانه میخواند، امکان تطبیق آن با فایل چارت درسی را فراهم میکند، درسهای پاسشده را دستی یا از کارنامه ترمی میخواند و بر اساس محدودیتها و ترجیحهای کاربر، برنامههای پیشنهادی میسازد.
مهم: این پروژه مستقل است و وابستگی رسمی به دانشگاه گیلان ندارد.
| قابلیت | توضیح |
|---|---|
| دریافت دروس |
خواندن جدول فعلی و قابلمشاهده دروس از دامنه
sada.guilan.ac.ir
|
| تطبیق چارت |
پردازش فایل
DOCX،
تطبیق درسها و بازبینی موارد مبهم
|
| جستوجو و فیلتر | فیلتر بر اساس نام درس، استاد، روز، مقطع، ترم، واحد، جنسیت، ظرفیت و وضعیت چارت |
| ساخت برنامه | پیشنهاد برنامه با جلوگیری از تداخل کلاس و امتحان |
| کنترل انتخابها | تعیین گروههای اجباری، ترجیحی یا حذفشده و ثبت درسهای گذراندهشده |
| مقایسه برنامهها | مقایسه همزمان حداکثر دو برنامه پیشنهادی |
| خروجی PDF | آمادهسازی نسخه A4 از طریق پنجره چاپ Chrome و گزینه Save as PDF |
| پردازش محلی | پردازش دادهها و فایل چارت در مرورگر، بدون اتصال به API یا سرور خارجی |
برای استفاده از نسخه فعلی، مخزن را دریافت کنید و پوشه
extension
را مستقیماً در
Chrome
بارگذاری کنید. پروژه مرحله
build
جداگانهای ندارد.
- مخزن را Clone کنید:
git clone https://github.com/ariaramin/guilan-university-course-scheduler.git
cd guilan-university-course-schedulerیا از منوی Code → Download ZIP در GitHub، سورس پروژه را دانلود و استخراج کنید.
- در Chrome آدرس زیر را باز کنید:
chrome://extensions- گزینه Developer mode را فعال کنید.
- روی Load unpacked کلیک کنید.
- پوشه زیر را انتخاب کنید:
extension/- صفحه فهرست دروس در سامانه سادا را باز یا بازخوانی کنید و سپس روی آیکن افزونه کلیک کنید.
نکته: در حال حاضر Release عمومی در مخزن منتشر نشده است؛ بنابراین نصب از سورس روش قابلتأیید پروژه است.
- وارد سامانه سادا شوید و صفحهای را باز کنید که جدول دروس ارائهشده در آن نمایش داده میشود.
- روی آیکن افزونه کلیک کنید تا صفحه برنامهریز باز شود.
- وضعیت دریافت داده را بررسی کنید؛ افزونه فقط جدول فعلی و قابلمشاهده صفحه را میخواند.
-
در صورت نیاز، فایل چارت درسی با فرمت
DOCXرا بارگذاری و موارد شناساییشده را بازبینی کنید. - واحد هدف، تعداد درس و فیلترهای موردنظر را تنظیم کنید.
- در بخش «درسهای گذراندهشده»، نام درس را دستی ثبت کنید یا با بازبودن «کارنامه ترمی ← دروس ترمی» دکمه استخراج را بزنید؛ نمرههای زیر ۱۰ نادیده گرفته میشوند.
- برنامههای پیشنهادی را بررسی یا حداکثر دو مورد را مقایسه کنید.
- برای دریافت PDF، روی دانلود PDF بزنید و در پنجره چاپ Chrome گزینه Save as PDF را انتخاب کنید.
- در تب اصلی سادا، کارنامه ترمی را باز کنید و بخش دروس ترمی را نمایش دهید.
- در برنامهریز، بخش «درسهای گذراندهشده» را باز و «استخراج از کارنامهٔ باز» را انتخاب کنید.
- فقط درسهای دارای نمرهٔ عددی ۱۰ یا بیشتر ثبت میشوند؛ واحد، مجموع ستونهای نظری، عملی و کارگاهی است.
- برای اصلاح یا افزودن موردی، نام درس را دستی وارد کنید؛ کد و واحد اختیاریاند.
در نسخهٔ جدید افزونه، ابتدا افزونه را در 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 cinpm testاین فرمان تستهای پروژه را با Node.js Test Runner اجرا میکند.
نکته: درpackage.jsonفقط اسکریپتtestتعریف شده است. پروژه در حال حاضر اسکریپت جداگانهای برایdev،build،lintیاtypecheckندارد.
-
صفحه
chrome://extensionsرا باز کنید. - روی دکمه Reload کارت افزونه کلیک کنید.
- صفحه سادا را بازخوانی کنید.
- جریان دریافت دروس، استخراج کارنامه، فیلترها، بارگذاری چارت، پیشنهاد برنامه و چاپ PDF را بررسی کنید.
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
قرار دارد. روند پیشنهادی:
- مخزن را Fork کنید.
- یک Branch با نام روشن بسازید.
- تغییرات را کوچک و متمرکز نگه دارید.
-
npm testرا اجرا و افزونه را با Load unpacked بررسی کنید. - Pull Request را همراه با توضیح تغییر و نتیجه تستها ارسال کنید.
برای گزارش مشکل، یک Issue جدید ایجاد کنید و این موارد را بنویسید:
- نسخه افزونه، Chrome و سیستمعامل
- مراحل دقیق بازتولید
- نتیجه مورد انتظار و نتیجه واقعی
- اسکرینشات یا لاگ غیرحساس
- دریافت دروس به ساختار فعلی صفحه و جدول سادا وابسته است.
- فقط دادههای جدول فعلی و قابلمشاهده صفحه استخراج میشوند.
-
فایلهای باینری قدیمی
DOCمستقیماً پردازش نمیشوند. - متن داخل تصویر، Text Box، Header یا Footer فایل Word ممکن است بهعنوان درس شناسایی نشود.
- آزمون نهایی روی Session واقعی سادا باید توسط کاربر انجام شود؛ اطلاعات ورود در محدوده پروژه قرار ندارد.
این پروژه تحت مجوز MIT منتشر شده است.