Skip to content

Latest commit

 

History

History
328 lines (245 loc) · 20.8 KB

File metadata and controls

328 lines (245 loc) · 20.8 KB

Studyield - تعلم بذكاء أكبر مع التحضير للامتحانات المدعوم بالذكاء الاصطناعي، حل المشكلات متعدد الوكلاء، الرسوم البيانية للمعرفة والمزيد

License GitHub Stars Issues Pull Requests

التوثيق | البدء السريع | المناقشات | المساهمة

English | 日本語 | 中文 | 한국어 | Español | Français | Deutsch | Português | العربية | বাংলা | हिन्दी | Русский


ما هو Studyield؟

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

على عكس منصات التعلم التقليدية التي تركز فقط على تقديم المحتوى أو أدوات التدريس بالذكاء الاصطناعي التي تفتقر إلى ميزات الدراسة الشاملة، توفر Studyield نظامًا تعليميًا كاملاً مع 6 ميزات قوية للذكاء الاصطناعي، ومجموعة أدوات دراسية كاملة، والوصول عبر منصات متعددة.

كيف يعمل

  1. ارفع موادك -- أضف مواد الدراسة (PDF، المستندات، الامتحانات السابقة) إلى قاعدة معرفتك
  2. الذكاء الاصطناعي يحلل وينظم -- يستخرج الذكاء الاصطناعي المفاهيم الرئيسية، ويبني رسوم بيانية للمعرفة، وينشئ تضمينات قابلة للبحث
  3. تدرب وتعلم -- أنشئ امتحانات تدريبية، وحل المشكلات باستخدام الذكاء الاصطناعي متعدد الوكلاء، واختبر نفسك ببطاقات التذكير
  4. احصل على التعليقات -- استخدم تقييم التعليم العكسي لاختبار فهمك وتحديد الفجوات المعرفية
  5. تتبع التقدم -- راقب سرعة التعلم ومستويات الإتقان وأنماط الدراسة من خلال التحليلات

القدرات الرئيسية

  • 🎯 نسخ الامتحان -- ارفع الامتحانات السابقة وأنشئ أسئلة تدريبية جديدة بنفس الأسلوب والصعوبة والشكل
  • 🤖 حل المشكلات متعدد الوكلاء -- وكلاء التحليل والحل والتحقق يعملون معًا لحل المشكلات المعقدة مع البث المباشر
  • 🕸️ الرسم البياني للمعرفة -- استخراج تلقائي للكيانات والعلاقات من مواد الدراسة إلى تصورات تفاعلية
  • 🎙️ تقييم التعليم العكسي -- يشرح الطلاب المفاهيم (نص/صوت)، ويقيم الذكاء الاصطناعي الفهم باستخدام تقنية فاينمان
  • 🔬 وضع البحث العميق -- RAG من المواد المرفوعة + بحث الويب، ينتج تقارير منظمة مع الاستشهادات
  • 💻 صندوق الكود -- تنفيذ Python آمن مع دعم NumPy وPandas والمكتبات العلمية
  • 📚 قاعدة المعرفة -- ارفع المستندات (PDF، DOCX) للبحث الدلالي وRAG
  • 🃏 بطاقات التذكير مع SRS -- نظام التكرار المتباعد للحفظ الأمثل
  • 📝 اختبارات قصيرة تم إنشاؤها بواسطة الذكاء الاصطناعي -- إنشاء اختبارات تلقائية من مواد الدراسة
  • 💬 دردشة RAG -- ذكاء اصطناعي محادثة مع استشهادات من مستنداتك
  • 🗺️ مسارات التعلم -- مسارات دراسية مثالية تم إنشاؤها بواسطة الذكاء الاصطناعي
  • 📊 تحليلات التقدم -- تتبع وقت الدراسة ومستويات الإتقان وسرعة التعلم
  • 🌍 12 لغة -- دعم i18n كامل (EN, JA, ZH, KO, ES, FR, DE, PT, AR, BN, HI, RU)
  • 📱 ويب + موبايل -- واجهة React وتطبيق موبايل Flutter

المشكلة التي نحلها

معضلة التعلم الحديث

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

نقاط الألم الشائعة التي نعالجها:

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

