Mandarin Delivery — Aplicație Livratori

🚗 Ce este Mandarin Delivery?

Mandarin Delivery este aplicația Android Startup Delivery dedicată livratorilor. Aplicația primește comenzile alocate, oferă navigare GPS către adresa clientului, permite actualizarea statusului comenzii și transmite poziția livratorului în timp real către panoul de management.

Fiecare livrator are propriul cont și primește doar comenzile alocate lui. Managerul vede pe hartă toți livratorii în timp real și poate realoca comenzi dacă este nevoie. Aplicația funcționează pe orice telefon Android modern și consumă resurse minime de baterie și date mobile.

⚙️ Cerințe

📥 Instalare și Configurare

1. Descarcă aplicația — Din Google Play Store, caută "Mandarin Delivery" sau folosește link-ul direct furnizat de administrator. Alternativ, instalează manual din APK (vezi ghidul).
2. Configurează serverul — La prima pornire, introdu adresa serverului furnizată de administrator (ex: https://client.startup-delivery.ro).
3. Autentificare — Introdu utilizatorul și parola de livrator create din panoul de administrare.
4. Permite permisiunile — La prima utilizare, permite accesul la: Locație (întotdeauna), Notificări push, Telefon (pentru apeluri client).
5. Dezactivează optimizarea bateriei — Din Setări Android → Baterie, exclude aplicația de la optimizare pentru a menține tracking-ul GPS activ în fundal.
6. Testează — Solicită o comandă de test din panoul de administrare și verifică primirea pe telefon.

🚀 Funcționalități

Lista Comenzi

Ecranul principal afișează comenzile alocate livratorului, ordonate după urgență. Fiecare comandă conține: produsele comandate, adresa de livrare, telefonul clientului, observațiile și metoda de plată.

Navigare GPS

Un singur tap pe adresă deschide navigația GPS (Google Maps sau Waze) cu ruta optimă către client. Distanța și timpul estimat sunt afișate direct în aplicație.

Schimbare Status

Livratorul actualizează statusul comenzii pe parcursul livrării: Preluat (a ridicat comanda din restaurant), În drum (se deplasează la client), Livrat (a predat comanda). Statusul se actualizează instant în POS și pe ecranul clientului.

Apel Client Direct

Butonul de apel permite contactarea rapidă a clientului fără a căuta numărul manual. Util când adresa nu este clară sau clientul nu răspunde la interfon.

Tracking GPS Real-Time

Locația livratorului este transmisă la server la intervale regulate. Managerul vede pe hartă toți livratorii și poate lua decizii de alocare bazate pe distanță și disponibilitate.

🔄 Workflow Livrare

1. Notificare — Livratorul primește notificare push cu o comandă nouă alocată.
2. Vizualizare — Deschide aplicația și verifică detaliile comenzii.
3. Preluare — Ridică comanda din restaurant și marchează Preluat.
4. Navigare — Apasă pe adresă și navighează cu GPS-ul.
5. Livrare — Predă comanda, încasează dacă este plată la livrare.
6. Confirmare — Marchează comanda ca Livrată și selectează metoda de plată.

🔗 Integrări

Mandarin Delivery se integrează cu: BistroPOS (primire comenzi), Tracking Livratori (hartă în timp real), modulul de rapoarte (performanță livratori) și Magazin Online (comenzi online).

🔧 Depanare

Problema: Nu primesc notificări de comenzi noi

Soluție: Verifică permisiunea de notificări. Verifică că aplicația nu este oprită de optimizarea bateriei. Verifică conexiunea la internet.

Problema: GPS-ul nu funcționează

Soluție: Verifică că locația este activată pe telefon. Selectează modul de locație "Precizie ridicată" (GPS + Wi-Fi + date mobile).

Problema: Aplicația se închide în fundal

Soluție: Dezactivează optimizarea bateriei pentru aplicație. Pe unele telefoane (Xiaomi, Huawei, Samsung), trebuie adăugată în lista de aplicații protejate.

Problema: Nu mă pot autentifica

Soluție: Verifică adresa serverului (HTTPS, fără spații, fără / final). Verifică utilizatorul și parola. Verifică conexiunea la internet.

Problema: Harta de navigare nu se deschide

Soluție: Instalează Google Maps sau Waze pe telefon. Verifică că o aplicație de navigare este setată ca implicită.

❓ Întrebări Frecvente (FAQ)

Cât trafic de date consumă aplicația?

Aproximativ 300-500 MB/lună în utilizare normală. Navigarea GPS consumă suplimentar, dar majoritatea hărților sunt cache-uite local.

Funcționează pe iPhone?

Momentan, Mandarin Delivery este disponibil doar pe Android. Versiunea iOS este în dezvoltare.

Livratorul poate vedea toate comenzile?

Nu, fiecare livrator vede doar comenzile alocate lui. Alocarea se face de operator sau automat de sistem.

Pot folosi aplicația pe bicicletă/scooter?

Da, aplicația funcționează pe orice mod de transport. Recomandat: suport telefon pe ghidon și cască Bluetooth pentru apeluri.

Cum raportează managerul performanța livratorilor?

Din panoul de tracking, managerul vede: număr livrări, timp mediu, distanța parcursă, rating.

Ce se întâmplă dacă telefonul rămâne fără baterie?

Comanda rămâne alocată livratorului. Managerul o poate realoca altui livrator din panoul de administrare.

📞 Ai Nevoie de Ajutor?

Dacă documentația nu a rezolvat problema ta: