Introduzione: cos’è HelpRate AI e a cosa serve?

HelpRate AI è un’app “tutto-in-uno” per gestire rate, indebitamento e capacità di nuove rate in modo chiaro e immediato. L’obiettivo è aiutarti a capire:

• quante rate mensili stai pagando (mutui/finanziamenti)
• quante entrate mensili hai (lavoro + redditi da locazioni + entrate ricorrenti)
• il tuo DTI (Debt-to-Income), cioè il rapporto tra rate e reddito
• quanta capacità residua hai per sostenere una nuova rata, rispettando un limite prudenziale (max 33%)

L’app è progettata per funzionare in locale, senza dover “scorrere” o fare calcoli manuali: i riepiloghi si aggiornano automaticamente dopo ogni inserimento.

Overplay iniziale: scelta lingua e valuta

Alla prima apertura (oppure dopo un reset completo), l’app mostra un overlay (schermata sopra l’app) in cui scegli:

• Language (lingua dell’interfaccia)
• Currency (valuta principale: EUR, USD, GBP, ecc.)

Poi premi Continue per entrare nell’app.

Quando compare l’overlay?

Compare solo se non esistono dati salvati. Se l’app rileva uno stato salvato, l’overlay non appare e l’app entra direttamente nella dashboard.

Come lo faccio ricomparire?

Usa l’azione ELIMINA DATI (vedi sezione “Salvataggio dati / Reset”). Questa operazione resetta anche lingua e valuta e mostra di nuovo l’overlay.

Dove vengono salvati i tuoi dati?

I tuoi dati vengono salvati principalmente su IndexedDB; in caso di problemi, o dove IndexedDB sia danneggiato o non presente, viene eseguito un fallback su LocalStorage, così i tuoi dati sono sempre salvati ed aggiornati correttamente.

• Primario: IndexedDB (persistenza più robusta del browser)
• Fallback: LocalStorage (copia di sicurezza)

All’avvio, l’app fa una “sincronizzazione” per ripristinare in LocalStorage ciò che è in IndexedDB, così l’interfaccia riparte coerente.

Nota Importante: L'app HelpRate AI lavora in locale sul tuo browser: tutti i tuoi dati e salvataggi rimangono tuoi, non vengono inviati online, a me o a terze parti, nel rispetto dei tuoi dati e della tua privacy.

"SALVA DATI" e "ELIMINA DATI"

In alto a destra (header) trovi due azioni principali:

SALVA DATI

I dati sono già salvati automaticamente: questo pulsante forza una riscrittura dello stato corrente e mostra un messaggio di conferma.

Quando usarlo (consigliato):

• dopo una lunga sessione di inserimento dati
• prima di esportare il file (per sicurezza)

ELIMINA DATI

Cancella tutti i dati dell’app dopo la conferma (scelta non consigliata), inclusi:

• dati di pianificazione, rate, entrate
• strategia AI
• lingua e valuta (torna allo stato iniziale e riappare l’overlay)

Quando usarlo:

• se vuoi ripartire da zero
• se stai usando l’app per un altro scenario (es. altro progetto)

Importa ed Esporta (backup dati)

Nella sidebar trovi due pulsanti:

• Importa (carica un file .json)
• Esporta (scarica un backup .json)

Sono pensati per fare backup e ripristino in modo semplice.

Esporta

Quando premi Esporta, l’app genera un file chiamato:

helprate_ai_backup.json

Contiene:

• nome app
• versione
• data/ora export
• tutti i dati
• strategia AI selezionata

Importa

Quando premi Importa, selezioni un file JSON dal dispositivo. L’app:

• legge il file
• valida che sia un JSON leggibile (se non lo è, mostra errore)
• importa i dati (accetta sia un JSON “wrapper” con data: {...} sia un oggetto stato “grezzo”)
• importa anche la strategia AI se presente e valida (snowball/avalanche)
• aggiorna tutte le pagine e mostra conferma

Attenzione: l’importazione sostituisce lo stato seguente con quello importato.

Com' è organizzata l’app

La sidebar contiene le pagine principali:

• Dashboard
• Pianificazione (voce con sottomenu)
• Reddito Locazioni
• Reddito Entrate Ricorrenti
• Mutui e Finanziamenti
• Consigli Intelligenti AI
• Guida

Il sottomenu “Pianificazione” si apre/chiude e l’app gestisce anche la posizione dei pulsanti Importa/Esporta.

