متغيرات البيئة

كل إعداد في ملف ‎.env، وما يفعله، ومتى تغيّره. وما سواها يُضبط من «اللوحة > الإعدادات».

انسخ .env.example إلى .env. هنا القيم التي لا يصح أن تكون في قاعدة البيانات: الأسرار والمفاتيح وعنوان الموقع. أما اسم الأكاديمية وبيانات التواصل ومفاتيح الدفع والضريبة وبيانات التحويل وحصة المدرّب وتوقيع الشهادة فتُعدَّل من «اللوحة > الإعدادات».

الأساسيات

المتغير الافتراضي ما يفعله
DATABASE_URL file:./maarifa.db قاعدة البيانات: ملف SQLite بجانب المخطط، أو رابط PostgreSQL (المتطلبات).
SITE_URL http://localhost:3305 العنوان العام دون شرطة مائلة في آخره. تستخدمه روابط العودة من الدفع وروابط التحقق من الشهادات وخريطة الموقع والروابط الأساسية. يجب أن يبدأ بـ https:// في الإنتاج.
AUTH_SECRET لا يوجد يوقّع ملفات جلسات اللوحة والمتعلّمين. 32 حرفًا عشوائيًا فأكثر. تغييره يُخرج الجميع.
ACADEMY_TIMEZONE Asia/Muscat المنطقة الزمنية لحساب «هذا الشهر» في اللوحة ولعرض أوقات الجلسات المباشرة.

الحسابات الأولى والبيانات التجريبية

المتغير الافتراضي ما يفعله
ADMIN_EMAIL وADMIN_PASSWORD admin@maarifa.test ينشئان أول مشرف حين لا يوجد أي حساب في اللوحة.
DEMO_INSTRUCTOR_PASSWORD maarifa-teach-2026 ينشئ أمر التعبئة حساب مدرّب لكل مدرّب تجريبي بكلمة المرور هذه. فارغ = ملفات دون حسابات.
SEED_DEMO_STUDENT 0 القيمة 1 تنشئ متعلّمًا تجريبيًا بتسجيلات وتقدّم وشهادة وطلبات ومحادثة.
DEMO_STUDENT_EMAIL وDEMO_STUDENT_PASSWORD student@maarifa.test بيانات دخول المتعلّم التجريبي.
DEMO_HINT 0 القيمة 1 تعرض بيانات الدخول التجريبية في صفحات الدخول. للعروض العامة فقط.

الدفع

المتغير الافتراضي ما يفعله
THAWANI_MODE uat uat لبيئة الاختبار في «ثواني»، وlive للدفع الحقيقي.
THAWANI_SECRET_KEY وTHAWANI_PUBLISHABLE_KEY فارغ مفاتيح «ثواني». لا يظهر الدفع بالبطاقة إلا حين يُضبطان معًا، ويكون المفتاح مفعّلًا في الإعدادات، والعملة الريال العُماني. راجع الدفع.

الذكاء الاصطناعي (اختياري)

المتغير الافتراضي ما يفعله
AI_BASE_URL فارغ أي واجهة متوافقة مع OpenAI، مثل https://api.openai.com/v1 أو Ollama محلي http://localhost:11434/v1. تركه فارغًا يوقف مزايا الذكاء الاصطناعي.
AI_API_KEY فارغ يُرسل في Authorization: Bearer ... إن وُجد.
AI_MODEL gpt-4o-mini اسم النموذج كما يطلبه مزوّدك.

راجع المساعد الذكي.

بعد تعديل ‎.env

أعد تشغيل الخادم (pm2 restart maarifa، أو أوقف npm run dev وشغّله). تُقرأ المتغيرات عند بدء الخادم.