← Tutti i progetti
In corso novembre 2026

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.

PythonFastAPIPostgreSQLDockerOpen BankingSelf-hosted

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:

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