Q-Ace Tutor | סביבת למידה חכמה לפייתון

Q-Ace Tutor היא פלטפורמה לימודית מתקדמת שנועדה להנגיש את עולם התכנות בשפת Python לתלמידים וסטודנטים. המערכת משלבת כלים ויזואליים, עורך קוד עוצמתי ותמיכה מבוססת בינה מלאכותית (AI) כדי להפוך את תהליך הלמידה לחווייתי, אינטראקטיבי ומותאם אישית.

✨ פיצ'רים מרכזיים

1. AlgoDesigner - מתכנן האלגוריתמים הוויזואלי

ממשק "גרור ושחרר" (Drag & Drop) המאפשר לתכנן את הלוגיקה של התוכנית באמצעות תרשימי זרימה.

• צמתים חכמים: קלט/פלט, תהליכים, החלטות (if/else) ולולאות.
• יצירת שלד קוד: המערכת הופכת את התרשים הוויזואלי לקוד Python תקני באופן אוטומטי.
• בדיקת לוגיקה: ה-AI מנתח את התרשים ומציע שיפורים או מתריע על בעיות לוגיות.

2. IDE חכם (Code Editor)

סביבת פיתוח מבוססת Monaco Editor (המנוע של VS Code) המותאמת לדפדפן.

• הרצת קוד מקומית: שימוש ב-Pyodide להרצת פייתון ישירות בדפדפן ללא צורך בהתקנת שרת.
• טרמינל אינטראקטיבי: ממשק טרמינל מלא (Xterm.js) התומך בקלט (input) ופלט (print).
• שמירה אוטומטית: ניהול פרויקטים וקבצים עם שמירה לענן (DB).

3. AI Assistance - המורה הפרטי שלך

אינטגרציה עם מודלי שפה מתקדמים (Gemini / Ollama):

• הסבר שגיאות: בלחיצת כפתור, ה-AI מנתח שגיאות ריצה ומסביר איך לתקן אותן.
• רמזים (Hints): עזרה ממוקדת מבלי לפתור את התרגיל במלואו, כדי לעודד למידה עצמאית.
• תיעוד אוטומטי: ה-AI יכול להוסיף הערות והסברים לקוד קיים.
• צ'אט מונחה (Ask Me): ממשק שיחה לשאלות ותשובות על הפרויקט.

🛠 ️ טכנולוגיות בשימוש

Frontend

• Vue.js 3: Framework מרכזי לניהול מצב האפליקציה.
• Tailwind CSS: עיצוב מודרני, כהה (Dark Mode) ורספונסיבי.
• Vue Flow: ספרייה לניהול תרשימי זרימה ודיאגרמות.
• Monaco Editor: עורך הקוד המקצועי של מיקרוסופט.
• Xterm.js: סימולציית טרמינל מקצועית.
• Pyodide: מנוע WebAssembly המריץ Python 3.11+ בדפדפן.

Backend

• PHP: ניהול ה-API ושירותי הנתונים.
• SQLite: בסיס נתונים קל ומהיר לאחסון פרויקטים, קוד והגדרות משתמש.

AI Engines

• Google Gemini API: לניתוח לוגי ותמיכה בזמן אמת.
• Ollama: תמיכה במודלים מקומיים (כגון Gemma/Llama) לפרטיות מירבית.

🚀 התקנה והרצה

1. דרישות קדם:

   • שרת אינטרנט (Apache / Nginx) עם תמיכה ב-PHP 7.4+.
   • גישת כתיבה לתיקיית הפרויקט (ליצירת קובץ ה-Database).

2. שלבי התקנה:

   • העתק את כל קבצי הפרויקט לתיקיית ה-Root של השרת.
   • וודא שקובץ ה-Database qace.db נוצר וניתן לכתיבה.
   • הגדר את מפתח ה-API של Gemini בקובץ api/config.php (אופציונלי אך מומלץ).

3. הגדרות AI:

   • ניתן לשלוט בספק ה-AI (Gemini או Ollama) דרך מסך ההגדרות בתוך האפליקציה.

📁 מבנה הפרויקט

• index.html - דף הכניסה המרכזי.
• /js - לוגיקת צד הלקוח (רכיבי Vue, שירותי API).
• /api - נקודות קצה ב-PHP וניהול בסיס נתונים.
• /css - עיצובים מותאמים אישית.
• /assets - תבניות (Templates) ונתוני עזר.

נבנה ב-❤️ על ידי עתיד האוטומציה