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

النشر

شغّل رد على جهازك أو خادمك وجهّزه للإنتاج.

#البنية

الجزءما هو
APIخدمة NestJS على المنفذ 3001: منطق العمل والعمال الخلفيون وWebhook واتساب والواجهة العامة.
Webتطبيق Next.js على المنفذ 3000: لوحة التحكم والموقع العام والتوثيق ووسيط لنفس الأصل إلى الـ API.
DatabasePostgreSQL مضمّن (PGlite مع بحث متجهي). البيانات في DATA_DIR. يعزل أمان مستوى الصف كل نشاط.

#التشغيل محلياً

تحتاج Node.js 22. من مجلد المشروع شغّل:

Terminal
node start-local.mjs

يُنشئ التشغيل الأول apps/api/.env بأسرار عشوائية جديدة ويثبّت الاعتماديات ويبني التطبيقين ويشغّلهما. لوحة التحكم على http://localhost:3000 والـ API على http://127.0.0.1:3001. ويعيد بناء تطبيق الويب كلما كانت مصادره أحدث من آخر بناء.

#قائمة الإنتاج

  1. قدّم تطبيق الويب والـ API خلف HTTPS (وسيط عكسي مثل Nginx أو Caddy). المطلوب عاماً هو تطبيق الويب إضافة إلى مسارات الـ API التالية: /v1/whatsapp/webhook و/v1/r/* و/v1/public/* و/v1/api/*.
  2. اضبط NODE_ENV=production. يرفض الخادم حينها إعدادات التطوير غير الآمنة (التضمين المحلي ووضع الذكاء الاصطناعي الاستخراجي والبريد السجلي والدفع التجريبي والزحف على العناوين الخاصة).
  3. اختر مزوّدين حقيقيين: LLM_PROVIDER (anthropic أو openai) مع مفتاحه وEMBEDDING_PROVIDER=openai.
  4. اضبط البريد (MAIL_PROVIDER=smtp) لتصل إعادة تعيين كلمات المرور والدعوات. راجع الإعدادات.
  5. اضبط APP_URL (للـ API) وSITE_URL (للويب) على نطاقك العام وAPI_URL (للويب) على عنوان الـ API الذي يصل إليه خادم الويب.
  6. ضع بريدك الحقيقي في PLATFORM_ADMIN_EMAILS.
  7. أكمل إعداد Meta (إعداد Meta).
  8. انسخ `DATA_DIR` احتياطياً بجدول واختبر الاستعادة. لا يوجد نسخ احتياطي تلقائي.
  9. راجع نص سياسة الخصوصية بخصوص الكوكيز والبريد وتتبع التسجيل.

شغّل الاختبارات بـ cd apps/api && npm test.

النشر · توثيق رد