متغيرات البيئة
كل إعداد في ملف .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 وشغّله). تُقرأ المتغيرات عند بدء الخادم.