شغّل 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

01
ثبّت واضبط الإعداد
يعمل .env.example كما هو للتطوير المحلي. ينتهي yarn install بالرسالة "Done with warnings"، وهذا متوقع؛ أما الفشل الحقيقي فينتهي بالرسالة "Failed with errors".
الطرفية
```
corepack enable
cd back-end
yarn install
cp .env.example .env
```
تواجه مشكلة؟
أنجزت هذه الخطوة
02
أنشئ قاعدة البيانات
ينشئ yarn seed الملف database.sqlite وجداوله والبيانات التجريبية. تشغيله مرة أخرى لا يضيف شيئًا جديدًا.
الطرفيةفي back-end
```
yarn seed
```
أنجزت هذه الخطوة
03
شغّل الخادم
الطرفيةفي back-end
```
yarn dev
```
النتيجة المتوقعة: يجيب localhost:8000/api/healthمحلي بحالة ok.
تواجه مشكلة؟
أنجزت هذه الخطوة

شغّل موقع الطلاب

في طرفية ثانية:

01
ثبّت واضبط الإعداد
الطرفية
```
cd frontend
yarn install
cp .env.example .env
```
أنجزت هذه الخطوة
02
شغّله
الطرفيةفي frontend
```
yarn dev
```
النتيجة المتوقعة: يفتح localhost:3030محلي الموقع بالإنجليزية؛ والعربية على /ar.
تواجه مشكلة؟
أنجزت هذه الخطوة

واجهة API ليست جزءًا من هذه الحزمة. من دونها، يعمل الموقع على بياناته النموذجية المرفقة ويظهر إشعار "Sample data" أسفل الصفحة ليوضح ذلك. وجّه NEXT_PUBLIC_API_BASE_URL إلى واجهة API من Learnio عندما تتوفر لديك.

الإعدادات

شغّل لوحة الإدارة

في طرفية ثالثة:

01
ثبّت واضبط الإعداد
الطرفية
```
cd admin-dashboard
yarn install
cp .env.example .env
```
أنجزت هذه الخطوة
02
شغّلها وسجّل الدخول
الطرفيةفي admin-dashboard
```
yarn dev
```
النتيجة المتوقعة: يفتح localhost:3031محلي نموذج تسجيل الدخول. حساب المدير العام هو admin@learnio.com بكلمة المرور Admin@123.
تواجه مشكلة؟
أنجزت هذه الخطوة

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

الإعدادات

ابدأ من جديد ببيانات تجريبية جديدة

أوقف واجهة API، ثم احذف ملف قاعدة البيانات واملأه بالبيانات التجريبية من جديد. هذا يحذف كل ما أنشأته.

الطرفيةفي back-end

rm -f database.sqlite && yarn seed

في PowerShell:

الطرفيةفي back-end

Remove-Item database.sqlite; yarn seed

شغّل واجهة API

ثبّت واضبط الإعداد

أنشئ قاعدة البيانات

شغّل الخادم

شغّل موقع الطلاب

ثبّت واضبط الإعداد

شغّله

شغّل لوحة الإدارة

ثبّت واضبط الإعداد

شغّلها وسجّل الدخول

ابدأ من جديد ببيانات تجريبية جديدة

التالي

تفضيلات ملفات تعريف الارتباط