Next-Generation AI Automated Homework Evaluation & Classroom Management Platform
Empowering programming students and instructors directly within Visual Studio Code.

مطالعه راهنما به زبان فارسی   •   English Documentation

معرفی سامانه هوشمند Aiolearn School برای برنامه‌نویسان

چکیده و هدف اصلی پروژه

سامانه Aiolearn School یک افزونه جامع و هوشمند برای محیط نرم‌افزار ویژوال استودیو کد است که با هدف ارتقای کیفیت آموزش برنامه‌نویسی و حذف موانع سنتی ارسال تمرینات توسعه یافته است. با استفاده از این افزونه، فرآیندهای زمان‌بر و خسته‌کننده‌ای نظیر فشرده‌سازی زیپ، اسکرین‌شات از نتایج یا ارسال فایل‌ها در پیام‌رسان‌ها به طور کامل کنار گذاشته می‌شوند.

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

قابلیت‌ها و ویژگی‌های کلیدی سامانه

۱. داوری هوشمند و عیب‌یابی دقیق خطای سطری

• موقعیت‌یابی دقیق خطا: نمایش شماره سطر و نام دقیق فایل دارای ایراد به جای هشدارهای مبهم عمومی (مانند تشخیص سطر ۱۴ در فایل مدلس برای دانشجو).
• بازخورد آموزشی هوش مصنوعی: ارائه راهنمایی سازنده برای رفع اشکال الگوریتم، بدون لو دادن پاسخ نهایی تمرین.
• تحلیل عمیق منطق برنامه‌نویسی: بررسی الگوهای حل مسئله و ساختار کد بدون تعصب به نام‌گذاری متغیرها.

۲. ارزیابی پروژه‌های پیشرفته و چندفایله

• پشتیبانی از پروژه‌های کامل: امکان ارسال همزمان چندین فایل پایتون در قالب یک پوشه یکپارچه پروژه.
• شناسایی خودکار فایل آغازین: تشخیص هوشمند فایل نقطه ورود به برنامه مانند فایل main.py یا app.py در پروژه.
• انتخاب‌گر پوشه کاری: امکان انتخاب پوشه جاری ادیتور یا انتخاب پوشه دلخواه در حافظه سیستم.

۳. ارسال بدون اصطکاک و تک‌کلیکی از محیط ادیتور

• ارسال مستقیم از داخل ادیتور: تحویل کدها بدون نیاز به باز کردن مرورگر یا جابجایی بین نرم‌افزارهای مختلف.
• دریافت فوری نتیجه داوری: مشاهده کارنامه و وضعیت قبولی بلافاصله پس از بررسی خودکار سیستم.
• پایداری کامل در بستر شبکه: اتصال امن و بهینه به سرور لوکال یا سرور دانشگاهی.

۴. پنل جامع مدیریت کلاسی ویژه اساتید

• ثبت آسان تکلیف جدید: ایجاد تکالیف کلاسی با تنظیم مهلت تحویل سریع (۳ روزه و ۷ روزه) و استپر دقیق شماره جلسه.
• جستجوی زنده دانشجویان: فیلتر آنی نام، شماره تماس و وضعیت تحویل تمرین در تمام کلاس‌ها.
• اشتراک‌گذاری منابع درسی: بارگذاری مستقیم جزوات، اسلایدها و کدهای نمونه برای نمایش در سایدبار دانشجویان.
• دانلود کارنامه کلاسی: دریافت فایل گزارش کامل نمرات با فرمت اکسل با یک کلیک.

۵. رابط کاربری شیشه‌ای مدرن با فونت وزیرمتن

• تایپوگرافی چشم‌نواز وزیرمتن: استفاده از فونت استاندارد Vazirmatn در تمامی بخش‌ها و منوها.
• استپر تعاملی شماره جلسه: تغییر سریع شماره جلسه با کلیدهای کیبورد، اسکرول ماوس و دکمه جلسه بعدی.

راهنمای استفاده برای دانشجویان و اساتید

راهنمای دانشجویان:

۱. آیکون Aiolearn را در نوار سایدبار ادیتور باز کنید.
۲. با وارد کردن نام و شماره همراه ثبت‌نامی وارد حساب کاربری خود شوید.
۳. نحوه ارسال را انتخاب کنید: ارسال تک‌فایل فعال در ادیتور یا ارسال پوشه کامل پروژه چندفایله.
۴. روی دکمه ارسال و داوری هوش مصنوعی کلیک کنید تا کارنامه را بلافاصله دریافت نمایید.

راهنمای اساتید:

