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

Panoramica.
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 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.
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.

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.
- 1Posizione 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.
- 2Solo 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.
- 3Luoghi salvatiCasa, Università e Lavoro sono a un tocco, e ogni viaggio passato si può prenotare di nuovo.

Una ricerca dei luoghi che conosce l'Algeria
Prima i luoghi di WEVO, poi i risultati di OpenStreetMap, limitati all'Algeria e ordinati in modo che i luoghi entro 20 km dall'utente vengano prima.
- 1Risposte in cacheLe risposte di ricerca e di geocodifica inversa restano in cache per sette giorni, così la stessa via non viene cercata due volte.
- 2Leggera sulla reteL'app aspetta 300 ms dalla fine della digitazione prima di cercare e, senza rete, usa i luoghi di WEVO.
- 3Scegli sulla mappaSe la ricerca non trova il punto, il cliente può mettere un segnaposto sulla mappa.

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.
- 1Distanza stradale, non in linea d'ariaLa funzione di preventivo ottiene il percorso da OSRM: distanza, tempo e la linea disegnata sulla mappa.
- 2Regole che il cliente può regolareTariffa base, al km (più economica dopo 15 km tra città), al minuto, tariffa minima, fattore notturno e fattore veicolo.
- 3Domanda in tempo realeUn fattore tra 1,0 e 1,5 basato sulle richieste aperte rispetto agli autisti online entro circa 10 km.

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.
- 1Preventivi emessi dal serverOgni ordine deve fare riferimento a un preventivo valido 20 minuti e utilizzabile una sola volta.
- 2Un intervallo che l'app non può allargareLe offerte fuori dal 70%–300% del prezzo suggerito, o sotto la tariffa minima, vengono rifiutate dal database.
- 3Offerte e controfferte in tempo realeLe offerte degli autisti arrivano tramite Supabase Realtime e il cliente accetta quella che preferisce.

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.
- 1Ondate 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.
- 2Suono e vibrazioneUna nuova richiesta suona con il suono di avviso di WEVO e vibra, con una notifica quando l'app è in background.
- 3Nessuna richiesta dimenticataUna richiesta che nessuno prende entro 6 minuti si chiude da sola e il cliente può riprovare con un altro prezzo.

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

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.
- 1Un 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.
- 2Foto al ritiroIl corriere fotografa il pacco con la fotocamera del telefono al momento del ritiro.
- 3Oppure una firmaSe il codice non è disponibile, il destinatario può firmare sullo schermo del corriere.

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.
- 1Valutazioni reciprocheI clienti valutano gli autisti e gli autisti valutano i clienti dopo ogni viaggio.
- 2Commissione sulle corse in contantiOgni corsa in contanti registra la commissione di WEVO, e i saldi la azzerano.
- 3Profilo autista obbligatorioGli autisti aggiungono una foto e modello, anno e targa dell'auto prima di potersi mettere online.

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.
- 1PersoneApprova, blocca o elimina gli account, e vedi pagamenti e messaggi di ogni persona.
- 2PrezziLe regole di prezzo si modificano dall'app, senza una nuova release.
- 3Una sola codebaseCliente, autista VTC, corriere in moto e admin sono modalità di un'unica app React Native.
Altre schermate.






Architettura.
Approfondimenti tecnici.
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.
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.
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.
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.
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.
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.
Prossimi passi.
Dove si trova
I flussi di cliente, autista e corriere funzionano end to end sul backend reale, e una build beta Android è pronta, con una guida per i tester in arabo. Le notifiche push sono pronte e aspettano il progetto Firebase del cliente. La posizione in background su iOS e la pubblicazione sul Play Store sono ancora da fare.
Prima del lancio
Documenti degli autisti con approvazione dell'admin, routing e ricerca dei luoghi self-hosted, Supabase Pro con backup giornalieri, termini e privacy in arabo e francese, crash reporting e test su diversi telefoni Android reali.