e5b019b855
- Rimosso riferimento all'immagine del codice QR - Aggiunto link diretto Wise: https://wise.com/pay/me/rosariom493 - Semplificata la sezione di supporto per migliore accessibilità - Rimosso file immagine QR non più necessario 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
5.5 KiB
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
git clone https://gitea.rosmoscato.xyz/ros/moneymind
cd moneymind
2. Installa le Dipendenze
npm install
3. Configura l'Ambiente
cp env.example .env
# Modifica il file .env con le tue configurazioni
4. Configura il Database
npm run db:generate
npm run db:migrate
5. Avvia l'Applicazione
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:
- Fai un fork del repository
- Crea un branch per la tua feature
- Fai commit delle tue modifiche
- Apri una pull request
📧 Contatti
Autore: Rosario Moscato
Email: rosario.moscato@etik.com
Repository: 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:
☕ Alternative
Puoi anche supportarmi tramite PayPal:
Il tuo supporto aiuta a mantenere e migliorare MoneyMind per tutta la community.
Inizia oggi stesso a prendere controllo delle tue finanze con MoneyMind! 💰🚀