HelpFinance Standard Edition: quadro chiaro del tuo denaro in un colpo d'occhio.

Introduzione

HelpFinance è un file HTML “tutto in uno” (una pagina che funziona come una mini-app) pensato per aiutarti a tenere sotto controllo soldi e abitudini in modo visivo semplice e automatico. HelpFinance AI si apre nel browser e ti permette di lavorare su più aree finanziarie: liquidità, pianificazione, bilancio mensile, riepilogo annuale, illiquidità e patrimonio netto.

A cosa serve?

HelpFinance ti aiuta a:

• capire dove vanno i tuoi soldi (entrate/uscite e saldo mensile);
• organizzare spese fisse e ricorrenti (abbonamenti, rate, bollette, ecc.);
• tenere traccia di debiti e scadenze (mutui/finanziamenti e spese da saldare);
• monitorare l’andamento nel tempo dei tuoi asset (immobili, auto, fondi, wallet, ecc.)
• avere una vista “totale” del tuo patrimonio netto (liquidità + illiquidità) - debiti.

Dati e privacy: dove vengono salvate le informazioni

Un concetto importante, spiegato in modo semplice.

Quando usi HelpFinance e premi “Salva dati”, l’app salva le tue informazioni in locale (cioè, sul tuo dispositivo), usando IndexedDB come archivio principale. Ogni copia del file può avere uno storage separato, così i salvataggi non si “mischiano” tra versioni/copioni diversi. Se IndexedDB non fosse disponibile in un contesto particolare, sarebbe previsto un fallback (soluzione di emergenza) su LocalStorage, sempre con chiavi “isolate” per copia.

In pratica: i dati restano tuoi e non vengono inviati online (l’app lavora in locale nel browser).

Com’è organizzata? (la struttura dell’app)

Nel menu laterale trovi le sezioni principali (le chiameremo “pagine” della dashboard):

• Panoramica
• Dashboard liquidità
• Pianificazione (con sottosezioni)
  • Spese ricorrenti
  • Registro spese ricorrenti
  • Mutui e Finanziamenti
  • Registro spese da saldare
  • Wallet
• Bilancio mensile
• Riepilogo annuale

Salvataggio e ripristino automatico dei dati

Questa parte spiega, in modo semplice, come HelpFinance salva i tuoi dati, come li ripristina quando riapri il file, e come eliminarli in sicurezza.

Quando premi Salva dati, l’app:

• Raccoglie tutto lo stato dell’app (cioè, i dati inseriti e le tabelle/registri) creando un “pacchetto” di salvataggio chiamato state.
• Salva questo pacchetto in locale usando il sistema di storage dell’app IndexedDB come metodo principale (fallback su LocalStorage solo se IndexedDB non fosse disponibile).
• Dopo il salvataggio, mostra un avviso: “I tuoi dati sono stati salvati correttamente.” con pulsante OK.

In pratica: se hai salvato i dati, quando riapri il file ritrovi tutto com’era.

Quando premi Elimina dati, l’app non cancella subito, prima ti chiede conferma con una finestra dedicata.

1. Premi Elimina dati
2. Si apre la finestra “Elimina dati” con il messaggio: “Vuoi eliminare tutti i dati salvati? Questa azione non è annullabile.” Scegli:
   • OK → cancella tutto e ricarica la pagina
   • Annulla → chiude la finestra e non succede nulla

Quando confermi OK, l’app:

• elimina lo stato salvato (dati principali)
• elimina anche preferenze lingua/valuta
• elimina eventuali PDF allegati salvati in IndexedDB (se presenti)
• poi fa reload della pagina

In pratica: Tutti i dati salvati vengono eliminati, l’app ritorna al suo stato iniziale.

Importa / Esporta (backup su file)

Nel menu principale c’è una sezione con due pulsanti:

• Importa
• Esporta

Esporta (crea un file di backup)

Quando premi Esporta, l’app scarica un file .json che contiene:

• lo stato salvato
• la lingua
• la valuta
• data e info export

Importa (ripristina da backup)

Quando premi Importa:

1. scegli un file .json esportato da HelpFinance
2. l’app verifica che sia valido
3. salva lo stato nello storage
4. se presenti, salva anche lingua/valuta
5. mostra un messaggio “Importazione completata” e poi ricarica la pagina

