Initial commit: InTono — app KMP per l'apprendimento musicale

App Kotlin Multiplatform (Android/iOS/Desktop) con Compose Multiplatform:
controllo intonazione (YIN), pratica guidata, metronomo, ear training,
sfide, scansione spartiti via AI, spartiti bundled e pentagramma con
glifi tipografici, travature, battute e spaziatura proporzionale.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

GUIDA_UTENTE.md

@@ -0,0 +1,162 @@
+# InTono — Guida Utente
+
+Intonazione e pratica per musicisti di ogni livello.
+
+---
+
+## Strumenti
+
+### Controllo Intonazione
+Rileva in tempo reale la nota che stai suonando tramite il microfono del dispositivo. Lo schermo mostra:
+- **Nome della nota** rilevata (notazione italiana: Do, Re, Mi...)
+- **Deviazione in cents** rispetto all'intonazione perfetta
+- **Indicatore visivo** verde (intonato) o rosso (stonato)
+
+Ideale per strumenti a corda, a fiato o voce: verifica se stai suonando la nota giusta.
+
+### Metronomo
+Un metronomo digitale con le seguenti funzioni:
+- **BPM regolabile** da 30 a 240 tramite slider
+- **Tempi disponibili**: 2/4, 3/4, 4/4, 6/8
+- **Indicatori visivi dei battiti** con accento sul primo battito
+- **Tap Tempo**: tocca ripetutamente il pulsante per impostare il BPM dal tuo ritmo
+- **Tuner integrato**: premi il pulsante microfono per attivare il rilevamento dell'intonazione mentre suoni a tempo. Mostra la nota rilevata, la deviazione in cents con indicatore visivo e la frequenza in Hz
+
+Premi il pulsante Play per avviare, Stop per fermare.
+
+### Nota di Riferimento
+Genera una nota di riferimento per accordare o esercitarsi a orecchio:
+- **Pulsante rapido LA 440 Hz** per l'accordatura standard
+- **Griglia di 12 note** per selezionare qualsiasi nota cromatica
+- **Ottava selezionabile** da 2 a 7
+- Mostra la frequenza esatta in Hz
+
+Premi Play per ascoltare la nota, Stop per fermare.
+
+---
+
+## Pratica
+
+### Modalita Pratica
+Il cuore dell'app. Carica una sequenza di note e suonale una per una:
+1. Scegli come inserire le note: **manuale**, **scansione foto** o **file MusicXML**
+2. Suona ogni nota mostrata sul pentagramma
+3. L'app rileva la nota dal microfono e avanza automaticamente quando e' corretta
+4. Al termine vedi le statistiche della sessione
+
+**Modalita di visualizzazione del pentagramma:**
+- **Nota**: mostra solo la nota corrente
+- **Contesto**: mostra le note vicine
+- **Spartito**: mostra tutto il pentagramma
+- **Chiaro**: sfondo bianco per leggibilita
+- **Nascondi**: nasconde il nome della nota scritta, utile per esercitarsi a leggere dal pentagramma
+
+**Metronomo integrato:** sotto i selettori di visualizzazione c'e' una barra metronomo con play/stop, BPM e slider per suonare a tempo durante la pratica.
+
+Lo sfondo cambia colore: verde = nota corretta, rosso = nota sbagliata.
+
+### Esercizi
+Esercizi pronti da suonare con difficolta progressiva:
+- **Livello 1**: Note base (Do-Sol)
+- **Livello 2**: Scale complete
+- **Livello 3**: Scale con alterazioni e melodie
+- **Livello 4**: Arpeggi e salti
+
+Tocca un esercizio per iniziare subito la pratica.
+
+### Scale e Arpeggi
+Genera scale e arpeggi in qualsiasi tonalita:
+
+**Scale disponibili:**
+- Maggiore, Minore Naturale, Armonica, Melodica
+- Pentatonica Maggiore e Minore
+- Cromatica
+
+**Arpeggi disponibili:**
+- Maggiore, Minore, Diminuito, Aumentato
+- Settima Dominante, Maggiore, Minore
+
+**Come usare:**
+1. Seleziona la nota fondamentale (12 opzioni cromatiche)
+2. Scegli l'ottava (2-6)
+3. Scegli il tipo di scala o arpeggio
+4. Scegli la direzione: ascendente, discendente o entrambe
+5. Visualizza l'anteprima sul pentagramma
+6. Tocca **Pratica** per esercitarti con il riconoscimento automatico
+
+### Spartiti
+Sfoglia la libreria di file MusicXML e pratica direttamente dai brani importati.
+
+---
+
+## Sfida
+
+### Ear Training
+Allena il tuo orecchio musicale con due modalita:
+
+**Riconosci Nota**: ascolta una nota e indovina quale nota e'.
+**Riconosci Intervallo**: ascolta due note e identifica l'intervallo (da unisono a ottava).
+
+**Livelli di difficolta:**
+- **Facile**: poche note/intervalli semplici (unisono, terza, quinta, ottava)
+- **Medio**: piu' note e intervalli comuni
+- **Difficile**: tutte le 12 note e tutti i 13 intervalli
+
+Ogni sessione ha 10 domande. Premi il pulsante Play per ascoltare, poi tocca la risposta corretta tra le 4 opzioni.
+
+### Modalita Sfida
+Metti alla prova la tua velocita e precisione:
+1. Scegli la **sorgente**: esercizi, scale o note random
+2. Scegli il **tempo limite**: 30 secondi, 1 minuto o 2 minuti
+3. Suona il maggior numero di note corrette nel tempo!
+
+Ogni nota da suonare e' mostrata sia sul **pentagramma** che con il nome e l'ottava.
+
+**Sistema di punteggio:**
+- 100 punti base per ogni nota corretta
+- Bonus precisione: +50 punti se entro 5 cents, +25 se entro 15 cents
+- Bonus velocita: +30 punti se suoni in meno di 2 secondi
+- **Moltiplicatore combo**: suona note consecutive corrette per aumentare il punteggio fino a 2x
+
+### Classifica
+Vedi i tuoi 20 migliori punteggi nelle sfide, ordinati dal piu' alto. Per ogni risultato sono indicati il punteggio, le note suonate, la combo massima e la data.
+
+---
+
+## Progressi
+
+### Statistiche
+Panoramica dei tuoi progressi nel tempo:
+
+**Riepilogo:**
+- Numero totale di sessioni
+- Sessioni completate
+- Tempo totale di pratica
+- Miglior precisione raggiunta
+
+**Grafici giornalieri:**
+- **Precisione** (deviazione media in cents — piu' basso e' meglio)
+- **Primo tentativo** (percentuale di note suonate al primo colpo)
+- **Tempo di reazione** (velocita media nel suonare ogni nota)
+
+### Obiettivi Giornalieri
+Mantieni la costanza nella pratica:
+- **Imposta un obiettivo**: 5, 10, 15 o 30 minuti al giorno
+- **Progresso circolare**: vedi quanto hai praticato oggi
+- **Serie consecutiva**: il contatore si incrementa ogni giorno che raggiungi l'obiettivo
+- **Calendario**: visualizza gli ultimi 30 giorni con i giorni di pratica colorati in verde
+
+Il tempo viene conteggiato da tutte le attivita: pratica, sfide e ear training.
+
+### Cronologia
+Rivedi tutte le sessioni passate in un'unica lista cronologica: pratica, ear training e sfide. Ogni tipo ha un badge colorato per distinguerlo a colpo d'occhio. Tocca una sessione di pratica per rieseguirla.
+
+---
+
+## Suggerimenti
+
+- **Ambiente silenzioso**: l'app funziona meglio in un ambiente con poco rumore di fondo
+- **Distanza dal microfono**: tieni il dispositivo a 30-50 cm dallo strumento
+- **Pratica quotidiana**: anche 10 minuti al giorno fanno la differenza — usa gli obiettivi giornalieri per restare motivato
+- **Inizia dalle scale**: padroneggiare le scale e' la base per suonare qualsiasi brano
+- **Ear training regolare**: anche 5 minuti di ear training al giorno migliorano notevolmente l'orecchio musicale