← Tutti i progetti
Caso studio · Mobilità · Mobile · Progetto per un cliente

Corse e consegne in Algeria, a un prezzo su cui entrambe le parti sono d'accordo.

WEVO è un'app di corse e consegne in moto per l'Algeria. Il cliente propone un prezzo, gli autisti vicini accettano o rilanciano e tutti seguono il viaggio in tempo reale sulla mappa. Un'unica codebase React Native contiene l'app cliente, l'app per autisti VTC, l'app per corrieri in moto e la dashboard di amministrazione, in arabo e francese.
ClienteWEVO, Algeria, tramite la mia agenzia Barmjli
StatoBuild beta Android pronta; prossimo passo la pubblicazione sugli store
PiattaformaAndroid e iOS, React Native 0.85 bare, nuova architettura
TecnologieReact 19, TypeScript, Supabase (Postgres 17, Realtime, Edge Functions, pg_cron)
Schermata principale del cliente WEVO
4
app in una codebase: cliente, autista, corriere, admin
39
controlli SQL sul flusso degli ordini
7
wilaya, garantite dal database
2
lingue: arabo (RTL) e francese

Panoramica.

Per chi è, per cosa è stato difficile, per cosa è stato rilasciato.
Gli utenti

Passeggeri, mittenti, autisti e corrieri

Persone nelle città algerine che hanno bisogno di un'auto o vogliono spedire un pacco in città, e gli autisti VTC e i corrieri in moto che ci lavorano, pagati per lo più in contanti.

Il problema

Il prezzo si tratta, la fiducia è poca

I passeggeri si aspettano di discutere il prezzo, gli autisti vogliono le corse più vicine e nessuno vuole una richiesta che resta senza autista. I pacchi hanno bisogno di una prova di consegna alla persona giusta.

Il prodotto

Trattativa con regole, abbinamento per distanza

Prezzi emessi dal server con un intervallo consentito, offerte e controfferte in tempo reale, ondate degli autisti più vicini, tracciamento live, chat nell'app e prova di consegna con codice segreto, foto o firma.

Schermate.

Dalla build beta, collegata al backend reale.
Schermata principale del cliente WEVO in arabo
01 · Home del cliente

Una corsa o un pacco, da una sola schermata

Il cliente sceglie una corsa o una consegna, vede in alto il viaggio in corso e parte dalla sua posizione GPS reale. Tutta l'app funziona in arabo (da destra a sinistra) o in francese.

  • 1
    Posizione reale, con un nomeIl punto di partenza è la posizione GPS del telefono, e l'app gli dà il nome del punto di riferimento o della via più vicina.
  • 2
    Solo dove WEVO operaIl servizio è limitato a sette wilaya (Algeri, Orano, Costantina, Sétif, Annaba, Blida, Tlemcen). Fuori da queste, il database rifiuta ordini e messa online.
  • 3
    Luoghi salvatiCasa, Università e Lavoro sono a un tocco, e ogni viaggio passato si può prenotare di nuovo.
Opzioni di veicolo con prezzi
03 · Prezzo

Un prezzo vero dalla distanza stradale reale

Ogni opzione mostra un prezzo calcolato sul server dal percorso stradale, dalle regole di prezzo del veicolo e dall'equilibrio in tempo reale tra richieste e autisti liberi nelle vicinanze.

  • 1
    Distanza stradale, non in linea d'ariaLa funzione di preventivo ottiene il percorso da OSRM: distanza, tempo e la linea disegnata sulla mappa.
  • 2
    Regole che il cliente può regolareTariffa base, al km (più economica dopo 15 km tra città), al minuto, tariffa minima, fattore notturno e fattore veicolo.
  • 3
    Domanda in tempo realeUn fattore tra 1,0 e 1,5 basato sulle richieste aperte rispetto agli autisti online entro circa 10 km.
Schermata per proporre il prezzo con un'offerta di 2.100 DA
04 · Trattativa

Proponi il tuo prezzo, entro un intervallo equo

Come nel mercato locale, il cliente può offrire un prezzo diverso e gli autisti possono rilanciare. Il server decide l'intervallo consentito, così la trattativa resta equa per entrambi.

  • 1
    Preventivi emessi dal serverOgni ordine deve fare riferimento a un preventivo valido 20 minuti e utilizzabile una sola volta.
  • 2
    Un intervallo che l'app non può allargareLe offerte fuori dal 70%–300% del prezzo suggerito, o sotto la tariffa minima, vengono rifiutate dal database.
  • 3
    Offerte e controfferte in tempo realeLe offerte degli autisti arrivano tramite Supabase Realtime e il cliente accetta quella che preferisce.
Autista che riceve una nuova richiesta di corsa
05 · Autista

Gli autisti più vicini lo sanno per primi