Dashboard liquidità (pagina iniziale)

Questa è la schermata che vedi subito quando apri HelpFinance: ti mostra la tua liquidità e due indicatori chiave collegati ai tuoi dati (risparmio e guadagno). La dashboard è composta da 3 card principali: Liquidità, Risparmio, Guadagno.

Obiettivo della Dashboard

Qui non “inserisci” nulla direttamente: qui leggi i risultati.

• Liquidità in tempo reale: quanto denaro liquido hai adesso (aggiornato in automatico).
• Risparmio in tempo reale: quanto risparmio stai costruendo (logica basata su una quota mensile costante).
• Guadagno in tempo reale: quanto vale il tuo tempo, trasformando il tuo “guadagno netto” in annuo/mensile/giornaliero/orario/minuto.

Se vedi “–” è normale: significa che mancano ancora dati (budget/spese/mesi chiusi/ecc).

Cosa vedi nella card “Liquidità in tempo reale”

Nella prima card trovi:

1. TOTALE SOLDI LIQUIDI
2. Valore percentuale sotto al totale
3. 3 pulsanti di periodo:
   • Mese
   • Anno
   • Totale
4. Grafico (trend della liquidità)

Come usarla (passo passo):

1. Premi Mese per vedere l’andamento nel periodo più “ravvicinato”. (ultimi 30 giorni)
2. Premi Anno per una vista più ampia. (ultimi 12 mesi)
3. Premi Totale per la vista “da quando usi il file”. (totale da quando usi il file)
4. Leggi Valore percentuale + guarda il grafico: se il grafico sale e il valore percentuale è positivo, stai migliorando la liquidità; se scende, stai consumando liquidità.

Cosa vedi nella card “Risparmio netto in tempo reale”

Questa card ti dà un indicatore sintetico sul risparmio.

Elementi principali:

1. Risparmio annuo
   Nota importante: nel file questo valore viene trattato come cumulativo (non “si azzera” semplicemente a ogni anno), perché somma i valori disponibili fino all’ultimo anno con dati.
2. 2 righe di confronto in valore percentuale:
   • rispetto al mese precedente (confronta l’ultimo mese “chiuso” con il precedente). Se non ci sono mesi chiusi con dati, resta neutro.
   • rispetto all’anno precedente (confronta l’ultimo anno “chiuso” con il precedente). Se non ci sono anni chiusi con dati, resta neutro.
3. Pulsante ⟳ (in alto a destra)
   • Apre un overlay dedicato: “Dettaglio risparmio per anno” (con pulsante “X” per chiudere la pagina)

Come usarla (passo passo):

1. Guarda Risparmio annuo: è il tuo “risparmio costruito” secondo i dati disponibili.
2. Leggi il valore percentuale “rispetto mese precedente”: ti dice se stai migliorando rispetto al mese precedente (serve avere mesi chiusi con dati).
3. Leggi il valore percentuale “rispetto anno precedente”: ti dice se stai migliorando rispetto all’anno precedente (serve avere anni chiusi con dati).
4. Premi ⟳ per aprire il dettaglio per anno e capire come si distribuisce nel tempo.

Cosa vedi nella card “Guadagno in tempo reale”

Qui la dashboard trasforma il tuo guadagno netto in “scala tempo”.

Valori mostrati:

1. Guadagno netto annuo (con valore percentuale rispetto all’anno precedente)
2. Guadagno netto mensile (con valore percentuale rispetto al mese precedente)
3. Guadagno netto giornaliero
4. Guadagno netto orario
5. Guadagno netto al minuto

Pulsante ⟳ (storico):

• Apre un overlay dedicato “Storico guadagno netto annuo” (con pulsante “X” per chiudere la pagina)

Come usarla (passo passo):

1. Parti dal valore annuo: è la base (è il tuo guadagno annuo secondo i dati disponibili). Il valore percentuale “rispetto anno precedente” ti dice se stai guadagnando di più rispetto all’anno precedente.
2. Scendi su mensile → giornaliero → orario → minuto: serve per capire “quanto vale” il tuo tempo. Il valore percentuale “rispetto mese precedente” ti dice se stai guadagnando di più rispetto al mese precedente.
3. Premi ⟳ per vedere lo storico annuo.

