La descrizione originale
« Gestisco circa trenta unità immobiliari per conto di diversi proprietari. Ogni immobile ha un indirizzo, una superficie, un canone mensile e spese accessorie, ed è intestato a un proprietario. Un immobile è dato in locazione tramite un contratto di locazione, con un inquilino, una data di inizio, una durata e una cauzione. Ogni mese devo sapere quali canoni sono stati incassati e quali sono in ritardo, e voglio essere avvisato dei contratti di locazione in scadenza. Ho inoltre bisogno di un estratto conto personalizzato per proprietario che possa inviare loro. »
Il piano approvato prima della generazione
Prima di scrivere anche solo una singola linea di codice, Blueprint Maker traduce questa descrizione in un piano da approvare. Per Trousseau il piano occupa un solo schermo: cinque entità, Proprietario, Immobile, Inquilino, Contratto di locazione, Canone, e i collegamenti tra di esse. Un immobile appartiene a un proprietario; un contratto di locazione riferisce un inquilino a un immobile; un canone è associato a un contratto di locazione e ne riporta il mese di riferimento.
Gli stati dedotti dal testo compaiono nello stesso piano: il contratto di locazione passa per gli stati attivo, in scadenza, risolto; il canone per gli stati dovuto, incassato, in ritardo. Gli indicatori richiesti sono esplicitati chiaramente. Se manca un’entità, se uno stato è superfluo o se un’etichetta non corrisponde al vostro linguaggio, lo si corregge qui: ciò che viene generato è esattamente ciò che è stato concordato.
- Entità: Proprietario, Immobile, Inquilino, Contratto di locazione, Canone
- Relazioni: immobile → proprietario; contratto di locazione → immobile; contratto di locazione → inquilino; canone → contratto di locazione
- Stati: attivo / scaduto / chiuso; dovuto / incassato / in ritardo
- Indicatori: canoni incassati del mese, morosità in corso, contratti di locazione in scadenza, tasso di occupazione
La navigazione: una sezione per ogni entità
L’applicazione generata si apre con una barra laterale sobria: Dashboard, Immobili, Proprietari, Inquilini, Contratti di locazione, Canoni. Ogni sezione porta a una lista, non a un foglio di calcolo, ma a una vera lista applicativa: ricerca in cima, colonne ordinabili con un clic, paginazione e un contatore che indica quanti risultati soddisfano il filtro corrente.
La lista dei canoni mostra il mese di riferimento, l’immobile, l’inquilino, l’importo e lo stato del pagamento. Accanto alla ricerca compaiono un filtro a faccette per lo stato e un filtro per il periodo. Questi filtri sono incorporati nell’indirizzo della pagina: la vista «canoni in ritardo nel trimestre» può essere salvata come preferita o inviata via messaggio al collega, aprirà esattamente ciò che stavate visualizzando, non la vista predefinita.
Ogni lista si esporta in CSV, e l’esportazione include esattamente le righe visualizzate a schermo, filtro compreso, il numero di righe è indicato nell’etichetta del pulsante, così da sapere esattamente cosa si sta scaricando prima di cliccare.
La barra delle scadenze: ciò che va gestito questa settimana
È la funzionalità più utile di uno strumento per la gestione degli affitti, e viene inserita automaticamente non appena un’entità contiene una data di scadenza. Sopra la lista, l’applicazione mostra una barra che sintetizza la situazione in una sola riga: quante scadenze sono già scadute, quante scadono oggi e quante scadono nei prossimi sette giorni.
Sotto, le cinque scadenze più vicine sono elencate per nome, ordinate per data, ciascuna con un pulsante «Gestisci» che apre direttamente la scheda corrispondente. Se ce ne sono di più, la barra lo segnala invece di allungarsi. Una riga il cui stato indica che è stata regolarizzata scompare automaticamente dalla barra: si vede solo ciò che resta da fare.
Nella pratica: si apre l’applicazione lunedì mattina e si vedono, senza dover ordinare né filtrare nulla, i canoni in ritardo e i contratti di locazione prossimi alla scadenza.
La scheda immobile: contratto di locazione in corso e storico dei canoni
Cliccare su una riga apre una scheda IN LETTURA, non il modulo di modifica. La distinzione sembra minima, ma non lo è: si consulta un immobile venti volte per ogni volta che lo si modifica, e aprire un modulo solo per consultarlo è il modo più sicuro per modificare qualcosa per sbaglio. Il pulsante «Modifica» è comunque presente, accanto alla scheda, quando è proprio quello che si vuole fare.
La scheda di un immobile riporta il suo indirizzo, la sua superficie, il canone e le spese accessorie, oltre al proprietario. Subito sotto compare la parte che cambia radicalmente rispetto al foglio di calcolo: il contratto di locazione in corso, con l’inquilino e la data di scadenza, seguito poi dall’elenco cronologico dei canoni relativi A QUESTO immobile, i mesi già incassati, quello in ritardo, il prossimo da richiedere.
Questo collegamento non è puramente estetico: nasce dalla base dati relazionale generata. Correggere i dati di contatto di un inquilino li aggiorna ovunque; l’estratto conto di un proprietario deriva direttamente dai suoi immobili, senza alcuna copia manuale.
Indicatori che conducono a qualcosa
La dashboard riprende gli indicatori richiesti nella descrizione: canoni incassati del mese, morosità in corso, contratti di locazione in scadenza, tasso di occupazione del portafoglio. Si tratta di query sulla base dati, non di valori inseriti manualmente: ogni canone registrato li aggiorna automaticamente.
Due dettagli ne trasformano l’utilizzo. Il primo: ogni card specifica CHIARAMENTE il periodo di riferimento, sotto il valore numerico, «Questo mese», «Ultimi 30 giorni», «Da inizio». Un numero senza contesto temporale viene sempre letto come «recente», ma raramente è questo il suo significato.
Il secondo: ogni card è cliccabile. Cliccare su «morosità in corso» apre la lista dei canoni con il filtro dell’indicatore già applicato, evidenziato da una tag che si può rimuovere con un clic. Si passa così dal valore numerico alle righe che lo compongono senza dover ricostruire il filtro mentalmente, e se una condizione dell’indicatore non fosse replicabile esattamente, il clic porterà comunque alla lista, semplicemente senza filtro: una lista parzialmente filtrata che sembrasse completa sarebbe peggiore dell’assenza totale di filtro.
L’estratto conto per proprietario, pensato per uscire dallo schermo
È la richiesta esplicita contenuta nel pitch, ed è uno schermo dedicato: un estratto conto sintetico per proprietario che aggrega i suoi immobili, i canoni incassati nel periodo e le spese accessorie, con un’intestazione che specifica l’unità di misura degli importi.
Questo schermo include un pulsante «Stampa» deterministico, non una chiamata a un servizio esterno, né un modello compilato da un’intelligenza artificiale: la stampa nativa del browser, con layout A4 e interruzioni di pagina definite dal foglio di stile dell’applicazione. Il pulsante stesso viene nascosto nell’output di stampa, quindi non appare mai sulla pagina stampata. Da qui si può stampare direttamente o salvare in PDF tramite il browser, per poi inviarlo.
Ciò che l’applicazione NON fa, e conviene saperlo prima
Trousseau tiene il registro: quale immobile, quale contratto di locazione, quale inquilino, quale canone, aggiornato o meno. Non incassa denaro: nessun pagamento online, nessun addebito diretto SEPA, nessun riconciliazione bancaria vengono generati. Un canone viene marcato come incassato solo dopo aver ricevuto l’importo altrove.
Non emette ricevute di canone nel senso giuridico del termine: l’estratto conto si stampa, ma non è un modello regolamentare con numerazione progressiva e formule obbligatorie. Non produce dichiarazioni fiscali e non consente la firma elettronica dei contratti di locazione.
Infine, AFFICHA le scadenze, ma non le invia: la barra segnala all’apertura dello schermo ciò che è in ritardo e ciò che sta per scadere, senza inviare automaticamente email o SMS all’inquilino. Si tratta di funzionalità che uno sviluppatore può aggiungere, il codice è esportabile, ma non sono incluse nella generazione automatica.
Dati dimostrativi: valutare su schermate complete
Trousseau arriva già popolata: diversi mesi di vita simulata, immobili con indirizzi plausibili distribuiti tra più proprietari, contratti di locazione a diversi stadi, canoni incassati e, volutamente, alcuni in ritardo e un contratto di locazione prossimo alla scadenza, per verificare il funzionamento della barra delle scadenze e degli indicatori su dati realistici, non su zeri.
Si tratta di una scelta deliberata: uno strumento di gestione non si valuta su tabelle vuote. I dati dimostrativi vengono successivamente cancellati per lasciare spazio ai dati reali. L’applicazione è accessibile tramite il suo URL dedicato e il codice sorgente completo è esportabile (ZIP o push su GitHub), basato su Next.js + Prisma standard.