Una nuova richiesta raggiunge a ondate gli autisti liberi più vicini. L'autista vede prezzo, distanza e valutazione del cliente, e può accettare, rifiutare o fare una controfferta.

  • 1
    Ondate da 3, 6, poi 12I 3 più vicini entro 3 km per 25 secondi, i 6 più vicini entro 5 km, i 12 più vicini entro 8 km, poi tutti entro 10 km.
  • 2
    Suono e vibrazioneUna nuova richiesta suona con il suono di avviso di WEVO e vibra, con una notifica quando l'app è in background.
  • 3
    Nessuna richiesta dimenticataUna richiesta che nessuno prende entro 6 minuti si chiude da sola e il cliente può riprovare con un altro prezzo.
Cliente che segue l'autista in arrivo, con i pulsanti di chat e chiamata
06 · Viaggio live

Segui l'autista e parlagli nell'app

Dopo l'abbinamento il cliente vede foto, auto e targa dell'autista, il tempo di arrivo e l'auto che si muove sulla mappa. I pulsanti di chat e chiamata sostituiscono gli SMS.

  • 1
    GPS in tempo realeGli autisti online inviano la posizione ogni 10 metri percorsi, al massimo ogni 2,5 secondi, con un segnale ogni 45 secondi.
  • 2
    Chat nell'appCliente e autista si scrivono all'interno del viaggio, con una notifica per ogni nuovo messaggio.
  • 3
    Nessuno resta bloccatoEntrambi possono annullare prima della partenza, e i viaggi il cui autista non dà più segnali vengono chiusi in automatico.
Ricerca della destinazione di una consegna
07 · Consegna

Pacchi con prova di consegna

Il mittente indica destinatario e destinazione, e un corriere in moto ritira il pacco. Il corriere fotografa il pacco al ritiro e prova la consegna con un codice o una firma.

  • 1
    Un codice segretoIl destinatario riceve un codice di 4 cifre che non viene mai inviato al corriere. La consegna si chiude solo con il codice giusto.
  • 2
    Foto al ritiroIl corriere fotografa il pacco con la fotocamera del telefono al momento del ritiro.
  • 3
    Oppure una firmaSe il codice non è disponibile, il destinatario può firmare sullo schermo del corriere.
Cronologia delle attività con i totali
08 · Attività

Cronologia, valutazioni e quanto devono gli autisti

I clienti vedono ogni corsa e consegna con il suo prezzo. Gli autisti vedono i loro guadagni e, sulle corse in contanti, la commissione dovuta a WEVO viene tracciata fino al saldo.

  • 1
    Valutazioni reciprocheI clienti valutano gli autisti e gli autisti valutano i clienti dopo ogni viaggio.
  • 2
    Commissione sulle corse in contantiOgni corsa in contanti registra la commissione di WEVO, e i saldi la azzerano.
  • 3
    Profilo autista obbligatorioGli autisti aggiungono una foto e modello, anno e targa dell'auto prima di potersi mettere online.
Dashboard di amministrazione WEVO nell'app
09 · Admin

La dashboard dell'operatore, nella stessa app

Una modalità admin dà al team di WEVO una vista in tempo reale del servizio: corse e consegne in corso, autisti online, mappa, ordini, utenti, finanze, prezzi e impostazioni.

  • 1
    PersoneApprova, blocca o elimina gli account, e vedi pagamenti e messaggi di ogni persona.
  • 2
    PrezziLe regole di prezzo si modificano dall'app, senza una nuova release.
  • 3
    Una sola codebaseCliente, autista VTC, corriere in moto e admin sono modalità di un'unica app React Native.
Arabo RTL e francese
Suoni di avviso personalizzati
Banner offline
Notifiche push (FCM)
Tile Esri con licenza
Fotocamera e firma

Altre schermate.

Onboarding in entrambe le lingue e il viaggio visto dall'autista.

Architettura.

Nessun server separato. L'app parla con Supabase, e le regole vivono in Postgres.
Dispositivo
React Native appModalità cliente, autista VTC, corriere in moto e admin · arabo e francese · nuova architettura, Hermes
Mappe e GPSreact-native-maps con tile Esri · GPS del dispositivo · servizio in primo piano su Android quando si è online
Funzioni nativeFotocamera per le foto al ritiro · area firma · suoni di avviso · push FCM
→
Supabase
Postgres 17 + RLSOrdini, offerte, autisti, preventivi, valutazioni, saldi, messaggi · cambi di stato tramite funzioni controllate
RealtimeOfferte, abbinamenti, fasi del viaggio e posizioni degli autisti inviati a entrambi i telefoni
Job pg_cronOndate e scadenza delle richieste ogni 30 secondi · pulizia dei viaggi bloccati · pulizia della cache
Edge Functionsquote · route · places · push
→
Servizi
OSRMDistanza stradale, tempo e percorso per prezzi e navigazione
Photon / OpenStreetMapRicerca dei luoghi e geocodifica inversa, limitate all'Algeria
Esri e FirebaseTile della mappa · notifiche push tramite FCM HTTP v1
Circa 16.700 righe di TypeScript nell'app e 24 migrazioni SQL, con tutte le stringhe in arabo e francese nei file di traduzione dell'app.

Approfondimenti tecnici.

Sei problemi che hanno dato forma all'app, ognuno con il suo costo.

