Q-Ace Mentor | העוזר האישי שלך לאוטומציה

Q-Ace Mentor הוא חונך סוקרטי מבוססי בינה מלאכותית, שתוכנן במיוחד עבור סטודנטים לאוטומציית בדיקות. הוא לא רק נותן לכם את הקוד — הוא שואל את השאלות הנכונות כדי להוביל אתכם אל הפתרון, ועוזר לכם לפתח כישורי פתרון בעיות עמוקים.

🌟 תכונות מרכזיות

חניכה סוקרטית: ממשק צ'אט שמדריך אתכם דרך אתגרי קידוד מבלי לגלות את התשובה.
ניתוח Traceback: הדביקו כל שגיאת פייתון או Traceback, והחונך יסביר את ה"למה" וה"איך" שמאחורי הבאג בשפה פשוטה.
בוחן פתע (Surprise Quiz): צרו בחנים דינמיים המבוססים על רמת המיומנות הנוכחית שלכם ועל הנושא שבחרתם.
תמיכה דו-לשונית: תמיכה מלאה בכתיבה מימין לשמאל (RTL) עבור עברית, לצד אנגלית.
התאמה אישית דינמית:
- בחירה בין ערכות נושא בהירה וכהה.
- גודל גופן צ'אט מתכוונן.
- בחירת מודל ה-Gemini המועדף עליכם.
שמירת נתונים: כל ההגדרות וסשני הצ'אט שלכם נשמרים באופן אוטומטי במסד נתונים מקומי.

🛠 ️ טכנולוגיות

Backend: PHP 8.0 ומעלה (ללא Framework)
מסד נתונים: SQLite עם PDO
מנוע AI: Google Gemini Pro (דרך אינטגרציית HTTP ישירה)
Frontend: Vanilla JavaScript (ES6+), HTML5, CSS3

🚀 מתחילים

1. דרישות קדם

שרת אינטרנט עם PHP 8.0 ומעלה.
מפתח Google API עבור Gemini. קבלו אחד כאן. (תזינו אותו בממשק הגדרות האפליקציה).

2. התקנה

פשוט שכפלו או הורידו את הריפו לתיקייה הציבורית של שרת האינטרנט שלכם:

git clone https://github.com/your-repo/q-ace-mentor.git

3. הרצת האפליקציה

אם מותקן אצלכם PHP, תוכלו להריץ אותו מקומית ללא שרת אינטרנט נפרד:

php -S localhost:8056

פתחו את הכתובות http://localhost:8056 בדפדפן.

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

q-ace-mentor/
├── api/                    # לוגיקת PHP Backend
│   ├── index.php           # ראוטר API ראשי
│   ├── ai.php              # שירות אינטגרציה של Gemini API
│   ├── db.php              # חיבור למסד נתונים עם PDO
│   └── prompts.php         # פרומפטים של מערכת ה-AI
├── js/                     # מודולי JS של ה-Frontend
│   ├── app.js              # קונטרולר ראשי
│   ├── api.js              # לקוח Fetch
│   └── i18n.js             # מנוע תרגום
├── css/                    # רכיבי עיצוב
└── q_ace_mentor.db         # מסד נתונים SQLite מקומי

🌍 לוקליזציה

הפרויקט משתמש במנוע לוקליזציה מותאם אישית עבור עברית ואנגלית. כל המחרוזות מנוהלות ב-js/i18n.js. המעבר בין RTL/LTR מתבצע באופן דינמי בהתאם לשפה שנבחרה.

🌓 ערכות נושא

הממשק תומך במצבי כהה ובהיר, הממומשים באמצעות משתני CSS הנמצאים ב-css/styles.css. ההגדרות נשמרות דרך נקודת הקצה api/index.php/settings.

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

תיעוד