سؤول (Sawol) — شريك المعلّم في تلعيب التعليم وتحفيز التفاعل

سؤول ليس مجرد مولّد أسئلة، بل هو أداة ذكية مصممة خصيصاً للمعلّم والمربي العصري الذي يسعى لـ "تلعيب التعليم" (Gamification). يساعدك سؤول على تحويل الدروس الصعبة إلى تحديات تفاعلية مثيرة، حيث يقوم بإنشاء أسئلة اختيار من متعدد (MCQ) فورية ومخصصة بناءً على الذكاء الاصطناعي المحلي، مما يضمن لك الخصوصية الكاملة والسرعة الفائقة في خلق بيئة تعليمية محفزة.

---

1) نظرة عامة: لماذا سؤول؟

في عصر التعليم الرقمي، أصبح جذب انتباه الطلاب وتفاعلهم هو التحدي الأكبر. يأتي سؤول ليكون رفيقك في الفصل الدراسي أو في جلسات المذاكرة الخاصة، بهدف:

• تلعيب المحتوى التعليمي: تحويل المعلومات إلى تحديات سريعة تثير فضول الطلاب وتزيد من حماسهم للمشاركة.
• كسر الجمود الدراسي: توليد أسئلة فورية في أي لحظة خلال الدرس لقياس الفهم بأسلوب تنافسي ممتع.
• تعزيز التعلم النشط: بدلاً من التلقين، يختبر الطالب نفسه ويحصل على تغذية راجعة فورية، مما يجعل الخطأ وسيلة للتعلم وليس مجرد درجة.

الفئة المستهدفة:

• المعلمون والمعلمات: الراغبون في ابتكار أنشطة صفية تفاعلية "ثوانٍ معدودة".
• المدرّبون: لعمل مراجعات سريعة ومنعشة في ورش العمل.
• الطلاب الشغوفون: لتحويل المذاكرة الروتينية إلى "لعبة" تحدي للذات.

---

2) المميزات الرئيسية (لمسة التلعيب)

• صناعة التحدي بلحظة: اكتب أي موضوع دراسي، واجعل الذكاء الاصطناعي يبهرك بسؤال ذكي ومبتكر فوراً.
• مستويات تصاعدية (Easy to Hard): صمم مساراً تعليمياً يبدأ بالسهولة لبناء الثقة، وينتهي بالصعوبة لخلق روح التحدي.
• تغذية راجعة ذكية (Immediate Feedback): لا يكتفي البرنامج بقول "خطأ" أو "صح"، بل يقدم شرحاً يضيء عقل الطالب، تماماً كالمعلم الخاص.
• تكرار بلا ملل (Infinite Questions): خاصية "Next Question" تضمن تدفقاً مستمراً من الأسئلة لنفس الموضوع، مما يساعد على إتقان المهارة بأسلوب اللعب المستمر.
• بيئة آمنة وخاصة: كل شيء يحدث على جهازك، لا حاجة للإنترنت أو القلق على خصوصية بيانات طلابك.

---

3) المتطلبات الأساسية (لتشغيل النسخة الجاهزة)

هذه المتطلبات للمستخدم الذي سيحمّل البرنامج جاهزاً. لا تحتاج تثبيت npm أو Node.js أو أدوات تطوير.

• نظام التشغيل:
  • Windows 10/11 (64‑bit)
  • macOS (إصدار حديث)
• Ollama:
  • يجب تثبيته وتشغيله محلياً على جهازك.
• مودل محلي:
  • تنزيل مودل gemini3 داخل Ollama (الخطوات بالأسفل).
• اتصال إنترنت:
  • مطلوب فقط لتنزيل Ollama والمودل لأول مرة. بعد ذلك يمكن تشغيل البرنامج محلياً.

---

4) خطوات التثبيت (من الصفر وحتى أول تشغيل)

أ) تثبيت برنامج سؤول (النسخة الجاهزة)

1. حمّل النسخة المناسبة لنظامك من صفحة الإصدارات (Releases) الخاصة بالمشروع.
2. ثبّت البرنامج كأي برنامج عادي:
   • Windows: شغّل ملف التثبيت (.exe أو .msi) واتبع الخطوات.
   • macOS: افتح ملف (.dmg) وانسخ التطبيق إلى Applications.
3. افتح سؤول لأول مرة. إذا ظهرت رسالة “Ollama غير متاح / not reachable”، انتقل لخطوات تثبيت Ollama بالأسفل ثم أعد فتح البرنامج.

ب) تثبيت Ollama من الموقع الرسمي

1. افتح الموقع الرسمي لـ Ollama من هنا: https://ollama.com/download
2. اختر نظام التشغيل وثبّت البرنامج بالطريقة المعتادة.
3. بعد التثبيت:
   • Windows: افتح Ollama من قائمة Start (أو شغّله كخدمة إن توفّر).
   • macOS: افتح Ollama وسيعمل في الخلفية.

الهدف من هذه الخطوة هو أن يكون Ollama يعمل محلياً قبل تشغيل سؤول.

إذا واجهت مشكلة “غير متاح”، جرّب إعادة تشغيل Ollama (أغلقه ثم افتحه) ثم أعد تشغيل سؤول.

ج) تنزيل مودل gemini3 داخل Ollama

1. افتح الطرفية (Terminal / PowerShell).
2. نفّذ أحد الأوامر التالية:

ollama pull gemini3

