التوثيق / الإعداد والتشغيل
مرجع الإعدادات
كل متغير بيئة وما يفعله وقيمته الافتراضية.
#الـ API (`apps/api/.env`)
| المتغير | الافتراضي | الغرض |
|---|---|---|
PORT | 3001 | منفذ الـ API. |
DATA_DIR | ./data/pgdata | مكان تخزين قاعدة البيانات المضمّنة. انسخه احتياطياً. |
JWT_SECRET | required | يوقّع الجلسات. 32 حرفاً على الأقل. |
ENCRYPTION_KEY | required | 64 حرفاً سداسي عشري. يشفّر الأسرار المخزنة (رموز واتساب وبيانات المتاجر وأسرار MFA). |
WHATSAPP_APP_SECRET, WHATSAPP_VERIFY_TOKEN | required | للتحقق من webhooks تطبيق Meta الذي تربطه يدوياً. |
WHATSAPP_GRAPH_VERSION | v21.0 | إصدار Graph API من Meta. |
LLM_PROVIDER | extractive | anthropic أو openai أو extractive (للتطوير فقط: يقتبس المعرفة ولا يولّد). |
ANTHROPIC_API_KEY, OPENAI_API_KEY, LLM_MODEL | — | بيانات الاعتماد وتجاوز اختياري للنموذج. |
EMBEDDING_PROVIDER | local | openai لجودة البحث في الإنتاج. local للتطوير فقط. |
WORKER_ENABLED | true | يشغّل العمال الخلفيين: معالجة الرسائل والحملات والسلاسل والتذكيرات وwebhooks والزحف. إن كان false لا يُعالج شيء. |
APP_URL | http://localhost:3000 | رابط لوحة التحكم العام، يُستخدم في الروابط المرسلة بالبريد. |
PLATFORM_ADMIN_EMAILS | empty | بريد مفصول بفواصل يُسمح له بدخول لوحة المالك. |
MAIL_PROVIDER | log | smtp للتسليم الفعلي (مطلوب في الإنتاج). log يطبع الرسائل في سجل الخادم. |
MAIL_FROM, SMTP_HOST, SMTP_PORT, SMTP_SECURE, SMTP_USER, SMTP_PASS | — | إعدادات SMTP (Amazon SES أو Mailgun أو Google Workspace أو خادمك). |
PAYMENT_PROVIDER | manual | manual: تحويل بنكي يؤكده مالك المنصة. test للتطوير فقط. |
VAT_RATE_BPS | 1500 | الضريبة بالنقاط الأساسية (1500 = 15%). |
SELLER_NAME, SELLER_VAT_NUMBER, SELLER_ADDRESS | — | تُطبع على الفواتير. |
PAST_DUE_GRACE_DAYS | 7 | عدد الأيام التي يستمر فيها الاشتراك المتأخر بالعمل. |
CRAWLER_ALLOW_PRIVATE, CRAWL_DELAY_MS | false, 300 | زاحف المواقع. لا تسمح بالعناوين الخاصة في الإنتاج (SSRF). |
#الويب (`apps/web`)
| المتغير | الغرض |
|---|---|
API_URL | العنوان الذي يستخدمه خادم الويب للوصول إلى الـ API (الافتراضي http://127.0.0.1:3001). |
SITE_URL | عنوان الموقع العام لخريطة الموقع والروابط القانونية والبيانات المنظَّمة. |