# MoneyMind

**MoneyMind** è un'applicazione web moderna per la gestione finanziaria personale, progettata per aiutarti a prendere il controllo delle tue finanze con strumenti potenti e intuitivi.

## 🎯 Scopo del Progetto

MoneyMind nasce dall'esigenza di fornire uno strumento completo e accessibile per la gestione finanziaria personale. L'obiettivo è semplificare il monitoraggio delle spese, la pianificazione dei budget, il raggiungimento degli obiettivi finanziari e fornire analisi approfondite per prendere decisioni informate.

## 🛠️ Tecnologie Utilizzate

- **Frontend**: Next.js 15 con React 19 e TypeScript
- **Styling**: Tailwind CSS con componenti shadcn/ui
- **Database**: PostgreSQL con Drizzle ORM
- **Autenticazione**: Better Auth con Google OAuth
- **Visualizzazioni**: Recharts per grafici interattivi
- **Form Handling**: React Hook Form con Zod validation
- **Hosting**: Vercel (consigliato)

## 📋 Requisiti Minimi

### Software Necessario
- **Node.js**: Versione 18.0 o superiore
- **Git**: Per clonare il repository
- **PostgreSQL**: Database locale o servizio hosted (Vercel Postgres consigliato)

### Hardware Consigliato
- Processore: Dual-core 2GHz o superiore
- RAM: 4GB minimum, 8GB consigliati
- Spazio disco: 1GB per l'installazione

## ✨ Caratteristiche Principali

### 💰 Gestione Transazioni
- Aggiungi, modifica ed elimina transazioni finanziarie
- Categorizzazione automatica e manuale delle spese
- Supporto per transazioni ricorrenti
- Importazione da file Excel/CSV (in sviluppo)

### 📊 Analisi e Report
- Dashboard interattiva con grafici in tempo reale
- Analisi delle tendenze di spesa
- Report mensili e annuali
- Insight finanziari basati sui dati

### 🎯 Pianificazione Budget
- Imposta limiti di budget per categorie
- Monitoraggio in tempo reale delle spese
- Notifiche per avvicinamento ai limiti
- Analisi delle deviazioni dal budget

### 🏦 Gestione Conti
- Gestione di conti correnti, carte di credito e investimenti
- Saldo in tempo reale
- Transferimenti tra conti
- Cronologia delle transazioni per conto

### 📈 Tracciamento Obiettivi
- Definisci obiettivi finanziari personali
- Monitoraggio dei progressi
- Grafici di avanzamento
- Notifiche per traguardi raggiunti

## 🔐 Sicurezza e Privacy

- Autenticazione sicura con Google OAuth
- Dati finanziari criptati nel database
- Nessuna condivisione di dati con terze parti
- Controllo completo sui propri dati

## 🚀 Benefici dell'Utilizzo

### Per Utenti Privati
- **Controllo**: Visione chiara e completa delle proprie finanze
- **Consapevolezza**: Capire dove vanno i soldi ogni mese
- **Pianificazione**: Prepararsi per spese future e obiettivi
- **Risparmio**: Identificare aree dove si può risparmiare

### Per Famiglie
- **Budget Familiare**: Gestire le finanze familiari in modo collaborativo
- **Obiettivi Comuni**: Pianificare acquisti importanti insieme
- **Trasparenza**: Tutti i membri possono vedere lo stato finanziario

### Per Professionisti
- **Organizzazione**: Separare finanze personali da professionali
- **Reportistica**: Avere dati chiari per la dichiarazione dei redditi
- **Pianificazione**: Preparare investimenti e spese future

## 📱 Accessibilità

- **Design Responsive**: Funziona perfettamente su desktop, tablet e smartphone
- **Interfaccia Intuitiva**: Facile da usare anche per chi non è esperto di finanza
- **Navigazione Semplice**: Struttura chiara e logica per trovare rapidamente le funzioni

## 🛠️ Installazione Rapida

### 1. Clona il Repository
```bash
git clone https://gitea.rosmoscato.xyz/ros/moneymind
cd moneymind
```

### 2. Installa le Dipendenze
```bash
npm install
```

### 3. Configura l'Ambiente
```bash
cp env.example .env
# Modifica il file .env con le tue configurazioni
```

### 4. Configura il Database
```bash
npm run db:generate
npm run db:migrate
```

### 5. Avvia l'Applicazione
```bash
npm run dev
```

Visita `http://localhost:3000` per iniziare a usare MoneyMind.

## 📊 Statistiche del Progetto

- **Linguaggio**: TypeScript
- **Framework**: Next.js 15
- **Database**: PostgreSQL
- **Componenti UI**: 15+ componenti riutilizzabili
- **API Endpoints**: 10+ endpoint RESTful
- **Tabelle Database**: 7 tabelle relazionali

## 🔄 Sviluppo Futuro

### Funzionalità in Arrivo
- Importazione/esportazione dati da Excel/CSV
- Notifiche push per budget e obiettivi
- Report PDF esportabili
- Integrazione con servizi bancari
- App mobile nativa
- Multi-valuta e supporto internazionale

### Contributi
Il progetto è open source e accetta contributi dalla community. Se vuoi contribuire:

1. Fai un fork del repository
2. Crea un branch per la tua feature
3. Fai commit delle tue modifiche
4. Apri una pull request

## 📧 Contatti

**Autore**: Rosario Moscato  
**Email**: [rosario.moscato@etik.com](mailto:rosario.moscato@etik.com)  
**Repository**: [https://gitea.rosmoscato.xyz/ros/moneymind](https://gitea.rosmoscato.xyz/ros/moneymind)

## 📄 Licenza

Questo progetto è rilasciato sotto licenza MIT. Sentiti libero di usarlo, modificarlo e distribuirlo secondo i termini della licenza.

## 🙏 Supporto

Se trovi utile questo progetto e vuoi supportare lo sviluppo, puoi offrirmi un caffè!

### 📱 Donazione con Wise

Clicca sul link qui sotto per inviare una donazione tramite Wise:

[Donate with Wise](https://wise.com/pay/me/rosariom493)

### ☕ Alternative

Puoi anche supportarmi tramite PayPal:

[Buy Me a Coffee](https://paypal.me/rosmoscato)

Il tuo supporto aiuta a mantenere e migliorare MoneyMind per tutta la community.

---

**Inizia oggi stesso a prendere controllo delle tue finanze con MoneyMind! 💰🚀**