1. Prezzi garantiti dal server

Problema
Un prezzo calcolato sul telefono si può modificare sul telefono. In un mercato in cui si tratta, entrambe le parti hanno bisogno di un prezzo garantito dal sistema.
Approccio
Una Edge Function verifica la sessione, chiede a OSRM il percorso stradale e chiama issue_quote(), che applica le regole di prezzo e la domanda in tempo reale. Il preventivo vale 20 minuti ed è monouso. Ogni ordine deve farvi riferimento: il server copia distanza, durata e percorso dal preventivo e rifiuta i prezzi fuori intervallo con BAD_PRICE, QUOTE_EXPIRED o QUOTE_INVALID.
Trade-off
Il server pubblico di OSRM è solo per lo sviluppo. Quando non risponde, la funzione ripiega su una stima in linea d'aria segnalata con routed: false, e un router di produzione è ancora da configurare.
Si trova in: supabase/functions/quote · pricing_rules · quotes

2. Prima gli autisti più vicini, garantito dal database

Problema
Inviare ogni richiesta a tutti gli autisti intasa la città e premia chi tocca più in fretta, non chi è più vicino.
Approccio
Un autista vede una richiesta in attesa solo se è online, ha il veicolo giusto, ha inviato il GPS negli ultimi 3 minuti, è libero e rientra nell'ondata corrente. Questa regola vive in una funzione di row-level security, private.driver_can_see, e make_offer rifiuta chi è fuori con OUT_OF_RANGE. Un job pg_cron ogni 30 secondi allarga l'ondata e avvisa gli autisti appena entrati.
Trade-off
I feed degli autisti si aggiornano ogni 10 secondi per vedere l'ondata successiva, con qualche richiesta in più rispetto a un design solo push.
Si trova in: RLS · make_offer() · pg_cron wevo-request-waves

3. Un viaggio è una macchina a stati in Postgres

Problema
Una corsa tocca i dati di due persone: l'ordine del cliente e lo stato dell'autista. Lasciare che l'app scriva direttamente quelle righe apre la porta a race condition e imbrogli.
Approccio
Le scritture dirette sulle tabelle sono consentite solo sulle proprie righe. Ogni passaggio che tocca i dati di un altro (offerta, accettazione, arrivo, partenza, fine, annullamento, valutazione) passa da una funzione del database che prima verifica lo stato attuale. Un file di test SQL esegue 39 controlli sull'intero flusso degli ordini.
Trade-off
Più logica vive in SQL che in TypeScript, ed è più difficile da debuggare, ma è l'unico punto che nessuna delle due app può aggirare.
Si trova in: supabase/migrations · supabase/tests/order_flow.test.sql

4. Un GPS che funziona anche a schermo spento

Problema
Un autista mette il telefono nel supporto e lo blocca. Android chiude le app in background, e un autista che smette di inviare la posizione sparisce dagli abbinamenti.
Approccio
Su Android un servizio in primo piano con una notifica persistente mantiene attivi l'invio della posizione e il token di sessione mentre l'autista è online. Le posizioni sono limitate per distanza e tempo, mettersi online senza GPS fallisce con NO_GPS, e un job sul server mette offline gli autisti silenziosi da 10 minuti e chiude i viaggi mai partiti.
Trade-off
La posizione in background su iOS non è ancora pronta, quindi su iPhone l'app dell'autista deve restare aperta.
Si trova in: OnlineService (Android) · drivers.lat/lng · pg_cron wevo-expire-stale

5. Mappe senza una grossa bolletta mensile

Problema
Un'app di corse disegna mappe tutto il giorno. Pagare a caricamento prima del lancio sarebbe costato più di quanto il budget del cliente consentisse.
Approccio
L'app disegna le tile grigio scuro di Esri con licenza, adattate al nero di WEVO, con le etichette nella lingua dell'app. Le tile da 512 px sono disegnate un livello di zoom più in basso, così le etichette restano di dimensione normale e ogni schermata richiede quattro volte meno tile, entro il livello gratuito di due milioni di tile al mese. La ricerca dei luoghi resta in cache in Postgres per sette giorni.
Trade-off
La ricerca dei luoghi usa il server pubblico di Photon, a uso ragionevole e senza garanzie. Un geocoder self-hosted è nella lista per il lancio.
Si trova in: src/components/map/TileMap.tsx · supabase/functions/places

6. Un crash nativo all'avvio, individuato e risolto con versioni fissate

Problema
L'app si chiudeva all'avvio con un segmentation fault nel registro dei componenti di React Native, prima che girasse una sola riga del suo codice.
Approccio
La causa era react-native-maps 1.26, che compilava il codice nativo senza il flag RN_SERIALIZABLE_STATE di React Native, corrompendo il layout delle props nella nuova architettura. Fissare React Native 0.85.3 con react-native-maps 1.29.8 o successivo ha risolto il problema, e il README avverte di non tornare indietro.
Trade-off
Con versioni fissate, ogni aggiornamento richiede attenzione e una build di prova.
Si trova in: mobile/package.json · mobile/README.md