17. ट्रबलशूटिंग — असली बग

FAQ से न मिले तो यहां। आम टूट + फ़िक्स।

पहले: ऐप force-close + फिर खोलें। ~30% "बग" flaky internet की बासी UI। फिर भी टूटा हो तो आगे पढ़ें।

Login + auth

पहली login पर "Invalid phone number"

कारण:

• Typo (extra space, country code)
• अकाउंट बना ही नहीं (sign-up में ग़लत नंबर)
• नंबर दूसरी भूमिका का (driver पर owner login)

फ़िक्स:

1. जगह / +91 बिना फिर।
2. +91 के साथ फिर।
3. फिर भी नहीं तो admin।

3 ग़लत PIN → 5 मिनट लॉक

अपेक्षित। प्रतीक्षा:

• 3 ग़लत: 5 मि
• 6 ग़लत: 30 मि
• 9 ग़लत: 24 घंटे

भूल गए:

• Lock स्क्रीन → Forgot PIN → admin / मालिक SMS से रीसेट।

Login के बाद फिर phone-entry

पुराना बग। ठीक: ग़लत PIN अब logout नहीं। फिर भी देखे तो force-close + reinstall।

बीच दिन logout

कारण:

• Session expired (30+ दिन inactive)
• Phone OS ने memory के लिए app kill
• कहीं और login उसी नंबर से (एक active session)

फ़िक्स: फिर login। डेटा सुरक्षित।

Data नहीं दिखे

नया ग्राहक ग़ायब

जांचें:

1. Save हुआ? "Saved" toast?
2. Filter — Active only? Inactive saved?
3. Plan limit — silently fail? My Plan।
4. Refresh।

ड्राइवर login → checklist खाली

कारण:

• Route assignment नहीं
• आज की शिफ्ट / दिन assignment में नहीं
• Subscription is_active = false
• start_date भविष्य में

फ़िक्स: ड्राइवर प्रोफ़ाइल → Route Assignments। 12-drivers.md।

आज की डिलीवरी auto-generate नहीं

रात्रि generate। सुबह खाली:

1. Deliveries → Generate।
2. Subscriptions active + frequency में आज?
3. start_date भविष्य का नहीं?
4. अंतिम: support।

बिल ₹0 / generate नहीं

कारण:

• डिलीवरी मार्क नहीं
• सब skipped
• Bill cycle अभी नहीं (1 तारीख auto)

फ़िक्स: Billing → manually। फिर भी ₹0 तो ग्राहक खाता।

Payment + billing

पेमेंट दिया पर बिल unpaid

Force-refresh:

1. Billing list pull-down।
2. फिर भी — drawer में Payments?
3. नहीं — save fail। फिर record।
4. हां पर status ग़लत — 5s प्रतीक्षा + refresh।

UPI पेमेंट पर रसीद नहीं

क्रम:

1. Owner toggle "Payment received" ON।
2. ग्राहक whatsapp_notify ON।
3. कोटा।
4. WhatsApp नंबर मान्य।

सब OK पर रसीद नहीं — support को bill # + payment ID।

बिल रकम ग़लत

कारण:

• Partial डिलीवरी
• महीने का भाग subscription paused
• Custom price
• Payment ग़लत बिल पर

बिल PDF दिन-वार सब डिलीवरी।

WhatsApp

"Template doesn't exist"

Meta में template approved नहीं। Support।

आज WhatsApp बंद

संदेह:

1. कोटा — usage कार्ड।
2. Owner toggle बंद।
3. ग्राहक opt-out।
4. ग़लत नंबर — Meta पर silently fail।

ग्राहक "पुराना संदेश फिर"

WhatsApp / network retry। असली duplicate तो Send All history।

काउंटर

Sale के बाद count अपडेट नहीं

पुराना बग — silent refresh से ठीक। फिर भी तो force-close।

Counter sale edit नहीं

पहले paid / partial पर block था। अब हटाया। फिर भी "This sale has a payment recorded" तो refresh / update।

"Send WhatsApp update" टॉगल counter पर नहीं

Owner toggle "Counter / pickup update" ON ज़रूरी।

ड्राइवर

ड्राइवर फ़ोन पर ग़लत डेयरी

Stale session:

1. Sign out।
2. फिर login।
3. फिर भी ग़लत तो owner_id।

Partial / qty edit नहीं

1. Driver record → "Can edit quantity" ON।
2. Plan tier।

Mobile swipe delivered पर WhatsApp नहीं

पुराना बग — keepalive: true से ठीक। फिर भी तो force-close।

App / device

Splash / loading पर अटका

1. Force-close।
2. फिर खोलें।
3. Internet जांचें।
4. Reinstall।
5. Support।

Reports पर crash

बहुत data:

• Slow फ़ोन + बड़ी range
• Historical plan-gated

फ़िक्स: "This month" पहले — फिर बड़ी range।

"Network error" toasts

Internet patchy:

• Mobile data ↔ Wi-Fi
• अच्छा signal
• डिलीवरी मार्क; queue + sync।

Plan / billing

Upgrade पर भी trial / expired

30 मिनट प्रतीक्षा। फिर WhatsApp से screenshot।

Plan expired पर पैसे दिए

संभावना:

• Payment न पहुंचा
• Admin अभी प्रोसेस नहीं
• पुराने end-date से extend।

Admin को: ref, रकम, तारीख।

"Plan limit reached" पर count कम

Refresh। फिर भी तो plan record sync नहीं — admin।

अब भी अटके?

रिपोर्ट करते वक़्त:

• क्या किया, क्या अपेक्षा, क्या हुआ।
• Screenshot।
• व्यवसाय नाम + फ़ोन।

Email — 1 बिज़नेस दिन; WhatsApp / Phone तेज़।

संबंधित

• 16-faq.md — सामान्य प्रश्न
• 14-settings.md — profile, भाषा, थीम
• 15-plans-billing.md — plan + upgrade