۱. وارد تب ایجاد تکلیف جدید در پنل استاد شوید.
۲. کلاس مقصد، شماره جلسه، عنوان تمرین و مهلت تحویل را انتخاب کنید.
۳. ارسال‌های کلاسی را بررسی نموده یا کدهای نمونه و جزوات را برای دانشجویان بارگذاری نمایید.

سازنده، توسعه‌دهنده و ناشر رسمی

این سامانه توسط امیرمحمد نهاوندی (Amir Nahavandi) به عنوان پلتفرم رسمی آموزش و سنجش کدنویسی آکادمی آیولرن طراحی، پیاده‌سازی و منتشر شده است.

• معمار ارشد نرم‌افزار و پدیدآورنده: امیرمحمد نهاوندی (Amir Nahavandi)
• شناسه رسمی ناشر در مایکروسافت: Aiolearn
• گیت‌هاب رسمی سازنده: github.com/amirnahavandi
• مخزن پروژه: github.com/amirnahavandi/aiolearn-school

Official English Documentation

Executive Overview

Aiolearn School is an enterprise-grade Visual Studio Code extension engineered to modernize computer science education. It eliminates the friction of traditional homework submission—doing away with manual archive compression, file uploads, screenshots, and asynchronous grading lag.

With Aiolearn School, students write, debug, and submit assignments directly inside VS Code. Submissions are instantly analyzed using an advanced hybrid grading pipeline combining Static Abstract Syntax Tree (AST) Inspection, Secure Sandbox Test Runners, and Deep Generative AI Evaluation powered by Google DeepMind technologies.

Instructors are provided with a dedicated classroom management cockpit to distribute lectures, define structured assignments, search and monitor student progress in real-time, and synchronize grades directly with modern Learning Management Systems (LMS).

Key Features

1. Deep AI Code Evaluation & Pinpoint Line Diagnosis

• Exact File & Line Pinpointing: Pinpoints runtime tracebacks and syntax errors with file name and line number (e.g., Line 14 in models.py).
• Pedagogical Feedback: Provides constructive explanations designed to guide students toward the correct architectural pattern without bluntly giving away answers.
• Complex Multi-File Analysis: Comprehends multi-module architectures, recursive imports, object-oriented design patterns, and package structures.

2. Multi-File & Folder Evaluation System

• Modular Codebase Support: Seamlessly handles multi-file projects (separating models, views, controllers, and utility modules).
• Smart Entrypoint Detection: Automatically recognizes and links standard application entry points such as main.py, app.py, or run.py.
• Workspace Folder Picker: Allows students to select an active workspace folder or browse custom project directories directly from VS Code.

3. Frictionless In-Editor Workflow

• One-Click Submissions: Send code directly to the evaluation pipeline without switching windows.
• Instant Verification: Immediate feedback indicator displayed within seconds.
• Local Offline-First Resilience: Built to connect seamlessly to local servers (127.0.0.1:8000) or cloud deployments with zero third-party messaging dependencies.

4. Instructor Command Center & Classroom Management

• Class & Session Assignment Creation: Deploy assignments with custom due dates, interactive quick-presets, and precision session steppers.
• Interactive Live Student Search: Instant search filter across students by name or phone number with real-time class grouping.
• Course Asset Distribution: Upload and distribute lecture materials, source code templates, slides, and datasets directly to students' sidebars.
• Analytical Gradebook & Excel Export: Export comprehensive grade matrices and submission logs into clean Excel spreadsheets with one click.

5. Modern Ergonomics & Typography

• Glassmorphic Dark Theme: Built with a modern, translucent aesthetic tailored specifically for high-focus coding environments.
• Native Vazirmatn Font Integration: Fully embedded local typography ensuring crisp Persian (RTL) and English (LTR) rendering.
• Precision Stepper: Smooth increment/decrement controls with mouse-wheel support, keyboard navigation, and rapid-hold acceleration.

How It Works

For Students:

1. Open the Aiolearn School panel in the VS Code Activity Bar.
2. Log in using your registered student credentials.
3. Choose your submission scope: Single Active File or Complete Project Folder.
4. Click Submit & AI Evaluate to receive immediate automated analysis.

For Instructors:

1. Switch to the Teacher Workspace tab.
2. Select target class, session number, title, and deadline.
3. Manage active submissions, review code tracebacks, or upload reference lecture files.
4. Export real-time student performance metrics to Excel.

Developed & Published By

• Lead Software Architect & Creator: Amir Nahavandi (امیرمحمد نهاوندی)
• VS Code Marketplace Publisher: Aiolearn
• Official GitHub Profile: @amirnahavandi
• Source Repository: amirnahavandi/aiolearn-school

Designed, developed, and published by Amir Nahavandi as an official pedagogical and assessment platform for Aiolearn students and programming academies worldwide.