Gestionale Affitti Brevi con Flutter: Caso Studio Hostpilot (Airbnb + Booking + Fisco Italiano)

Gestire affitti brevi in Italia non è solo una questione di accoglienza: è un lavoro vero, con adempimenti fiscali, piattaforme multiple da sincronizzare e il rischio costante di overbooking. Hostpilot nasce per risolvere esattamente questi problemi — un'app Flutter mobile e web che centralizza tutto in un'unica interfaccia, pensata specificamente per il mercato italiano.

Il problema: gestire più canali è un incubo operativo

Gli host con due o più proprietà su Airbnb, Booking.com e canali diretti si trovano a fare acrobazie ogni giorno: aggiornare manualmente i calendari su ogni piattaforma, calcolare a mano la tassa di soggiorno per ogni ospite, tenere traccia delle cedole secche per il commercialista, rispondere ai messaggi su app diverse. Una doppia prenotazione può costare una recensione negativa e una multa. Ho identificato questi punti di dolore concreti e ho costruito Hostpilot per risolverli tutti.

La soluzione: un channel manager con gestione fiscale italiana integrata

Hostpilot è un'app Flutter che funziona sia su smartphone (iOS e Android) che come web app desktop. L'architettura backend si basa su Supabase (PostgreSQL) con Row Level Security per separare completamente i dati di ogni host, e Firebase Cloud Messaging per le notifiche push in tempo reale. Il sistema di abbonamenti è gestito con RevenueCat.

Funzionalità che fanno la differenza

• •Sincronizzazione iCal bidirezionale: Airbnb, Booking.com, Vrbo e prenotazioni dirette in un unico calendario — il rischio overbooking scende a zero
• •Calcolo automatico tassa di soggiorno: configurabile per Comune (importo per persona/notte, esenzioni bambini, massimo notti), il totale viene calcolato su ogni prenotazione
• •Cedolare secca automatica: aliquota configurabile (default 21%), riepilogo trimestrale pronto per il commercialista e per il modello F24
• •Commissioni OTA preconfigurate: Airbnb 15%, Booking 18%, Vrbo 8%, Expedia 20% — il netto incassato è sempre visibile in dashboard
• •Link raccolta dati ospiti: un link automatico inviato all'ospite pre-check-in per acquisire documenti e dati anagrafici senza chiamate
• •Dashboard analytics: occupancy rate, ADR (prezzo medio notte), revenue per proprietà e per periodo con grafici interattivi FL Chart

Architettura tecnica: Flutter + Supabase + Firebase

Ho scelto Flutter per avere un'unica codebase che funzionasse sia su mobile che su web con performance native. La gestione dello stato usa il pattern Provider con ChangeNotifier, organizzato per dominio funzionale (PrenotazioniProvider, AlloggiProvider, OspitiProvider). Il layer dati è completamente astratto tramite un servizio repository che comunica con Supabase. Le Realtime Subscriptions di Supabase aggiornano la dashboard istantaneamente all'arrivo di nuove prenotazioni. Un sistema di cache LRU intelligente (SmartCacheService) garantisce performance anche offline.

Le sfide tecniche risolte

• •Multi-tenancy sicuro: le Row Level Security policies di PostgreSQL garantiscono l'isolamento completo dei dati tra host diversi, senza logica applicativa aggiuntiva
• •Conflict resolution per il calendario: sistema di locking atomico per prevenire race condition nella sincronizzazione simultanea da più portali
• •Gestione offline: cache locale Hive con strategia di sincronizzazione selettiva — l'app rimane funzionale anche senza connessione
• •Migrazione database live: schema delle prenotazioni rielaborato con zero downtime per utenti attivi, usando strategie di migrazione progressiva
• •Notifiche push affidabili: Firebase Cloud Messaging per alert check-in/check-out imminenti, anche con app chiusa

Risultati concreti per gli host

Gli host che usano Hostpilot segnalano un risparmio di 2-3 ore al giorno rispetto alla gestione manuale su piattaforme separate. L'eliminazione del rischio di doppia prenotazione è il benefit più apprezzato — specialmente per chi gestisce più di 3 proprietà. Il riepilogo fiscale automatico ha ridotto il tempo di preparazione del commercialista da una giornata a 15 minuti a trimestre.