Dashboard

La Dashboard è la schermata “di controllo” che si aggiorna automaticamente con i dati inseriti nelle altre sezioni.

Cosa mostra

Entrate nette mensili totali (effettive)

Calcolate come:

• Reddito mensile inserito in Pianificazione (lavoro)
• 70% delle entrate da locazioni
• 70% delle entrate ricorrenti

Il -30% è un fattore prudenziale, utilizzato dalle banche per erogare il credito

Totale rate mensili attive

Somma delle rate mensili di tutti i finanziamenti inseriti

Capacità per nuova rata (Max 33%)

Calcolo:

(33% delle entrate effettive) − (rate totali)

Se il risultato è negativo, l’app mostra 0 (nessuna capacità residua)

DTI (Debt-to-Income)

Percentuale: (rate totali / entrate effettive) × 100

Interpretazione DTI (stati e messaggi)

L’app evidenzia automaticamente lo stato:

• DTI ≤ 30% → “Sostenibile e Sicuro” (verde)
• 30% < DTI ≤ 40% → “Attenzione (Soglia Limite)” (arancione)
• DTI > 40% → “Rischio Sovraindebitamento” (rosso)

Se la dashboard sembra “vuota”

È normale se non hai ancora compilato:

• Pianificazione (reddito)
• Mutui/Finanziamenti (rate)

Pianificazione

Questa pagina è il “motore” dell’analisi: qui inserisci il reddito mensile e visualizzi i riepiloghi calcolati.

Cosa inserire

• Entrata mensile netta totale (lavoro) → è il reddito base con cui vuoi fare i calcoli

Cosa mostra automaticamente

• Entrate mensili da Reddito Locazioni (-30%): Somma dei canoni mensili inseriti nella pagina “Reddito Locazioni”, considerati al 70%
• Entrate mensili da Entrate Ricorrenti (-30%): Somma delle entrate ricorrenti mensili, considerate al 70%
• Rate mensili totali Mutui/Finanziamenti: Somma delle rate mensili inserite nella pagina “Mutui e Finanziamenti”
• DTI stimato + stato (verde/arancione/rosso) e messaggio dinamico
• Capacità di nuova rata (Max 33%) (margine prudenziale)

Reddito Locazioni

Qui registri entrate da affitti (o locazioni in generale) che generano un reddito a lungo termine.

Come aggiungere una locazione

• Premi il pulsante Aggiungi Locazione
• Compare una riga di inserimento nella tabella
• Compila:
  • Nome (es. “Bilocale centro”)
  • Canone mensile
  • Data inizio
  • Data fine
• Premi ✓ Conferma per salvare, oppure ✕ Annulla per chiudere senza salvare

Come eliminare una locazione

Premi la ✕ Elimina sulla riga salvata: viene rimossa e l’analisi si aggiorna subito

Nota sul calcolo annuale

L’app mostra anche l’annuale come mensile × 12.

Reddito Entrate Ricorrenti

Questa pagina serve per entrate mensili ripetitive (es. collaborazione fissa, rendite, abbonamenti che incassi, ecc.).

Come aggiungere un’entrata ricorrente

Il flusso è identico alle locazioni, clicca il pulsante Aggiungi Entrata Ricorrente.

Si genera la nuova riga, compila:

• Nome
• Entrata mensile
• Data inizio
• Data fine
• Conferma (✓) o annulla (✕)

Se non inserisci nulla, l’app segnala che non ci sono entrate ricorrenti.

Come eliminare un'entrata ricorrente

Premi la ✕ Elimina sulla riga salvata: viene rimossa e l’analisi si aggiorna subito

Nota sul calcolo annuale

L’app mostra anche l’annuale come mensile × 12.

Mutui e Finanziamenti

Qui registri tutti i finanziamenti attivi (mutuo, prestito auto, cessione del quinto, ecc.).

Come aggiungere un finanziamento

• Premi Aggiungi prestito/finanziamento

Compare una riga di input, compila i campi:

• Nome
• Importo richiesto
• Rata mensile
• Durata (numero rate totali es. 120 rate)
• TAN (tasso nominale)
• TAEG (tasso annuo effettivo globale / APR)
• Data inizio / Data fine

Premi ✓ Conferma per salvare oppure ✕ Annulla

Eliminare un finanziamento

Premi ✕ Elimina sulla riga: viene eliminata e tutti i riepiloghi si aggiornano in automatico.