Pianificazione

Questa pagina è la tua cabina di pilotaggio: qui imposti il tuo punto di partenza (capitale iniziale) e distribuisci il budget mensile nelle categorie principali. Da qui derivano anche aggiornamenti importanti per Dashboard (Risparmio/Guadagno) e per la coerenza dei calcoli.

Capitale iniziale: cos’è e perché è fondamentale

Nella parte alta trovi la card “Capitale iniziale” con:

• input Capitale iniziale
• pulsante Conferma capitale iniziale
• testo: “verrà usato nel bilancio mensile e nella Dashboard.”

Step-by-Step

1. Inserisci il valore che rappresenta i tuoi soldi liquidi di partenza (es. 5000).
2. Clicca Conferma capitale iniziale.
3. L’app ti mostra una conferma: ti avvisa che dopo la conferma non potrai più modificarlo direttamente.
4. Premi OK per procedere, oppure Annulla se vuoi tornare indietro.

Regola semplice: conferma questo valore appena inizi, perché diventa la “base” del tuo percorso e viene usato nei calcoli.

Nota importante: Se non imposti il capitale iniziale l’app rimane bloccata. Per poter utilizzare l’app il primo passaggio da eseguire è impostare e confermare il capitale iniziale.

Pianificazione di spesa del mese: budget e categorie

Subito sotto trovi la card “Pianificazione di spesa del mese” con:

• Budget totale mensile
• le categorie principali, ognuna con il suo input numerico:
  • Casa
  • Cibo
  • Trasporti
  • Imprevisti
  • Svago
  • Risparmio
• In basso ci sono due risultati automatici:
  • Totale pianificato
  • Margine residuo
• E un pulsante:
  • Aggiorna pianificazione

Step-by-step (metodo pratico)

1. Inserisci il tuo Budget totale mensile (es. 2000).
2. Distribuisci il budget nelle categorie (anche con numeri “provvisori”).
3. Premi Aggiorna pianificazione.
4. Leggi subito:
   • Totale pianificato = somma delle categorie
   • Margine residuo = budget totale − totale pianificato

Mini-check rapido (se qualcosa “non torna”)

• Margine residuo negativo → hai pianificato più del budget totale (riduci categorie o aumenta budget).
• Dashboard non cambia → verifica di aver premuto Aggiorna pianificazione.
• Vuoi un risparmio “reale” più alto → aumenta la voce Risparmio nella pianificazione.

Spese ricorrenti

Questa pagina serve per gestire tutte le spese che si ripetono (mensili o periodiche), ad esempio:

• affitto / mutuo
• abbonamenti (telefono, streaming, palestra)
• assicurazioni
• rate fisse
• servizi ricorrenti (bollette se le tratti come “stima”)

L’obiettivo è avere una lista ordinata delle spese “che tornano sempre”, così non te le dimentichi e puoi pianificare meglio.

Come entrare nella pagina

1. Vai su Pianificazione (▾)
2. Clicca il pulsante (▾)
3. Clicca Spese ricorrenti

Come utilizzare la pagina

In genere, la pagina è composta da:

• una parte per aggiungere una nuova spesa ricorrente
• una tabella/lista con le spese già inserite
• azioni rapide (es. conferma “✓”, rimozione “X”, ecc)

Step-by-Step: aggiungere una spesa ricorrente

Step 1 — Crea una nuova riga / nuova spesa
Clicca sul pulsante “+ Aggiungi spesa” (di solito es. “+ Aggiungi spesa Casa” ecc)

Step 2 — Compila i campi principali
Inserisci almeno queste informazioni (in modo pratico e veloce):

• Nome / Descrizione della spesa (es. “Netflix”, “Affitto”, “Assicurazione auto”)
• Categoria (coerente con la tua pianificazione: Casa, Cibo, Trasporti, Svago, Imprevisti, ecc.)
• Importo

Regola semplice: scrivi descrizioni corte e chiare. “Affitto casa”, “Spotify”, “Telefono”.

Step 3 — Conferma / Salva la riga
Premi il pulsante di conferma “✓”

Dopo la conferma:

• la spesa entra nella lista
• può risultare “bloccata” (cioè, non editabile) finché non clicchi il pulsante elimina “X” e ripeti nuovamente l’operazione

Step-by-Step: correggere una spesa

Se hai sbagliato importo o descrizione:

1. usa l’azione Elimina (pulsante “x”)
2. aggiorna i dati
3. conferma di nuovo

Step-by-Step: eliminare una spesa ricorrente

1. trova la riga nella lista
2. clicca l’icona di rimozione (spesso ✕ o cestino)
3. la riga scompare e i totali (se presenti) si aggiornano

Come usare “Spese ricorrenti” in modo intelligente

Metodo consigliato (semplice e potente)

• Inserisci qui solo le spese che si ripetono davvero.
• Tutte le spese variabili (es. ristorante, extra) gestiscile nel Bilancio mensile.

Così:

• questa pagina resta pulita (pochi elementi, sempre utili)
• il Bilancio mensile resta lo strumento operativo per il giorno per giorno

Registro spese ricorrenti

Questa pagina è il tuo archivio di controllo: qui consulti in modo ordinato tutte le spese ricorrenti che hai inserito, così puoi:

• verificare che nulla sia stato dimenticato,
• monitorare l’andamento del prezzo nel tempo,
• rivedere importi e categorie,
• controllare cosa è ancora attivo,
• mantenere la lista pulita (correzioni/eliminazioni).

Come entrare nella pagina

1. Pianificazione → clicca il pulsante (▾)
2. Clicca Registro spese ricorrenti

Step-by-Step: come usare il Registro spese ricorrenti

Step 1 — Clicca il pulsante “+ Aggiungi nuova tabella spesa ricorrente”
Step 2 — Denomina la tabella e clicca il pulsante “Conferma”
Step 3 — Clicca sulla tabella appena generata per poter inserire tutti i dati
Step 4 — Clicca il pulsante “+ Aggiungi riga” per generare una nuova riga, compila i campi desiderati
Step 5 — Clicca il pulsante di conferma con icona “✓” per registrare l’operazione eseguita
Step 6 — Monitora l’andamento della tabella nel tempo

Mutui e Finanziamenti

Questa pagina serve per tenere sotto controllo impegni a rate (mutui, prestiti, finanziamenti) in modo chiaro, senza doverli ricordare “a mente”.

L’obiettivo è semplice:

• sapere quanto paghi di rata
• capire quanto ti resta
• non perdere di vista scadenze e impegni fissi

Come entrare nella pagina

1. Pianificazione clicca il pulsante (▾)
2. Clicca Mutui e Finanziamenti

Cosa trovi dentro

Questa pagina è composta da:

1. Area inserimento: dove aggiungi un nuovo mutuo/finanziamento
2. Lista/Tabella: dove vedi tutti i finanziamenti già inseriti
3. Azioni: conferma “✓”; elimina “x”

Step-by-Step: aggiungere un mutuo/finanziamento

Step 1 — Aggiungi una nuova voce
Clicca il pulsante per aggiungere (di solito un “+” o “Aggiungi finanziamento”).

Step 2 — Compila i dati essenziali
Inserisci almeno questi dati (sono quelli che rendono davvero utile la pagina):

• Importo (importo sottoscritto da contratto)
• Rata (quanto paghi ogni mese)
• Anni (anni totali)
• Totale con interessi (non compilabile)
• Scadenza rata (giorno/mese/anno)
• Scadenza contratto (giorno/mese/anno)
• Note (facoltative: banca, numero pratica, ecc.)
• PDF (inserimento facoltativo del contratto sottoscritto, per maggiore controllo)

Step 3 — Conferma
Premi il pulsante di conferma (✓).
Dopo la conferma, la voce appare nella lista.

Registro spese da saldare

Questa pagina serve per gestire spese “in sospeso”: cioè, importi che devi ancora pagare (o che vuoi tenere sotto controllo finché non risultano saldati).

Esempi tipici:

• fatture da pagare
• rate “una tantum” non ricorrenti
• spese impreviste rimandate
• conguagli / scadenze future

L’obiettivo è semplice:

Sapere cosa devi pagare, quanto, e quando — e poterlo segnare come “pagato” senza perdere il controllo.

