Demo-FeedbackFlowAI (Demo Didattica)

Applicazione realizzata a scopo didattico per mostrare un flusso end-to-end di raccolta feedback, invio comunicazioni, analisi AI e visualizzazione trend.

Il progetto e stato costruito come demo tecnica, non come prodotto production-ready.

Obiettivo della Demo

• simulare un workflow reale di gestione feedback
• integrare API esterne (AI, email, auth)
• mostrare come organizzare una codebase Next.js App Router con dashboard modulare

Stack Tecnologico

• Next.js 16 (App Router)
• React 19 + TypeScript
• Tailwind CSS 4
• Clerk (autenticazione)
• Supabase (persistenza)
• Groq SDK (analisi AI)
• Resend (invio email)
• Recharts (grafici trend)

Funzionalita principali

• Dashboard con sezioni dedicate (nuovo, ricevuti, storico, trend)
• Invio di messaggi/feedback via modal e API server-side
• Ricezione e storico thread inviati/ricevuti
• Analisi testuale tramite endpoint AI
• Notifiche e visualizzazione trend con grafici

Struttura essenziale

app/
	dashboard/
	api/
components/
	dashboard/
	landing/
lib/
	supabase/
supabase/

Avvio locale

1. Installa dipendenze:

npm install

2. Configura variabili ambiente in .env.local (partendo dai valori del tuo setup locale).

3. Avvia il server di sviluppo:

npm run dev

4. Apri http://localhost:3000.

Script utili

• npm run dev avvia l'app in sviluppo
• npm run build genera la build di produzione
• npm run start avvia la build
• npm run lint esegue linting ESLint

Presentazione HTML inclusa

Nel repository e inclusa anche la presentazione demo:

• presentazione-demo.html

Puoi aprirla direttamente nel browser per una panoramica del progetto.

Note

• Questa app e pensata per formazione, sperimentazione e demo.
• Prima di un uso reale in produzione, servono hardening sicurezza, monitoring e test piu estesi.