نصيحة
قبل أي شيء: افحص
/automation/queues و tail -f /tmp/operix-backend.log. 90% من المشاكل تشخّص في 30 ثانية.التطبيق
| العَرَض | السبب | الحل |
|---|---|---|
| الصفحة بيضاء أو 502 | PM2 متوقّف على VPS | ssh root@... "pm2 restart operix-v3" |
| أي صفحة تُحوّلني لـ /login | الـ token منتهي أو محذوف | سجّل دخول من جديد. الـ JWT صلاحيته 24 ساعة. |
| الـ API يرجع 401 | نفس السبب | نفس الحل |
| الـ API يرجع 502 | Backend محلي متوقّف أو الـ tunnel مكسور | أعد تشغيل Backend على Mac + تأكّد الـ SSH tunnel شغّال |
الوكلاء
| العَرَض | السبب | الحل |
|---|---|---|
| راشد لا يردّ | Ollama متوقف أو النموذج غير محمّل | ollama list + تأكّد qwen2.5:32b موجود |
| الرد طويل جداً (دقائق) | النموذج كبير + الجهاز ما يكفي | جرّب نموذج أصغر (qwen2.5:14b أو qwen2.5:7b) |
| الردود سيّئة الجودة | System prompt ضعيف أو السياق فقير | راجع كيف تتحدث |
الأتمتة
| العَرَض | السبب | الحل |
|---|---|---|
| الـ workflow لا يُشغَّل تلقائياً | isActive = false أو الـ trigger غير صحيح | افحص في صفحة التفاصيل + جرّب “🧪 اختبار” |
| الـ run يفشل دائماً بنفس الخطأ | config غير صحيح أو متغيّر مفقود | افتح الـ run → اقرأ logs → عدّل الـ workflow → احفظ |
| WhatsApp keyword workflow لا يفعّل | الـ trigger keyword domain خطأ (WHATSAPP مطلوب) | في الـ inspector، حدّد domain=WHATSAPP صراحة |
| condition دائماً يأخذ false branch | field path خطأ أو القيمة تنوع غير متوقّع | أضف log قبل الـ condition لطباعة القيم — ثم صحّح |
واتساب
مشاكل واتساب موسّعة في صفحة مخصصة.