إذا رغبت بالتأكد أنه يعمل بعد التحميل:

ollama run gemini3

3. اترك Ollama يعمل في الخلفية.
4. افتح برنامج سؤول، ثم من الإعدادات اجعل اسم المودل: gemini3 (إن لم يكن مضبوطاً بالفعل).

ملاحظة: أسماء المودلات في Ollama قد تختلف حسب التوفّر لديك. إذا لم ينجح الأمر، افتح موقع Ollama وابحث عن اسم المودل الصحيح ثم استخدمه داخل سؤول.

---

5) رحلة التحدي: كيف تبدأ؟

ببضع نقرات فقط، يمكنك إطلاق تجربة تعليمية فريدة في فصلك الدراسي:

1. شغّل سؤول: واجهة بسيطة ونظيفة تنتظرك.
2. حدد ميدان التحدي: اكتب الموضوع (مثلاً: "عجائب الدنيا"، "قواعد اللغة العربية"، "دورة حياة الخلية").
3. اختر مستوى المغامرة: حدد مستوى الصعوبة بما يتناسب مع قدرات طلابك.
4. أطلق السؤال (Generate): سيظهر السؤال أمامك فوراً، جاهزاً للمناقشة أو المسابقة.
5. تفاعل مع النتائج: بعد اختيار الإجابة، استثمر "الشرح المختصر" لتعميق الفهم وتصحيح المفاهيم الخاطئة بأسلوب شيق.
6. استمر في اللعب: اضغط Next Question لتوليد تحدٍ جديد وإبقاء جذوة الحماس مشتعلة.

نصائح للمعلّم المبدع

• مسابقات المجموعات: قسّم الفصل لمجموعات واستخدم سؤول لتوليد أسئلة سريعة، والمجموعة الأسرع في الإجابة الصحيحة تربح نقطة.
• تحدي الدقيقة الواحدة: استخدم البرنامج لعمل مراجعة "خاطفة" في بداية أو نهاية الحصة.
• تخصيص التجربة: من الإعدادات، يمكنك ضبط "درجة الإبداع" (Temperature) للحصول على أسئلة أكثر ابتكاراً تثير دهشة طلابك.

---

6) دعم وصيانة

• الدعم الفني: في حال واجهت مشكلة أو احتجت مساعدة، راسل المطوّر على البريد: support@lyaqti.com
• التحديثات: تابع صفحة الإصدارات (Releases) للحصول على آخر نسخة وتحسينات وإصلاحات.
• أفضل ممارسات للاستقرار:
  • تأكد أن Ollama يعمل قبل تشغيل سؤول.
  • عند تحديث Ollama أو تغيير المودل، اختبر التشغيل مرة واحدة (توليد سؤال) للتأكد من الاستقرار.
  • إذا ظهرت مشكلة اتصال، أعد تشغيل Ollama ثم أعد فتح سؤول.

---

للمطورين (معلومات البناء والتطوير)

هذا القسم مخصص للمطورين الذين يريدون تشغيل المشروع من المصدر أو بناء الحزم.

المتطلبات للمطور

• Node.js 18+ و npm
• Rust toolchain (stable)
• أدوات البناء حسب النظام:
  • macOS: Xcode Command Line Tools
  • Windows: Visual Studio 2022 Build Tools (C++ workload)
• Ollama مثبت ويعمل محلياً، مع مودل محمّل

مثال لتحميل مودل (قد يستغرق أول مرة):

ollama run llama3.1

التثبيت (للمطور)

npm install

التطوير

npm run dev

البناء (Packaging)

npm run build

ينتج مثبتات/حزم للنظام:

• macOS: .app/.dmg تحت src-tauri/target/
• Windows: .exe/.msi تحت src-tauri/target/

عقد الـ JSON (مرجع)

Strict single-question JSON:

{
  "id": "string (uuid-v4)",
  "subject": "string",
  "question": "string",
  "options": ["string", "string", "string", "string"],
  "correctIndex": 0,
  "explanation": "string",
  "difficulty": "easy|medium|hard"
}

Validation rules:

• Exactly 4 options
• Options must be unique and concise
• correctIndex in [0..3]
• Explanation under ~280 chars

الإعدادات

من داخل التطبيق (أيقونة الترس) يمكن ضبط:

• Model (افتراضي: llama3.1)
• Temperature (0–1, افتراضي: 0.2)

الإصدارات (GitHub)

هذا المستودع يحتوي على Workflow للإصدارات عبر GitHub Actions في ملف: .github/workflows/release.yml لإنشاء حزم لأنظمة متعددة ثم إنشاء مسودة Release.

1) تحديث رقم النسخة (حافظ على التطابق)

قم بتحديث النسخة في:

• package.json
• src-tauri/tauri.conf.json
• src-tauri/Cargo.toml

مثال:

git add package.json src-tauri/tauri.conf.json src-tauri/Cargo.toml
git commit -m "chore(release): v0.1.1"

2) تشغيل الـ Workflow

إما عبر Tag (مفضل):

git tag v0.1.1
git push origin v0.1.1

أو يدوياً من GitHub → Actions → “Release” → “Run workflow”.

3) (اختياري) التوقيع

يمكن إضافة أسرار (Secrets) للتوقيع على macOS/Windows. بدونها ستصدر حزم غير موقعة وقد يحتاج المستخدم لبعض خطوات السماح بالتشغيل.