f5d99c665b
- Aggiunta sezione dettagliata sullo scopo del progetto MoneyMind - Elenco completo delle tecnologie utilizzate nel progetto - Requisiti minimi di software e hardware chiaramente definiti - Descrizione dettagliata delle caratteristiche principali con benefici - Informazioni sulla sicurezza, privacy e accessibilità - Guida di installazione rapida in 5 semplici passaggi - Statistiche del progetto e roadmap di sviluppo futuro - Informazioni per contributi e contatti dell'autore - Licenza MIT e informazioni di supporto 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
173 lines
5.3 KiB
Markdown
173 lines
5.3 KiB
Markdown
# 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:
|
|
|
|
[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! 💰🚀** |