حل Studyield

تدريب بأسلوب الامتحان -- انسخ امتحاناتك الفعلية لإنشاء أسئلة تدريبية متطابقة تمامًا

منصة شاملة -- قاعدة معرفة وبطاقات تذكير واختبارات ودردشة وبحث وتحليلات في مكان واحد

فهم عميق -- تقييم التعليم العكسي وحل المشكلات متعدد الوكلاء يضمن الفهم الحقيقي

رسوم بيانية تلقائية للمعرفة -- الذكاء الاصطناعي يستخرج ويربط المفاهيم تلقائيًا من موادك

ميزات ذكاء اصطناعي متقدمة -- حل متعدد الوكلاء، بحث عميق، تنفيذ الكود، وبث مباشر

استضافة ذاتية ومفتوحة المصدر -- تعمل على البنية التحتية الخاصة بك، تحكم كامل في بياناتك

ابدأ مجانًا -- مفتوح المصدر مع نشر Docker، إصدار مستضاف اختياري بأسعار عادلة

لماذا Studyield؟ (المقارنة)

الميزة Studyield Quizlet Anki ChatGPT Khan Academy
نسخ الامتحان ✅ تم إنشاؤه بواسطة الذكاء الاصطناعي
حل المشكلات متعدد الوكلاء ✅ 3 وكلاء + بث ✅ وكيل واحد
رسوم بيانية المعرفة ✅ تلقائي
تقييم التعليم العكسي ✅ نص + صوت ⚠️ يدوي
وضع البحث العميق ✅ RAG + ويب
صندوق الكود ✅ تنفيذ آمن
بطاقات التذكير (SRS)
دردشة RAG ✅ مع استشهادات ✅ بدون مستندات N/A
مسارات التعلم ✅ تم إنشاؤها بالذكاء الاصطناعي ✅ مبنية مسبقًا
تحليلات التقدم ⚠️ أساسي
استضافة ذاتية
مفتوح المصدر ✅ Apache 2.0 ✅ AGPL
متعدد المنصات ✅ ويب + موبايل
منحنى التعلم 🟢 منخفض 🟢 منخفض 🟡 متوسط 🟢 منخفض 🟢 منخفض

📊 نشاط المشروع والإحصائيات

Studyield هو مشروع يتم صيانته بنشاط مع مجتمع متنامٍ.

نشاط GitHub

GitHub Stars Forks Contributors Last Commit

البدء السريع

Docker (موصى به)

نفذ هذه الأوامر من جذر المشروع:

git clone https://github.com/studyield/studyield.git
cd studyield
cp backend/.env.example backend/.env
# عدل backend/.env ببيانات اعتماد قاعدة البيانات ومفتاح API OpenRouter
docker compose --env-file .env.docker up -d

هذا كل شيء! الوصول إلى التطبيق على http://localhost:5189 وAPI على http://localhost:3010.

الإعداد اليدوي

المتطلبات الأساسية: Node.js 20+، PostgreSQL 15+، Redis 7+

# استنساخ
git clone https://github.com/studyield/studyield.git
cd studyield

# الخادم الخلفي
cd backend
cp .env.example .env
npm install
npm run migrate
npm run start:dev

# الواجهة الأمامية (في terminal جديد)
cd frontend
cp .env.example .env
npm install
npm run dev

زُر http://localhost:5189 للوصول إلى التطبيق.

الهندسة المعمارية

