HomeBalanceMonitor
Un'applicazione web di famiglia per tenere in un posto solo entrate e uscite di conti e carte di credito, in sola lettura. Fondamenta e registro manuale con import da file sono costruiti.
L’idea
Vorrei un posto solo dove la famiglia veda cosa entra e cosa esce, invece di guardare ogni banca separatamente. HomeBalanceMonitor vuole essere quel posto: un’applicazione web multiutente, usata solo dentro la rete di casa, dove i movimenti arrivano in tre modi: sincronizzazione in sola lettura con un servizio di Open Banking, import dai file CSV/Excel delle banche e inserimento manuale. Non fa mai pagamenti: usa solo l’accesso in lettura.
Prima la progettazione
Per ora non c’è codice dell’applicazione, solo un documento di requisiti e uno script di prova. Volevo i vincoli su carta prima di scrivere qualsiasi cosa, perché diversi cambiano la forma del progetto:
- Intestatario, utente dell’app e chi autorizza sono cose diverse, quindi i permessi si danno per utente e per conto (nessuno, lettura, scrittura), e il modo in cui un conto viene alimentato (API o file) è un’impostazione del singolo conto.
- Il consenso non è per sempre. Un’autorizzazione Open Banking dura un tempo limitato, senza refresh: va rinnovata con l’autenticazione forte della banca. Il piano prevede una pagina di stato e avvisi email prima della scadenza.
- Le banche limitano le letture quando l’utente non è presente, quindi l’applicazione sincronizza un paio di volte al giorno, più un pulsante «Sincronizza ora».
- Lo storico può accorciarsi poco dopo l’autorizzazione, quindi il download completo parte subito dopo il consenso, e i file importati coprono eventuali buchi.
- Evitare i doppi conteggi è la parte più grossa del lavoro: i dati originali della banca restano intatti, categorie e note stanno a parte, i giroconti fra i nostri conti non contano come entrate o uscite, e gli estratti delle carte si abbinano al loro addebito sul conto. La deduplicazione usa il riferimento della banca quando c’è, e tutto ciò che è ambiguo va in revisione manuale, mai in una fusione automatica.
Sul lato tecnico: Python con FastAPI e PostgreSQL, pagine lato server con HTMX invece di una single-page app, Docker, HTTPS, accesso ristretto, importi come decimali esatti e mai in virgola mobile, log che non contengono mai dati finanziari, segreti fuori dal repository, e backup cifrati con una prova di ripristino documentata.
Cosa c’è finora
Due fasi sono fatte e installate. La prima ha messo le fondamenta: accesso, permessi per utente e per conto, una pagina di amministrazione, HTTPS, backup cifrati e uno script di aggiornamento. La seconda è il registro: movimenti, import da file, categorie, saldi e ricerca.
La scelta meno ovvia è l’import. Invece di un formato fisso per ogni banca, mostro un’anteprima, scelgo quale colonna è la data, l’importo e la descrizione, e la scelta viene salvata sul conto per la volta dopo. La mia prima ipotesi sull’intestazione ha sbagliato sul primo file vero, perché la banca aveva messo qualche riga di note sopra; ora l’intestazione si riconosce anche con le note in testa. I miei dati li controllo inoltre sul Mac stampando solo struttura e conteggi, con le cifre mascherate.
Stato
Lavori in corso. Requisiti e architettura sono scritti, le fondamenta e il registro sono in uso e un primo test con una banca ha funzionato. Non ancora provati: l’invio reale delle email, il riavvio dopo il riavvio settimanale e le pagine interne su un telefono vero. Poi verrà la sincronizzazione automatica (solo quando decido di iniziarla), quindi abbinamenti e quadratura, e per ultime una revisione di sicurezza e una guida per la famiglia.
Stack
Python · FastAPI · PostgreSQL · SQLAlchemy · HTMX · Docker