التوثيق / الإعداد والتشغيل
النشر
شغّل رد على جهازك أو خادمك وجهّزه للإنتاج.
#البنية
| الجزء | ما هو |
|---|---|
| API | خدمة NestJS على المنفذ 3001: منطق العمل والعمال الخلفيون وWebhook واتساب والواجهة العامة. |
| Web | تطبيق Next.js على المنفذ 3000: لوحة التحكم والموقع العام والتوثيق ووسيط لنفس الأصل إلى الـ API. |
| Database | PostgreSQL مضمّن (PGlite مع بحث متجهي). البيانات في DATA_DIR. يعزل أمان مستوى الصف كل نشاط. |
#التشغيل محلياً
تحتاج Node.js 22. من مجلد المشروع شغّل:
node start-local.mjsيُنشئ التشغيل الأول apps/api/.env بأسرار عشوائية جديدة ويثبّت الاعتماديات ويبني التطبيقين ويشغّلهما. لوحة التحكم على http://localhost:3000 والـ API على http://127.0.0.1:3001. ويعيد بناء تطبيق الويب كلما كانت مصادره أحدث من آخر بناء.
#قائمة الإنتاج
- قدّم تطبيق الويب والـ API خلف HTTPS (وسيط عكسي مثل Nginx أو Caddy). المطلوب عاماً هو تطبيق الويب إضافة إلى مسارات الـ API التالية:
/v1/whatsapp/webhookو/v1/r/*و/v1/public/*و/v1/api/*. - اضبط
NODE_ENV=production. يرفض الخادم حينها إعدادات التطوير غير الآمنة (التضمين المحلي ووضع الذكاء الاصطناعي الاستخراجي والبريد السجلي والدفع التجريبي والزحف على العناوين الخاصة). - اختر مزوّدين حقيقيين:
LLM_PROVIDER(anthropicأوopenai) مع مفتاحه وEMBEDDING_PROVIDER=openai. - اضبط البريد (
MAIL_PROVIDER=smtp) لتصل إعادة تعيين كلمات المرور والدعوات. راجع الإعدادات. - اضبط
APP_URL(للـ API) وSITE_URL(للويب) على نطاقك العام وAPI_URL(للويب) على عنوان الـ API الذي يصل إليه خادم الويب. - ضع بريدك الحقيقي في
PLATFORM_ADMIN_EMAILS. - أكمل إعداد Meta (إعداد Meta).
- انسخ `DATA_DIR` احتياطياً بجدول واختبر الاستعادة. لا يوجد نسخ احتياطي تلقائي.
- راجع نص سياسة الخصوصية بخصوص الكوكيز والبريد وتتبع التسجيل.
شغّل الاختبارات بـ cd apps/api && npm test.