Come entrare nella pagina

1. Pianificazione clicca il pulsante (▾)
2. Clicca Registro spese da saldare

Step-by-Step: aggiungere una spesa da saldare

Step 1 — Aggiungi una nuova voce
Clicca il pulsante per aggiungere una nuova spesa (di solito “+” / “Aggiungi”).

Step 2 — Compila i campi essenziali
Inserisci almeno:

• Denominazione spesa (es. “Fattura commercialista”, “Riparazione auto”)
• Data di scadenza (se presente: è utilissima per priorità)
• Importo
• Fattura PDF (per inserire la fattura, facoltativo)

Regola semplice: descrizione breve + importo corretto + scadenza. È il trio che ti evita dimenticanze.

Step 3 — Conferma
Premi il pulsante di conferma (✓).
Da qui in poi la spesa viene registrata.

Step 4 — Spesa pagata
Una volta che la spesa è stata saldata cliccare il pulsante “x” per eliminare la spesa.

Wallet

La pagina Wallet serve per organizzare la tua liquidità in “contenitori” separati, ad esempio:

• Conto corrente
• Carta
• Contanti
• Risparmi dedicati (es. “Fondo emergenza”)

Obiettivo pratico:

Vedere dove hai i soldi e quanto hai in ogni “contenitore”, senza confondere tutto in un unico numero.

Pensa al Wallet come a una “mappa” della tua liquidità:

• Bilancio mensile = cosa entra/esce (movimenti reali)
• Wallet = dove stanno i soldi (distribuzione per conto/carta/contanti)

Quindi: il Wallet non serve a registrare ogni singolo movimento “dettagliato”, ma a tenere sotto controllo i saldi per contenitore.

Come entrare nella pagina

1. Pianificazione clicca il pulsante (▾)
2. Clicca Wallet

Step-by-Step: creare un nuovo “wallet” (un contenitore)

Step 1 — Aggiungi un wallet
Clicca il pulsante per aggiungere (“+ Aggiungi nuovo wallet”).

Step 2 — Inserisci i dati minimi
Compila almeno:

• Nome wallet (es. “Viaggi”, “Carta Prepagata”, “Contanti”)
• Le varie righe

Regola d’oro: usa nomi semplici e riconoscibili in 1 secondo.

Step 3 — Conferma
Premi il pulsante di conferma (✓).
Il wallet deve comparire nella lista/tabella.

Step 4 — Entra nel Wallet
Clicca sulla tabella appena generata per poter inserire tutti i dati.

Step 5 — Compila il Wallet
Clicca il pulsante “+ Aggiungi riga” per generare una nuova riga, compila i campi desiderati.

Step 6 — Conferma la registrazione
Clicca il pulsante di conferma con icona “✓” per registrare l’operazione eseguita.

Bilancio mensile

Questa è la pagina più importante perché è quella che alimenta i numeri della Dashboard Liquidità: inserendo i movimenti, l’app calcola automaticamente entrate, uscite, saldo mensile e liquidità aggiornata.

Cosa vedi nella parte alta (mini-riquadri)

In alto trovi la riga “Mese corrente” (es. Gennaio – 1° anno) e sotto 5 mini-riquadri:

1. Capitale iniziale
2. Entrate mensili
3. Uscite mensili
4. Saldo mensile
5. Capitale aggiornato

A cosa serve la riga “Mese corrente”

Questa etichetta viene aggiornata automaticamente con mese + numero anno (1°, 2°, 3°…) e si adatta alla lingua selezionata.

Regola fondamentale: come inserire Entrate e Uscite

Nella tabella movimenti vale questa regola:

• Entrata → inserisci un importo positivo (es. 1500)
• Uscita → inserisci un importo negativo (es. -50)

L’app usa il segno (–) per calcolare il valore negativo tutto in automatico.

Tabella “Movimenti del mese”: come funziona

La tabella ha 4 colonne + azioni:

• Mese (mostrato automaticamente)
• Categoria di spesa (campo testo)
• Descrizione (campo testo)
• Importo (numero)
• Azioni: ✓ conferma e ✕ rimuovi

Step-by-step: aggiungere un movimento

