Boxette Flights

I clienti continuavano a chiedere dove fosse il loro pacco e quando sarebbe atterrato il suo volo. La pagina degli orari era un unico file statico alimentato da webhook n8n aperti, gli operatori tenevano a mano i dati dei voli in un Google Sheet e uno stato cambiava solo quando qualcuno si ricordava di aggiornarlo. I clienti non vedevano dove si trovasse davvero il loro carico, e gli operatori non avevano un unico posto per gestire arrivi e spedizioni.

La prima pagina degli orari (da v1 a v3.5, febbraio–marzo 2026) ha aggiunto filtri per paese e mezzo di trasporto, la logica dei ritardi, schede per mobile e tre lingue. Dopo i prototipi di tracciamento per lettera di vettura aerea e per volo live, tutto è stato ricostruito come v4: un’unica app Express che serve la pagina pubblica, un’API REST su Postgres che mantiene il formato di risposta dei vecchi webhook e un pannello admin in React e TypeScript con ruoli, log di audit, dashboard, filtri in stile ClickUp, una creazione guidata passo passo e un calendario settimanale automatico delle spedizioni. Ho pianificato la v4, poi gli agenti Claude Code ne hanno costruito la maggior parte in sessioni lunghe e per lo più autonome, mentre io dirigevo, rivedevo il lavoro e prendevo le decisioni di design.

Un poller che procede solo in avanti porta ogni volo attraverso una pipeline di sei fasi in base agli eventi della lettera di vettura aerea, usando il tracking di Turkish Cargo e TrackCargo per gli altri vettori. Le traiettorie di Flightradar24 sono in cache per la mappa, e gli operatori possono pubblicare note di cronologia che, a scelta, diventano visibili ai clienti. Il server rimuove numeri di lettera di vettura, vettori e codici aeroportuali prima che qualsiasi dato arrivi alla pagina dei clienti. L’app gira su Vercel con Neon Postgres.