┌─────────────────────────────────────────────────────────────────┐
│                         Studyield Platform                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                   │
│  ┌──────────────┐     ┌──────────────┐     ┌──────────────┐    │
│  │   React Web  │     │   Flutter    │     │  REST + WS   │    │
│  │  (Frontend)  │────▶│    Mobile    │────▶│     API      │    │
│  └──────────────┘     └──────────────┘     └──────┬───────┘    │
│                                                     │            │
│  ┌──────────────────────────────────────────────────┼──────────┐│
│  │              NestJS Backend (27 Modules)         │          ││
│  ├──────────────────────────────────────────────────┼──────────┤│
│  │  Auth │ AI │ Exam Clone │ Problem Solver │ Chat │          ││
│  │  Teach-Back │ Research │ Knowledge Graph │ Quiz │          ││
│  │  Flashcards │ Learning Paths │ Analytics │ ...  │          ││
│  └──────────────────────────────────────────────────┼──────────┘│
│                                                     │            │
│  ┌──────────────┐  ┌──────────────┐  ┌────────────┼──────────┐ │
│  │  PostgreSQL  │  │    Redis     │  │   Qdrant   │ClickHouse│ │
│  │  (Core Data) │  │  (Cache+MQ)  │  │  (Vectors) │(Analytics│ │
│  └──────────────┘  └──────────────┘  └────────────┴──────────┘ │
│                                                                   │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │  External Services: OpenRouter, OpenAI, Cloudflare R2,     │ │
│  │  AWS SES, Firebase, Stripe                                 │ │
│  └─────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

المجموعة التقنية

الطبقة التقنية
الخادم الخلفي NestJS 10، TypeScript، PostgreSQL (SQL خام)، Redis، Qdrant، ClickHouse، BullMQ، Socket.io
الواجهة الأمامية React 19، Vite، TypeScript، Tailwind CSS، Radix UI (shadcn)، Zustand، React Query، i18next
الموبايل Flutter 3.10+، Provider + BLoC، Dio، Go Router، Firebase، Easy Localization
الذكاء الاصطناعي OpenRouter (Claude، GPT، إلخ.)، OpenAI Embeddings، LangChain

i18n

يدعم Studyield 12 لغة عبر i18next (الواجهة الأمامية) وEasy Localization (الموبايل):

  • English، 日本語، 中文، 한국어، Español، Français، Deutsch، Português، العربية، বাংলা، हिन्दी، Русский

🚀 لماذا تساهم في Studyield؟

Studyield أكثر من مجرد مشروع آخر مفتوح المصدر -- إنها فرصة لبناء مستقبل التعليم المدعوم بالذكاء الاصطناعي وجعل التعلم عالي الجودة متاحًا لملايين الطلاب في جميع أنحاء العالم.

🗺️ خارطة طريق المشروع

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

🎯 دليل المساهمة السريع

ابدأ المساهمة في أقل من 5 دقائق:

الخطوة 1: إعداد بيئتك

# قم بعمل fork للمستودع على GitHub، ثم استنسخ fork الخاص بك
git clone https://github.com/YOUR_USERNAME/studyield.git
cd studyield

# ابدأ مع Docker (أسهل طريقة)
cp backend/.env.example backend/.env
docker compose --env-file .env.docker up -d

# الوصول إلى التطبيق
# الواجهة الأمامية: http://localhost:5189
# API الخادم الخلفي: http://localhost:3010

الخطوة 2: ابحث عن شيء للعمل عليه

اختر بناءً على مستوى خبرتك:

🟢 صديق للمبتدئين

🟡 متوسط

  • 🔌 إضافة أدوات أو قدرات جديدة لوكلاء الذكاء الاصطناعي
  • 📊 تحسين لوحة التحليلات والتصورات
  • 🧪 كتابة الاختبارات

🔴 متقدم

المساهمة

نرحب بالمساهمات! راجع دليل المساهمة للبدء.

المساهمون

شكرًا لجميع الأشخاص الرائعين الذين ساهموا في Studyield! 🎉

💬 انضم إلى مجتمعنا

تواصل مع المطورين واحصل على المساعدة وابق على اطلاع بأحدث تطورات Studyield!

GitHub Discussions Twitter

الأمان

يُرجى الإبلاغ عن الثغرات الأمنية بمسؤولية. راجع SECURITY.md لسياسة الإفصاح الخاصة بنا.

الترخيص

هذا المشروع مرخص بموجب Apache License 2.0.

Copyright 2025 Studyield Contributors.

الشكر والتقدير

تم البناء باستخدام NestJS وReact وFlutter وPostgreSQL وRedis وQdrant وClickHouse وOpenRouter والعديد من التقنيات الأخرى مفتوحة المصدر الرائعة.


الموقع | التوثيق | المناقشات | Twitter


تم البناء بـ ❤️ من قبل مجتمع Studyield

إذا وجدت هذا المشروع مفيدًا، يُرجى النظر في إعطائه نجمة! ⭐

Star on GitHub