Rivya troubleshooting گائیڈ

یہ troubleshooting guide اس وقت استعمال کریں جب Rivya chat، uploads، generation tasks، history، notifications، credits، یا billing state expected طریقے سے behave نہ کرے۔

جب Rivya broken محسوس ہو، تو fastest fix یہ decide کرنا ہے کہ actual failing layer کون سی ہے۔

زیادہ تر issues پانچ جگہوں میں سے ایک میں land کرتے ہیں:

• access اور sign-in
• model یا input mismatch
• async task state
• wallet یا payment state
• saved work lookup

یہ split ہر چیز کو generic “bug” سمجھنے سے کہیں زیادہ useful ہے۔

1. Chat send نہیں ہو رہی

اگر chat actually run نہیں ہو رہی، تو پہلے simple causes check کریں:

• آپ ابھی public landing flow پر ہو سکتے ہیں اور sending سے پہلے sign in چاہیے
• draft message empty ہو سکتا ہے
• saved session cleanly load ہونے میں fail ہو سکتی ہے

اگر problem session-specific ہے، تو یہ guess کرنے کے بجائے کہ آپ کس path پر تھے، conversation کو History سے reopen کریں۔

اگر task narrow اور repetitive ہے، تو broad plain-chat thread میں continue کرنے کے بجائے tool entry سے restart کرنا بھی cleaner ہو سکتا ہے۔

2. Generation start نہیں ہو رہی

اگر image، video، یا audio generation واقعی شروع ہونے سے پہلے fail ہو، تو usual causes یہ ہیں:

• required prompt content missing ہے
• dialogue-style audio form incomplete ہے
• selected model reference file require کرتا ہے اور کوئی file provided نہیں
• account کے پاس enough credits نہیں

ابھی insufficient credits upstream service call ہونے سے پہلے run fail کر سکتے ہیں۔ اسی لیے “nothing happened” جیسا احساس پھر بھی real failed record اور notification چھوڑ سکتا ہے۔

3. Uploads fail ہوتے ہیں

Uploads model-driven ہیں، category-driven نہیں۔

اس کا مطلب ہے:

• ہر model same category میں same reference kinds accept نہیں کرتا
• ہر model same number of files accept نہیں کرتا
• size اور type limits real generation request سے پہلے enforce ہوتے ہیں

اگر upload fail ہو، تو check کریں:

• model اس file kind کو بالکل support کرتا ہے یا نہیں
• آپ current reference-file limit پہلے ہی hit کر چکے ہیں یا نہیں
• file type یا size current upload rules violate کرتا ہے یا نہیں

اگر workflow audio cleanup یا isolation ہے، تو یاد رکھیں کہ uploaded-audio paths prompt-first TTS یا voice generation سے structurally different ہیں۔

4. Task in progress stuck ہے

Image، video، اور audio runs Rivya میں async tasks ہیں۔

Visible states یہ ہیں:

• WAITING
• GENERATING
• SUCCESS
• FAILED

اگر task stuck لگے تو صرف current page نہ دیکھیں۔

یہ surfaces بھی check کریں:

• active Studio
• History
• Notifications Center
• /dashboard recent generations

کچھ tasks callback سے finish ہوتے ہیں، کچھ polling یا refresh سے۔ لہذا “still generating” خود بخود “lost” نہیں ہوتا۔ اکثر اس کا مطلب ہے کہ task ابھی final upstream result settle ہونے کا wait کر رہا ہے۔

5. Task failed ہو گیا

Rivya میں failure عموماً preserve ہوتا ہے، hidden نہیں۔

Failed task یہ رکھ سکتا ہے:

• failed status itself
• error message
• refund state، جب reserved credits reverse ہونے چاہئیں
• generation-failed notification

اس کا مطلب ہے کہ right next step عموماً یہ ہے:

1. failure state پڑھیں
2. decide کریں کہ problem credits، prompt، یا input mismatch تھی
3. اسی specific cause کو fix کرنے کے بعد ہی rerun کریں

ہر failure کو transient UI issue نہ سمجھیں۔

6. Result gone لگتا ہے

عموماً result gone نہیں ہوتا۔ یہ صرف wrong surface پر ہوتا ہے۔

History استعمال کریں جب question ہو:

Notifications Center استعمال کریں جب question ہو:

Broad rule یہ ہے:

• chat، chat history میں return ہوتی ہے
• image، video، اور audio، generation history میں return ہوتے ہیں
• billing اور credit events اکثر notifications میں سب سے clearly دکھتے ہیں

7. Payment state old لگتی ہے

اگر checkout finish ہو گیا مگر wallet یا billing state ابھی stale لگے، تو payment lost assume کرنے سے پہلے billing path follow کریں۔

Current product flow یہ ہے:

1. checkout complete کریں
2. /payment کے ذریعے return کریں
3. product کو billing یا wallet state poll اور refresh کرنے دیں
4. /settings/billing یا /settings/credits check کریں

Notifications billing outcomes بھی preserve کر سکتی ہیں، اس لیے account state out of sync لگے تو انہیں check کرنا worth ہے۔

8. پہلے کہاں check کریں

یہ shortcut استعمال کریں:

• current Studio: live work in progress
• History: saved outputs اور saved conversations
• Notifications Center: operational events جو already happen ہو چکے ہیں
• /settings/billing: subscription state
• /settings/credits: wallet balance، packs، expiry، اور transactions

زیادہ تر confusion wrong layer پہلے check کرنے سے آتی ہے۔

آگے پڑھیں

• Rivya میں task lifecycle
• Rivya میں image workflows
• Rivya میں video workflows
• Rivya میں audio workflows
• Rivya میں references اور uploads
• Rivya میں credits اور billing
• Rivya میں payment checkout

Troubleshooting triage checklist

Same action repeat کرنے سے پہلے first place choose کریں:

• Chat send نہیں ہو رہی: sign-in، session state، model availability، اور credit behavior check کریں۔
• Uploads fail ہوتے ہیں: file type، size، model support، اور task کو واقعی file چاہیے یا نہیں check کریں۔
• Generation stuck ہے: task status، provider callbacks، polling، history، اور notifications check کریں۔
• Billing stale لگتی ہے: Checkout return، webhook settlement، billing settings، اور credits settings check کریں۔
• Results missing لگتے ہیں: correct history kind اور task واقعی completed ہوا یا نہیں check کریں۔

Escalate کرنے سے پہلے recheck کریں

صرف اس وقت escalate کریں جب آپ account area، task id یا payment context، expected result، actual result، اور last visible state کا نام لے سکیں۔ یہ support کو guesswork کے بجائے diagnosis بناتا ہے۔