1. Clicca “+ Aggiungi movimento”.
2. Compila la riga:
   • Categoria (es. “Stipendio”, “Affitto” …)
   • Descrizione
   • Importo (positivo o negativo)
3. Premi ✓ per “registrare” la riga.
   • Dopo la conferma:
     • la riga non è più modificabile (campi bloccati)
     • l’importo viene mostrato formattato in valuta
     • l’input numerico viene nascosto
     • il pulsante ✓ scompare
4. Se vuoi eliminare una riga, usa ✕: la riga viene rimossa e i totali si aggiornano subito.

Nota importante: il pulsante ✓ può risultare disabilitato finché non confermi il capitale iniziale (è una protezione: prima si definisce la base, poi si registrano i movimenti).

Riepilogo annuale

Questa pagina ti fa vedere come cambiano entrate, uscite e risparmio nel tempo, usando:

1. un grafico (andamento cumulativo)
2. una tabella “Dettaglio per anno” (con possibilità di vedere anche i dettagli mese per mese)

Cosa vedi nella pagina

Appena entri in Riepilogo annuale, trovi:

• Titolo: Riepilogo annuale
• Badge: Andamento per anno
• Testo guida: “Qui vedi come entrate, uscite e risparmio cambiano anno dopo anno.”
• 3 pulsanti (timeframe): Mese / Anno / Totale
• Un grafico per monitorare l’andamento
• Una tabella con colonne Anno / Entrate / Uscite / Risparmio

I pulsanti “Mese / Anno / Totale”

Questi pulsanti cambiano come viene costruito il grafico.

A) Pulsante “Mese”
Mostra gli ultimi 30 movimenti di risparmio (non è il calendario del mese: sono “operazioni” registrate dagli ultimi movimenti).
Serve per vedere l’andamento ravvicinato del risparmio, come se fosse un mini‑tracciato degli ultimi movimenti.

B) Pulsante “Anno”
Mostra gli ultimi 12 mesi chiusi (quindi funziona bene quando hai già chiuso almeno alcuni mesi).
Se non hai ancora chiuso mesi, il grafico può risultare vuoto (perché non ci sono mesi).

C) Pulsante “Totale”
Mostra l’andamento per anni, come cumulativo: somma il risparmio anno dopo anno e lo disegna come crescita nel tempo.

Il grafico “Risparmio”

Il grafico è creato con una linea (senza riempimento) per monitorare l’andamento del denaro nel tempo.

Regola di lettura semplice:

• Se la linea sale → stai accumulando risparmio nel tempo.
• Se scende/oscilla → stai avendo mesi/anni con risparmio più basso (o negativo), quindi il cumulato cresce più lentamente o può scendere (dipende dai valori inseriti).

Tabella “Dettaglio per anno”

Nella tabella vedi una riga per ogni anno utilizzato (es. 1° anno, 2° anno, ecc.), con:

• Anno
• Entrate (somma entrate chiuse in quell’anno)
• Uscite (somma uscite chiuse in quell’anno)
• Risparmio (di base: Entrate − Uscite)

Nota: la tabella una volta che viene popolata si aggiorna automaticamente quando chiudi un mese.

Storico mese dentro la tabella

Ogni riga “Anno” ha un pulsante ⟳ con titolo “Mostra storico mesi”.

Step-by-step

1. Nella tabella, individua l’anno (es. “1° anno”).
2. Premi ⟳ oppure clicca direttamente sulla riga dell’anno.
3. Sotto a quella riga compariranno 12 righe (Gennaio…Dicembre) con una freccia “↳” davanti al mese.
4. Premi di nuovo ⟳ (o riclicca la riga) per richiuderle (toggle).

Cosa mostrano le righe mensili

• Entrate del mese
• Uscite del mese
• Risparmio / Saldo del mese

Quando si aggiornano grafico e tabella (regola chiave)

Grafico e tabella diventano davvero “ricchi” quando usi il pulsante Chiudi mese nel bilancio mensile.

Quando chiudi il mese, l’app:

• salva i dati mensili nello storico (entrateMensili / usciteMensili / risparmioMensili)
• aggiorna i totali annui (entrateAnnue / usciteAnnue / risparmioAnnue)
• tabella e grafico restano sempre aggiornati