دليل استكشاف المشكلات في Rivya

استخدم دليل استكشاف المشكلات هذا عندما لا تتصرف دردشة Rivya أو عمليات الرفع أو مهام التوليد أو السجل أو الإشعارات أو الأرصدة أو حالة الفوترة كما هو متوقع.

عندما تبدو Rivya معطلة، فإن أسرع إصلاح هو تحديد أي طبقة تفشل فعلا.

تقع أغلب المشكلات في واحد من خمسة أماكن:

• الوصول وتسجيل الدخول
• عدم تطابق النموذج أو الإدخال
• حالة المهمة غير المتزامنة
• حالة المحفظة أو الدفع
• البحث عن العمل المحفوظ

هذا التقسيم أكثر فائدة بكثير من التعامل مع كل شيء كأنه "خطأ" عام.

1. الدردشة لا ترسل

إذا لم تعمل الدردشة فعلا، فافحص الأسباب البسيطة أولا:

• قد تكون ما زلت في تدفق هبوط عام وتحتاج إلى تسجيل الدخول قبل الإرسال
• قد تكون رسالة المسودة فارغة
• قد تكون الجلسة المحفوظة فشلت في التحميل بشكل نظيف

إذا كانت المشكلة خاصة بالجلسة، فأعد فتح المحادثة من History بدلا من تخمين المسار الذي كنت عليه.

إذا كانت المهمة ضيقة ومتكررة، فقد يكون أنظف أن تعيد البدء من مدخل الأداة بدلا من الاستمرار في سلسلة دردشة عامة واسعة.

2. التوليد لا يبدأ

إذا فشل توليد الصورة أو الفيديو أو الصوت قبل أن يبدأ فعلا، فالأسباب المعتادة هي:

• محتوى المطالبة المطلوب مفقود
• استمارة صوت بأسلوب الحوار غير مكتملة
• النموذج المحدد يتطلب ملفا مرجعيا ولم يقدم أي ملف
• الحساب لا يملك أرصدة كافية

حاليا، يمكن أن يؤدي نقص الأرصدة إلى فشل التشغيل قبل أن تستدعى الخدمة الأعلى أصلا. لهذا يمكن أن تشعر بأن "لا شيء حدث" ومع ذلك يبقى سجل فشل حقيقي وإشعار.

3. عمليات الرفع تفشل

عمليات الرفع تقودها مواصفات النموذج، لا الفئة.

هذا يعني:

• لا يقبل كل نموذج في فئة واحدة أنواع المراجع نفسها
• لا يقبل كل نموذج عدد الملفات نفسه
• تفرض حدود الحجم والنوع قبل طلب التوليد الحقيقي

إذا فشل الرفع، افحص:

• هل يدعم النموذج هذا النوع من الملفات أصلا
• هل وصلت بالفعل إلى الحد الحالي للملفات المرجعية
• هل نوع الملف أو حجمه يخالف قواعد الرفع الحالية

إذا كان سير العمل هو تنظيف الصوت أو عزله، فتذكر أن مسارات الصوت المرفوع مختلفة بنيويا عن تحويل النص إلى كلام أو توليد الصوت الذي يبدأ بالمطالبة.

4. المهمة عالقة قيد التقدم

تشغيلات الصورة والفيديو والصوت هي مهام غير متزامنة في Rivya.

الحالات المرئية هي:

• WAITING
• GENERATING
• SUCCESS
• FAILED

إذا بدت مهمة عالقة، فلا تراقب الصفحة الحالية فقط.

افحص هذه الأسطح أيضا:

• Studio النشط
• History
• Notifications Center
• التوليدات الأخيرة في /dashboard

تنتهي بعض المهام عبر callback، وبعضها عبر الاستطلاع أو التحديث. لذلك "ما زالت تولد" لا يعني وحده "ضائعة". غالبا يعني أن المهمة ما زالت تنتظر استقرار النتيجة النهائية من الخدمة الأعلى.

5. المهمة فشلت

عادة يحفظ الفشل في Rivya ولا يخفى.

يمكن أن تحتفظ المهمة الفاشلة بـ:

• حالة الفشل نفسها
• رسالة الخطأ
• حالة رد الرصيد عندما يجب عكس الأرصدة المحجوزة
• إشعار فشل التوليد للمراجعة الدائمة

لذلك تكون الخطوة التالية الصحيحة عادة:

1. اقرأ failure state
2. حدد هل كانت المشكلة أرصدة أو مطالبة أو عدم تطابق إدخال
3. أعد التشغيل فقط بعد إصلاح ذلك السبب المحدد

لا تعامل كل فشل كأنه مشكلة واجهة عابرة.

6. Result يبدو مفقودا

عادة لا تكون النتيجة مفقودة. إنها فقط على السطح الخطأ.

استخدم History عندما يكون السؤال:

واستخدم Notifications Center عندما يكون السؤال:

القاعدة العامة هي:

• الدردشة تعود إلى سجل الدردشة
• الصورة والفيديو والصوت تعود إلى سجل التوليد
• أحداث الفوترة والرصيد تظهر غالبا بشكل أوضح في الإشعارات

7. حالة الدفع تبدو قديمة

إذا اكتمل checkout لكن المحفظة أو حالة الفوترة ما زالت تبدو قديمة، فاتبع مسار الفوترة قبل افتراض أن الدفع ضاع.

تدفق المنتج الحالي هو:

1. أكمل checkout
2. ارجع عبر /payment
3. اترك المنتج يجري الاستطلاع ويحدث حالة الفوترة أو المحفظة
4. افحص /settings/billing أو /settings/credits

يمكن أن تحفظ Notifications أيضا نتائج الفوترة، لذلك تستحق الفحص عندما تبدو حالة الحساب غير متزامنة.

8. أين تفحص أولا

استخدم هذا الاختصار:

• Studio الحالي: عمل مباشر قيد التقدم
• History: مخرجات محفوظة ومحادثات محفوظة
• Notifications Center: أحداث تشغيلية حدثت بالفعل
• /settings/billing: حالة الاشتراك
• /settings/credits: رصيد المحفظة والحزم والانتهاء والمعاملات

ينتج أغلب الالتباس من فحص الطبقة الخطأ أولا.

اقرأ بعد ذلك

• Task Lifecycle in Rivya
• Image Workflows in Rivya
• Video Workflows in Rivya
• Audio Workflows in Rivya
• References and Uploads in Rivya
• Credits & Billing in Rivya
• Payment Checkout in Rivya

قائمة فحص فرز المشكلات

اختر أول مكان تفحصه قبل تكرار الإجراء نفسه:

• الدردشة لا ترسل: افحص تسجيل الدخول وحالة الجلسة وتوفر النموذج وسلوك الرصيد.
• عمليات الرفع تفشل: افحص نوع الملف وحجمه ودعم النموذج وهل تحتاج المهمة فعلا إلى ملف.
• التوليد عالق: افحص حالة المهمة وcallbacks المزود والاستطلاع والسجل والإشعارات.
• الفوترة تبدو قديمة: افحص العودة من Checkout وتسوية webhook وإعدادات الفوترة وإعدادات الأرصدة.
• النتائج تبدو مفقودة: افحص نوع السجل الصحيح وهل اكتملت المهمة فعلا.

أعد الفحص قبل التصعيد

صعد فقط بعد أن تستطيع تسمية منطقة الحساب أو معرف المهمة أو سياق الدفع والنتيجة المتوقعة والنتيجة الفعلية وآخر حالة مرئية. هذا يحول الدعم إلى تشخيص بدلا من التخمين.