17. ટ્રબલશૂટિંગ — ખરેખર બગ હોય ત્યારે

FAQ થી ન મળે તે અહીં. સામાન્ય તૂટન + ફિક્સ.

સૌ પહેલા: એપ force-close + ફરી ખોલો. લગભગ 30% "બગ" એટલે flaky internet ની વાસી UI. હજી પણ તૂટેલ તો વાંચતા જાઓ.

Login + auth

પ્રથમ login પર "Invalid phone number"

કારણ:

• Typo (extra space, country code)
• એકાઉન્ટ બન્યું જ નથી (sign-up માં ખોટો નંબર)
• નંબર બીજી ભૂમિકાનો (ડ્રાઇવર પણ 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 નહીં — error અને ફરી પ્રયત્ન. હજી દેખાય તો force-close + reinstall.

દિવસ વચ્ચે અચાનક logout

કારણ:

• Session expired (30+ દિવસ inactive — દુર્લભ)
• Phone OS એ memory માટે app kill કર્યું
• બીજે login કર્યું એ જ ફોન-નંબરથી (એક active session)

ફિક્સ: ફરી login. Data સુરક્ષિત.

Data ન દેખાય

નવો ગ્રાહક ગાયબ

ચેક:

1. Save થયું? "Saved" toast?
2. List ફિલ્ટર — Active only? Inactive તરીકે saved?
3. Plan limit — silently fail? My Plan ચેક.
4. Refresh (નીચે ખેંચો).

ડ્રાઇવર login → checklist ખાલી

કારણ:

• Route assignment નથી
• આજની શિફ્ટ assignment માં નથી
• આજનો દિવસ assignment માં નથી (દા.ત., Mon–Fri પણ આજે રવિવાર)
• Subscription is_active = false
• Subscription નો start date ભવિષ્યમાં

ફિક્સ: ડ્રાઇવર પ્રોફાઇલ → Route Assignments → આજની શિફ્ટ + દિવસ. 12-drivers.md.

આજની ડિલિવરી auto-generate નથી

રાત્રે generate. સવારે ખાલી તો:

1. Deliveries → Generate બટન.
2. સબ્સ્ક્રિપ્શન active + frequency માં આજનો દિવસ?
3. start_date ભવિષ્યનું નથી?
4. છેલ્લે: support — backend cron સમસ્યા હોઈ શકે.

બિલ ₹0 / generate નથી થયું

કારણ:

• તે મહિને ડિલિવરી માર્ક નથી
• બધી skipped
• Bill cycle હજી પૂરી નથી (1લી તારીખે જ auto)

ફિક્સ: Billing → manually generate. હજી ₹0 તો ગ્રાહક ખાતું ચેક.

Payment + billing

પેમેન્ટ રેકોર્ડ પણ બિલ unpaid

Force-refresh:

1. Billing list નીચે ખેંચો.
2. હજી ખોટું — બિલ drawer ખોલો. Payments સેક્શનમાં દેખાય?
3. નહીં — save નથી થયું. ફરી રેકોર્ડ.
4. હા પણ status ખોટું — 5s રાહ + refresh.

UPI પેમેન્ટ આવ્યું પણ રસીદ નહીં

ક્રમમાં:

1. Owner toggle "Payment received" ON.
2. ગ્રાહક whatsapp_notify ON.
3. ક્વોટા ખલાસ નહીં.
4. ગ્રાહક WhatsApp નંબર માન્ય.

બધું OK પણ રસીદ નહીં — support ને bill # + payment ID સાથે.

બિલ રકમ ખોટી

કારણ:

• Partial ડિલિવરી (partial qty જ)
• તે મહિનો સબ્સ્ક્રિપ્શન paused
• Custom price
• પેમેન્ટ ખોટા બિલ પર (multi-month)

બિલ PDF દિન-વાર બધી ડિલિવરી બતાવે — math પારદર્શી.

WhatsApp

"Template doesn't exist"

Meta માં તમારા નંબર સામે template approved નથી. Support — Meta બાજુ જ ફિક્સ.

આજે WhatsApp બંધ

સંભાવના:

1. ક્વોટા ખલાસ — Settings → WhatsApp → usage. લાલ બાર = 1લી તારીખ.
2. Owner toggle બંધ — Settings → WhatsApp.
3. ગ્રાહક opt-out — whatsapp_notify OFF.
4. ખોટો નંબર / WhatsApp પર નથી — Meta બાજુ silently fail.

ગ્રાહક કહે "જૂનો સંદેશ ફરી મળ્યો"

WhatsApp / network poor connectivity પર retry. ખરેખર duplicate તો Send All history ચેક. નહીં ટ્રિગર કર્યું તો Meta retry.

કાઉન્ટર

Sale પછી counter customer count nahi અપડેટ

જૂનો બગ — silent refresh થી ઠીક. હજી તો force-close + ફરી ખોલો.

Counter sale એડિટ ન થાય

પહેલા paid / partial પર બ્લોક હતું. હવે કાઢ્યું — બધી counter sale editable + cancellable. હજી "This sale has a payment recorded" દેખાય તો app refresh / update.

"Send WhatsApp update" ટૉગલ counter પર નથી

Owner toggle "Counter / pickup update" ON ઝરૂરી. બંધ હોય તો per-sale switch છુપાઈ.

ડ્રાઇવર

ડ્રાઇવર ફોન પર ખોટી ડેરી

Stale session:

1. ડ્રાઇવર: Settings → Sign out.
2. ફરી login.
3. હજી ખોટી તો owner_id ચેક.

Partial / qty edit ન કરી શકે

પ્લાન / permission:

1. ડ્રાઇવર રેકોર્ડ → "Can edit quantity" ON.
2. Plan tier — કેટલાક પ્લાન બ્લોક.

Mobile swipe delivered પણ WhatsApp નહીં

જૂનો બગ — keepalive: true + credentials: "include" થી ઠીક. હજી તો force-close + ફરી ખોલો.

App / device

Splash / loading પર અટકેલ

1. Force-close.
2. ફરી ખોલો.
3. હજી — internet ચેક.
4. હજી — uninstall + Play Store / milkgo.in થી reinstall.
5. હજી — support ticket.

Reports ખોલતા crash

Reports માં ઘણો data. કારણ:

• Slow ફોન + મોટી date range
• Historical reports plan-gated

ફિક્સ: પહેલા "This month" — પછી મોટી range.

"Network error" toasts વારંવાર

Internet patchy. Retry auto પણ signal ઓછું તો:

• Mobile data ↔ Wi-Fi switch
• સારા signal માં જાઓ
• ડિલિવરી માર્ક; queue + network પાછું આવે ત્યારે sync.

Plan / billing

Upgrade ભર્યું પણ trial / expired

30 મિનિટ રાહ — admin manually. હજી તો WhatsApp થી payment screenshot.

Plan expired પણ ભર્યું

સંભાવના:

• Payment ન પહોંચ્યું (UPI fail / ખોટું UPI ID)
• Admin હજી પ્રોસેસ નહીં
• પાછલા મહિના ની renewal — જૂના end-date થી extend.

Admin ને: payment 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