Casa - Gestione Finanziaria
Applicazione web completa per la gestione delle finanze familiari con intelligenza artificiale integrata, pianificazione pasti e supporto multi-utente.
info Overview del Progetto
Una soluzione completa per la gestione finanziaria domestica
Casa e un'applicazione web progettata per aiutare famiglie e individui a gestire le proprie finanze in modo intelligente.
Obiettivi del Progetto
- check_circleTracciamento Spese Completo - Registrazione di tutte le transazioni con categorizzazione automatica e supporto multi-conto
- check_circleGestione Budget Intelligente - Sistema di budget per categoria con alert automatici e previsioni
- check_circleAssistente AI Conversazionale - Chat integrata con Google Gemini per query in linguaggio naturale
- check_circlePianificazione Pasti - Gestione dispensa, lista spesa e suggerimenti ricette basati su AI
- check_circleMulti-Utente - Supporto per nuclei familiari con gestione membri, allergie e preferenze alimentari

Dashboard
stars Funzionalita Principali
Un ecosistema completo di strumenti per la gestione finanziaria
Dashboard Interattiva
Panoramica completa con grafici interattivi (Chart.js), KPI in tempo reale, trend mensili e confronti con periodi precedenti.

Dashboard
Multi-Conto
Gestione di conti bancari, carte e contanti separati. Filtri per conto e visualizzazione aggregata dei saldi.

Lista-Conti
Categorizzazione Smart
Sistema gerarchico macro-categorie/sottocategorie. Suggerimento automatico categoria tramite AI.

Modal-Modifica-Spesa
Budget per Categoria
Impostazione budget mensili per categoria con barre di progresso, alert sforamento e previsioni fine mese.

Barre-Budget
Spese Ricorrenti
Gestione abbonamenti e spese fisse. Collegamento automatico spese a template ricorrenti.

Spese-Ricorrenti
Import CSV/XLSX
Importazione estratti conto con anteprima, rilevamento duplicati e mapping automatico campi.

Import-Excel
Chat AI Assistant
Assistente conversazionale per query finanziarie, aggiunta spese vocale, analisi budget e consigli.

Chat-Conversazione
Gestione Dispensa
Inventario ingredienti, lista spesa intelligente, suggerimenti ricette AI basati su disponibilita.

Dispensa
Pianificazione Pasti
Calendario settimanale pasti, generazione menu AI con rispetto allergie/diete, calcolo porzioni.

Calendario-Settimanale
Gestione Famiglia
Profili membri con eta, allergie, intolleranze e diete. Strategie di esclusione ingredienti.

Membri-Famiglia
Voice Input/Output
Riconoscimento vocale per input (Web Speech API) e sintesi vocale per risposte (Google Cloud TTS).

Selezione-Voce-TTS
Analytics Avanzate
Grafici trend 12 mesi, confronti mese vs precedente, proiezioni fine mese, evoluzione categorie.

Trend-Entrate-Uscite
Chrome Extension V2
Estensione potenziata con tre funzionalità:
- Cattura Movimenti - Screenshot pagine bancarie con OCR
- Quick Add Spesa - Selezione area schermo per importare spese
- Import Ricette - Estrae ricette da siti web automaticamente

Chrome-Extension
Area Selection OCR
Seleziona un'area dello schermo su qualsiasi sito e-commerce. L'AI estrae automaticamente: titolo prodotto, prezzo e categoria suggerita.

Area-Selection
collections Galleria Screenshot
Ulteriori schermate dell'applicazione
Dashboard & Mobile

Dashboard-Mobile

Lista-Movimenti
Gestione Spese

Collegamento-Ricorrente

Config-Budget
Chat AI

Suggerimenti-Rapidi

Chat-Azione
Analytics

Confronto-Mese

Proiezione-Fine-Mese

Evoluzione-Categorie
Alimenti & Ricette

Lista-Spesa

Dispensa

Ricette

Dettaglio-Ricetta

Suggerimenti-AI-Ricette
Pianificazione & Famiglia

Selezione-Pasto

Generazione-Menu-AI

Profilo-Membro

Allergie-Diete
Configurazione

Modal-Nuovo-Conto

Gestione-Categorie

Backup-Restore

Profilo-Utente
Chrome Extension V2

Chrome-Extension

Bank-Capture-Flow

Area-Selection

Quick-Spesa-OCR

