# 💰 ContabilitàFamily

Guida rapida all'utilizzo

## 🚀 Come avviare il programma

Scegli in base alla tua situazione:

### ▶ Primo avvio (Python non installato)

1

Fai doppio clic su `setup.bat`
Scarica Python portatile e installa tutto automaticamente.
Richiede internet solo questa volta (~30 MB).

2

Al termine clicca `avvia.bat` per aprire l'app.

✅ Python viene salvato nella cartella del programma — non tocca il resto del PC.

### ▶ Avvio normale (da adesso in poi)

1

Fai doppio clic su `avvia.bat` — l'app si apre in pochi secondi.

2

### Per chiudere

Chiudi la finestra dell'app. La finestra nera si chiude da sola.

## 🗺️ Le sezioni del programma

Sezione | A cosa serve
--- | ---
📊 Dashboard | Riepilogo del mese: entrate, uscite, saldo, grafico tendenza e top spese
📅 Calendario | Visualizza le transazioni giorno per giorno su un calendario
💳 Transazioni | Elenco completo con filtri, ricerca, esportazione CSV/Excel
🔁 Ricorrenti | Gestisce spese/entrate che si ripetono (affitto, stipendio, abbonamenti…)
🏷️ Categorie | Crea e modifica le categorie, imposta budget mensili
🎯 Budget | Controlla quanto hai speso rispetto al budget per ogni categoria
⭐ Obiettivi | Tieni traccia dei risparmi verso un traguardo (vacanza, auto…)
📈 Report | Analisi annuale, tendenze, confronto anno su anno, top spese
⚙️ Impostazioni | Backup e ripristino dei dati

## ➕ Aggiungere una transazione

Clicca il pulsante `+ Aggiungi` in alto a destra in qualsiasi pagina.

1. Scegli Entrata o Uscita
2. Inserisci data e importo
3. Scrivi una descrizione (oppure usa il 🎤 per dettarla a voce)
4. Seleziona la categoria (opzionale)
5. Aggiungi tag liberi per raggruppare le spese (es. vacanza, auto)
6. Allega uno scontrino o foto (opzionale)
7. Clicca Salva

✅ Puoi modificare o eliminare qualsiasi transazione cliccando le icone ✏️ 🗑️ nella tabella.

## 🔁 Transazioni ricorrenti

Usa questa sezione per affitto, stipendio, abbonamenti — tutto ciò che si ripete.

1. Vai in Ricorrenti → clicca `+ Nuova`
2. Imposta frequenza: settimanale, bisettimanale, mensile, annuale
3. Imposta il giorno del mese in cui avviene

Quando arriva la data, sulla Dashboard apparirà un avviso giallo.
Clicca `Genera transazioni` per registrarle tutte con un clic.

## 🎯 Budget mensile

Puoi assegnare un budget mensile a ogni categoria di uscita.

1. Vai in Categorie → modifica una categoria → imposta il budget mensile
2. Nella sezione Budget vedrai lo stato di ogni categoria:

🟢 OK spesa entro il budget 🟡 Attenzione oltre il 70% 🔴 Sforato budget superato

## 💾 Backup e ripristino

### Fare un backup

1. Vai in Impostazioni
2. Clicca `⬇ Scarica backup`
3. Scegli dove salvare il file `.zip` (es. OneDrive, chiavetta USB)

✅ Il backup contiene tutto: transazioni, categorie, obiettivi e scontrini allegati.

### Ripristinare su un nuovo PC

1. Installa Python e copia la cartella del programma sul nuovo PC
2. Avvia con `avvia.bat`
3. Vai in Impostazioni → sezione Ripristina dati
4. Seleziona il file `.zip` del backup e clicca `↺ Ripristina`

⚠️ Il ripristino sovrascrive tutti i dati presenti. Fai prima un backup se necessario.

## 📤 Esportare i dati

Dalla sezione Transazioni, clicca il pulsante `Esporta ▾`:

- CSV — file di testo compatibile con Excel, Google Sheets ecc.
- Excel (.xlsx) — foglio con colori e formattazione pronta

Puoi esportare il mese corrente o tutte le transazioni.

ContabilitàFamily — gestione economica famigliare