التوثيق / الإعداد والتشغيل

مرجع الإعدادات

كل متغير بيئة وما يفعله وقيمته الافتراضية.

#الـ API (`apps/api/.env`)

المتغيرالافتراضيالغرض
PORT3001منفذ الـ API.
DATA_DIR./data/pgdataمكان تخزين قاعدة البيانات المضمّنة. انسخه احتياطياً.
JWT_SECRETrequiredيوقّع الجلسات. 32 حرفاً على الأقل.
ENCRYPTION_KEYrequired64 حرفاً سداسي عشري. يشفّر الأسرار المخزنة (رموز واتساب وبيانات المتاجر وأسرار MFA).
WHATSAPP_APP_SECRET, WHATSAPP_VERIFY_TOKENrequiredللتحقق من webhooks تطبيق Meta الذي تربطه يدوياً.
WHATSAPP_GRAPH_VERSIONv21.0إصدار Graph API من Meta.
LLM_PROVIDERextractiveanthropic أو openai أو extractive (للتطوير فقط: يقتبس المعرفة ولا يولّد).
ANTHROPIC_API_KEY, OPENAI_API_KEY, LLM_MODEL—بيانات الاعتماد وتجاوز اختياري للنموذج.
EMBEDDING_PROVIDERlocalopenai لجودة البحث في الإنتاج. local للتطوير فقط.
WORKER_ENABLEDtrueيشغّل العمال الخلفيين: معالجة الرسائل والحملات والسلاسل والتذكيرات وwebhooks والزحف. إن كان false لا يُعالج شيء.
APP_URLhttp://localhost:3000رابط لوحة التحكم العام، يُستخدم في الروابط المرسلة بالبريد.
PLATFORM_ADMIN_EMAILSemptyبريد مفصول بفواصل يُسمح له بدخول لوحة المالك.
MAIL_PROVIDERlogsmtp للتسليم الفعلي (مطلوب في الإنتاج). log يطبع الرسائل في سجل الخادم.
MAIL_FROM, SMTP_HOST, SMTP_PORT, SMTP_SECURE, SMTP_USER, SMTP_PASS—إعدادات SMTP (Amazon SES أو Mailgun أو Google Workspace أو خادمك).
PAYMENT_PROVIDERmanualmanual: تحويل بنكي يؤكده مالك المنصة. test للتطوير فقط.
VAT_RATE_BPS1500الضريبة بالنقاط الأساسية (1500 = 15%).
SELLER_NAME, SELLER_VAT_NUMBER, SELLER_ADDRESS—تُطبع على الفواتير.
PAST_DUE_GRACE_DAYS7عدد الأيام التي يستمر فيها الاشتراك المتأخر بالعمل.
CRAWLER_ALLOW_PRIVATE, CRAWL_DELAY_MSfalse, 300زاحف المواقع. لا تسمح بالعناوين الخاصة في الإنتاج (SSRF).

#الويب (`apps/web`)

المتغيرالغرض
API_URLالعنوان الذي يستخدمه خادم الويب للوصول إلى الـ API (الافتراضي http://127.0.0.1:3001).
SITE_URLعنوان الموقع العام لخريطة الموقع والروابط القانونية والبيانات المنظَّمة.
مرجع الإعدادات · توثيق رد