توثيق «معرفة»

شغّل قالب أكاديمية «معرفة»، واجعله أكاديميتك، وجد الحل حين يتعطل شيء.

«معرفة» أكاديمية متكاملة للتعلّم عبر الإنترنت بالعربية والإنجليزية، صُمّمت للخليج: الأسعار بالريال العُماني، والدفع بالبطاقة عبر «ثواني»، ودروس مكتوبة بالعربية أولًا تُقرأ من اليمين إلى اليسار. يضم مشروع Next.js واحد أربعة أجزاء تتشارك قاعدة بيانات واحدة:

الجزء ما يقدّمه العنوان
موقع المتعلّمين الرئيسية، وكتالوج الدورات بالتصفية والبحث، وصفحات الدورات بمحتواها ودروس المعاينة المجانية، والسلة وإتمام الشراء، والمدرّبون، والمدونة، ومن نحن، والشروط، والخصوصية، وتسجيل المتعلّمين، والدورات المحفوظة /ar و/en
منطقة المتعلّم دوراتي مع التقدّم، ومشغّل الدروس مع الملاحظات، والاختبارات بالدرجات والمحاولات، وشهادات قابلة للطباعة مع صفحة تحقق عامة، والطلبات، ومراسلة المدرّبين، والملف الشخصي /ar/my/... و/ar/learn/...
لوحة الإدارة والمدرّبين نظرة عامة بالرسوم، والدورات بأقسامها ودروسها، والمجالات، والمدرّبون، وجدول الجلسات المباشرة، ومنشئ الاختبارات، والرسائل، والمتعلّمون، والتسجيلات، والطلبات، والأرباح، والمدونة، والتقييمات، والكوبونات، والمشرفون وأدوارهم، والإعدادات، والمساعد الذكي /ar/dashboard
واجهة API نقاط REST التي يستخدمها الطرفان مع التحقق من الأدوار، وتصلح لتطبيق جوال /api/...

ماذا ستحصل عليه

  • العربية أولًا من اليمين إلى اليسار، مع نسخة إنجليزية كاملة لكل صفحة، بما فيها اللوحة وهذا التوثيق.
  • دورات من أقسام ودروس. الدرس نص بصيغة Markdown، أو رابط فيديو (YouTube أو Vimeo أو ملف MP4) مع شرح تحته. ويمكن جعل أي درس معاينة مجانية.
  • اختبارات بأسئلة الاختيار من متعدد وصح وخطأ، ودرجة نجاح، وحد للمحاولات، وشرح يظهر بعد المحاولة. التصحيح يتم على الخادم، ولا تصل الإجابات الصحيحة إلى المتصفح قبل حفظ المحاولة.
  • التقدّم والشهادات تُحسب على الخادم: لا تصدر الشهادة إلا حين تكتمل كل الدروس وتُجتاز كل الاختبارات المطلوبة. لكل شهادة رمز مثل MRF-7KQ2-M9XD وصفحة عامة يتحقق منها أي أحد.
  • إتمام شراء مع الكوبونات: الدورات المجانية والكوبونات الكاملة تسجّل فورًا، والدفع بالبطاقة يمر عبر «ثواني» ونتأكد منه لديها قبل فتح الدورة، والتحويل البنكي ينتظر تأكيد المشرف.
  • دوران في اللوحة: مشرف يملك كل شيء، ومدرّب يرى دوراته ومتعلّميه ورسائله وجدوله وأرباحه فقط. وتحدد صفحة «أدوار المشرفين» الأقسام المتاحة للمدرّبين.
  • دفعات مباشرة: تقويم للجلسات بروابط الاجتماع يراها المتعلّمون المسجّلون في صفحة دورتهم.
  • ذكاء اصطناعي اختياري مع أي خدمة متوافقة مع OpenAI: كتابة أوصاف الدورات، واقتراح أسئلة الاختبار من نص الدرس، ومحادثة تجيب عن أسئلتك حول بياناتك.
  • أكاديمية تجريبية: 6 مجالات، و6 مدرّبين، و16 دورة فيها 105 دروس و16 اختبارًا، و6 مقالات، و40 متعلّمًا بتسجيلاتهم وتقدّمهم ومحاولاتهم وشهاداتهم وتقييماتهم وطلباتهم، وكلها بصور وُلّدت لهذا القالب.

البدء السريع

npm install
cp .env.example .env
npm run setup
npm run dev

افتح http://localhost:3305 للموقع وhttp://localhost:3305/ar/dashboard للوحة. يُنشأ أول حساب مشرف من ADMIN_EMAIL وADMIN_PASSWORD في ملف .env (راجع التثبيت).

أين تجد كل شيء

prisma/schema.prisma          جداول قاعدة البيانات
prisma/data/*.mjs             الأكاديمية التجريبية (الدورات والدروس والاختبارات والمدرّبون والمقالات)
prisma/seed.mjs               يملأ قاعدة بيانات فارغة وينشئ أول مشرف
messages/ar.json, en.json     كل نصوص الموقع واللوحة
src/app/[locale]/(site)       صفحات الموقع ومنطقة المتعلّم
src/app/[locale]/dashboard    صفحات اللوحة
src/app/[locale]/docs         هذا التوثيق (ملفات Markdown في docs/)
src/app/api                   واجهة الـ API
src/lib                       قواعد التعلّم والتسعير والأدوار والدفع والذكاء الاصطناعي والجلسات
src/components                مكونات الموقع واللوحة والتوثيق
src/app/globals.css           الألوان والخطوط والأشكال (هويتك)
public/images                 أغلفة الدورات وصور المدرّبين وصور المدونة والموقع
tests                         اختبارات الوحدات (npm test)
scripts                       اختبار الـ API الشامل، وفاحص الصفحات، ومولّد الصور

الخطوات التالية

  1. ثبّت المشروع وادخل إلى اللوحة.
  2. اضبط اسم أكاديميتك وبيانات التواصل والدفع من متغيرات البيئة ومن «اللوحة > الإعدادات».
  3. غيّر الألوان والخطوط من الهوية والألوان.
  4. اقرأ كيف تعمل الدورات والدروس والاختبارات والشهادات، ثم استبدل الدورات التجريبية بدوراتك.