مرجع متغيرات البيئة وإعدادات الخادم
مرجع شامل لمتغيرات البيئة الخاصة بخادم مدار الأساسي ولوحة التحكم المعزولة.
متغيرات الخادم الأساسي ومستوى التحكم
تُضبط متغيرات البيئة التالية في ملف .env أو في بيئة تشغيل الحاويات قبل بدء الخدمات:
| المتغير | القيمة الافتراضية | الوصف |
|---|---|---|
| DEPLOYMENT_PROFILE | workspace / personal | يحدد نمط التشغيل؛ القيمة workspace تعزل وتغلق كافة مسارات الميزات الشخصية |
| DATABASE_URL | postgresql://... | رابط الاتصال بقاعدة بيانات PostgreSQL 18 |
| REDIS_URL | redis://localhost:6379 | رابط الاتصال بـ Redis للإشعارات اللحظية وحصص الطلبات |
| MASTER_ENCRYPTION_KEY | (إلزامي في الإنتاج) | مفتاح 256-بت (64 محرفاً سداسياً) لتشفير الحقول بمعيار AES-256-GCM |
| JWT_SECRET | (إلزامي في الإنتاج) | مفتاح سري عالي العشوائية لتوقيع رموز الجلسات |
| ADMIN_API_ENABLED | true | يُضبط على false في العقد الطرفية لإخفاء مسارات /api/v1/admin/* |
| ADMIN_PLANE_SECRET | (موصى به) | مفتاح مشترك يتحقق منه الخادم عبر الترويسة X-Madar-Control-Plane-Key |
| TENANT_TOKEN | (اختياري) | رمز اشتراك المؤسسة في خدمة مرحّل الإشعارات والرسائل النصية الصامت |