Import-Ricetta
code Stack Tecnologico
Tecnologie moderne per un'applicazione robusta e performante
Backend
PHP 8.x
Backend & APISQLite
Database EmbeddedGoogle Gemini
AI & NLPGoogle Cloud TTS
Text-to-SpeechFrontend
JavaScript ES6+
Vanilla JSChart.js
Data VisualizationCSS3 Custom
Design SystemMaterial Icons
IconografiaFeatures Avanzate
PWA
Installabile, OfflineIndexedDB
Offline StorageWeb Speech API
Voice RecognitionSimpleXLSX
Excel ImportChrome Extension
Bank Captureaccount_tree Architettura
Design modulare e scalabile
Database Schema (Tabelle Principali)
| Tabella | Descrizione | Relazioni |
|---|---|---|
spese | Transazioni finanziarie | → categorie, conti, spese_ricorrenti |
categorie | Macro-categorie e sottocategorie | → budget_categorie |
conti | Conti bancari e metodi pagamento | → spese |
budget_mensile | Budget configurati per mese | → budget_categorie |
dispensa | Inventario ingredienti | → ingredienti_base |
ricette | Database ricette | → ricette_ingredienti |
famiglia_membri | Componenti nucleo familiare | → allergie, diete |
pianificazione_pasti | Calendario pasti settimanale | → ricette, famiglia |
chat_messages | Storico conversazioni AI | - |
psychology Integrazione AI
Google Gemini per un'esperienza intelligente
L'applicazione integra Google Gemini 2.5 Flash in molteplici contesti per offrire funzionalita avanzate.
Funzionalita AI Implementate
Chat Conversazionale
Query in linguaggio naturale con comprensione del contesto e storico conversazione.
Azioni Automatiche
L'AI puo eseguire azioni: "Aggiungi 45euro per la cena" inserisce automaticamente la spesa.
Categorizzazione Smart
Suggerimento automatico della categoria analizzando la descrizione della transazione.
Suggerimenti Ricette
Generazione ricette basate sulla dispensa con rispetto di allergie e preferenze.
OCR Estratti Conto
Analisi screenshot pagine bancarie per estrarre automaticamente movimenti con data, descrizione e importo.
OCR Scontrini/Spese
Estrazione spese da screenshot di scontrini o pagine e-commerce con importo e categoria suggerita.
Import Ricette Web
Estrazione automatica ingredienti e procedimento da pagine web di ricette (JSON-LD e HTML parsing).
Generazione Menu AI
Pianificazione automatica menu settimanale con rispetto allergie, diete e preferenze familiari.
Sintesi Vocale (TTS)
Google Cloud Text-to-Speech per lettura vocale delle risposte AI con scelta tra voci italiane.
Prompt Engineering
- check_circleSystem Prompt Strutturato - Definisce ruolo, formato output JSON, regole di comportamento
- check_circleContext Injection - Dati finanziari reali iniettati nel prompt per risposte accurate
- check_circleFew-shot Examples - Esempi di input/output per guidare il comportamento
- check_circleGuardrails - Istruzioni esplicite su cosa NON fare (es. non inventare dati)
phone_iphone Mobile & PWA
Esperienza nativa su qualsiasi dispositivo
L'applicazione e progettata con approccio mobile-first e puo essere installata come Progressive Web App.
Installabile
Manifest PWA per installazione su home screen con icona dedicata.
Offline Support
IndexedDB per cache locale. Funzionalita base disponibili offline.
Touch Optimized
UI ottimizzata per touch: bottoni grandi, swipe actions.
Performance
Lazy loading, ottimizzazione assets, caching aggressivo.
security Sicurezza
Best practices per la protezione dei dati
- check_circleAutenticazione - Sistema login con sessioni PHP sicure
- check_circleSQL Injection Prevention - Prepared statements PDO per tutte le query
- check_circleXSS Protection - Escape output e Content Security Policy
- check_circleAPI Key Protection - Chiavi API gestite server-side, mai esposte al client
- check_circleHTTPS - Comunicazioni crittografate end-to-end
emoji_events Conclusioni
Un progetto completo che dimostra competenze full-stack
- check_circleBackend robusto con PHP e SQLite, architettura API RESTful
- check_circleFrontend moderno con JavaScript vanilla performante e responsive design
- check_circleIntegrazione AI avanzata con Google Gemini per NLP e generazione contenuti
- check_circleUX/UI curata con attenzione ai dettagli e accessibilita mobile
- check_circleFeatures innovative come voice I/O, offline support e PWA