Verbex - Gioco per Imparare i Verbi Italiani 🇮🇹

Un'applicazione web standalone per imparare i verbi italiani con un sistema di valutazione scolastica.

🎯 Caratteristiche

• Gioco Standalone: Funziona completamente offline senza server
• Sistema di Valutazione Scolastica: Voti da A+ a F come a scuola
• 15 Verbi Italiani: Con difficoltà variabile (facile, medio, difficile)
• 10 Domande Casuali: Ogni test è diverso
• Statistiche Complete: Punteggio, percentuale, tempo impiegato
• Interfaccia Moderna: Design responsive con Tailwind CSS
• Supporto Multilingue: Francese e inglese per ogni verbo

🚀 Come Giocare

1. Apri l'applicazione su http://localhost:3000
2. Inserisci il tuo nome
3. Clicca "Inizia Test"
4. Rispondi alle 10 domande sui verbi italiani
5. Ricevi il tuo voto come a scuola!

📊 Sistema di Valutazione

Voto	Percentuale	Descrizione
A+	95%+	Eccellente! 🏆
A	90%+	Ottimo!
B+	80%+	Bene!
B	75%+	Discreto!
C+	65%+	Quasi sufficiente
C	60%+	Sufficiente
D	50%+	Insufficiente
F	<50%	Gravemente insufficiente

🛠️ Tecnologie

• Frontend: React 18 + TypeScript
• Build Tool: Vite
• Styling: Tailwind CSS
• Linguaggio: TypeScript

📁 Struttura del Progetto

verbex/
├── src/
│   ├── components/
│   │   └── StandaloneGame.tsx    # Componente principale del gioco
│   ├── types/
│   │   └── game.ts               # Definizioni TypeScript
│   ├── App.tsx                   # Componente root
│   ├── main.tsx                  # Entry point
│   └── index.css                 # Stili globali
├── public/
├── package.json
├── vite.config.ts
├── tailwind.config.js
└── README.md

🚀 Installazione e Avvio

Prerequisiti

• Node.js 18+
• npm

Installazione

# Clona il repository
git clone git@github.com:abestable/verbex.git
cd verbex

# Installa le dipendenze
npm install

# Avvia l'applicazione in modalità sviluppo
npm run dev

Script Disponibili

• npm run dev - Avvia il server di sviluppo
• npm run build - Crea la build di produzione
• npm run preview - Anteprima della build di produzione

🎮 Come Funziona

Generazione delle Domande

• 10 domande casuali per ogni test
• Verbi selezionati casualmente dai 15 disponibili
• Persone grammaticali casuali (io, tu, lui/lei, noi, voi, loro)

Sistema di Punteggio

• Facile: 1 punto
• Medio: 2 punti
• Difficile: 3 punti

Verbi Inclusi

• Facili: essere, avere, stare
• Medi: fare, andare, venire, dire, dare, vedere, prendere, mettere
• Difficili: potere, volere, dovere, sapere

🎯 Obiettivi di Apprendimento

• Migliorare la conoscenza dei verbi italiani
• Praticare le coniugazioni al presente indicativo
• Ricevere feedback immediato sul progresso
• Sviluppare familiarità con il sistema di valutazione scolastica

🔧 Personalizzazione

Aggiungere Nuovi Verbi

Modifica l'array italianVerbs in src/components/StandaloneGame.tsx:

{
  infinitive: 'nuovo-verbo',
  present: ['io', 'tu', 'lui', 'noi', 'voi', 'loro'],
  french: 'verbe-français',
  english: 'english-verb',
  difficulty: 'easy|medium|hard',
  points: 1|2|3
}

Modificare il Sistema di Valutazione

Modifica la funzione calculateGrade in src/components/StandaloneGame.tsx.

📝 Licenza

MIT License - vedi il file LICENSE per i dettagli.

👥 Contributi

I contributi sono benvenuti! Per contribuire:

1. Fai un fork del progetto
2. Crea un branch per la tua feature (git checkout -b feature/AmazingFeature)
3. Committa le modifiche (git commit -m 'Add some AmazingFeature')
4. Pusha al branch (git push origin feature/AmazingFeature)
5. Apri una Pull Request

🐛 Segnalazione Bug

Se trovi un bug, apri una issue su GitHub con:

• Descrizione del problema
• Passi per riprodurre
• Comportamento atteso
• Screenshot (se applicabile)

---

Buon divertimento imparando i verbi italiani! 🇮🇹✨