شغّل Learnio محليًا
ثبّت كل تطبيق وشغّله باستخدام Node.js و Yarn، بطرفية مستقلة لكل تطبيق.
لحزمة الحزمة الكاملة
قبل أن تبدأ: ثبّت Node.js 22 أو 24 وشغّل corepack enable مرة واحدة. لا حاجة إلى خادم قاعدة بيانات.
افتح كل طرفية في المكان الذي تتوقعه الأوامر أدناه: داخل learnio-lms للحزمة الكاملة، أو بجوار مجلد التطبيق لحزمة التطبيق الواحد.
| التطبيق | المجلد | العنوان |
|---|---|---|
| API | back-end | localhost:8000محلي |
| موقع الطلاب | frontend | localhost:3030محلي |
| لوحة الإدارة | admin-dashboard | localhost:3031محلي |
شغّل واجهة API أولًا: تقرأ الواجهتان الأماميتان كل بياناتهما منها.
شغّل واجهة API
ثبّت واضبط الإعداد
يعمل
.env.exampleكما هو للتطوير المحلي. ينتهيyarn installبالرسالة "Done with warnings"، وهذا متوقع؛ أما الفشل الحقيقي فينتهي بالرسالة "Failed with errors".الطرفيةcorepack enable cd back-end yarn install cp .env.example .envتواجه مشكلة؟أنشئ قاعدة البيانات
ينشئ
yarn seedالملفdatabase.sqliteوجداوله والبيانات التجريبية. تشغيله مرة أخرى لا يضيف شيئًا جديدًا.الطرفيةفيback-endyarn seedشغّل الخادم
الطرفيةفيback-endyarn devالنتيجة المتوقعة: يجيب localhost:8000/
تواجه مشكلة؟api/ healthمحلي بحالة ok.
شغّل موقع الطلاب
في طرفية ثانية:
ثبّت واضبط الإعداد
الطرفيةcd frontend yarn install cp .env.example .envشغّله
الطرفيةفيfrontendyarn devالنتيجة المتوقعة: يفتح localhost:3030محلي الموقع بالإنجليزية؛ والعربية على
تواجه مشكلة؟/ar.
واجهة API ليست جزءًا من هذه الحزمة. من دونها، يعمل الموقع على بياناته النموذجية المرفقة ويظهر إشعار "Sample data" أسفل الصفحة ليوضح ذلك. وجّه NEXT_PUBLIC_API_BASE_URL إلى واجهة API من Learnio عندما تتوفر لديك.
شغّل لوحة الإدارة
في طرفية ثالثة:
ثبّت واضبط الإعداد
الطرفيةcd admin-dashboard yarn install cp .env.example .envشغّلها وسجّل الدخول
الطرفيةفيadmin-dashboardyarn devالنتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. حساب المدير العام هو
تواجه مشكلة؟admin@learnio.comبكلمة المرورAdmin@123.
واجهة API ليست ضمن هذه الحزمة. من دونها تعمل كل الشاشات على بيانات نموذجية مدمجة، ويسجّل أي بريد إلكتروني وأي كلمة مرور دخولك بصفة المدير العام. تُحفظ تغييراتك في تخزين المتصفح. اربطها بواجهة API لتعمل على بياناتك، ولتستخدم المساعد الذكي والحصص المباشرة.
الإعداداتابدأ من جديد ببيانات تجريبية جديدة
أوقف واجهة API، ثم احذف ملف قاعدة البيانات واملأه بالبيانات التجريبية من جديد. هذا يحذف كل ما أنشأته.
back-endrm -f database.sqlite && yarn seedفي PowerShell:
back-endRemove-Item database.sqlite; yarn seed