GMF Applausometro

Web app locale per il Gazza Music Festival: misura l'energia del pubblico da microfono e produce l'Indice Applausometro GMF (1-10, massimo 2 decimali).

Requisiti

• Node.js 18+
• Browser moderno con Web Audio API (getUserMedia, AudioContext)

Avvio locale

npm install
npm run dev

Build produzione

npm run build
npm run preview

Test rapido su GitHub Pages

Il repository è configurato per deploy automatico tramite GitHub Actions (.github/workflows/deploy-pages.yml) e usa npm install nel workflow (non richiede lockfile).

1. Pubblica il branch su GitHub e assicurati che il branch predefinito sia main.
2. Vai in Settings → Pages e imposta Source: GitHub Actions.
3. Fai push su main (oppure lancia manualmente il workflow da tab Actions).
4. Al termine del job deploy, apri l'URL Pages mostrato nell'environment github-pages.

Note GitHub Pages

• vite.config.js imposta automaticamente base a /<nome-repo>/ quando gira in CI Pages.
• In locale il base resta /, quindi l'esperienza di sviluppo non cambia.
• Gli asset statici referenziati dalla root pubblica, ad esempio gmf-logo.svg, vanno posizionati in public/ e richiamati tramite la BASE_URL di Vite per funzionare anche sotto il percorso del repository GitHub Pages.

Flusso operativo rapido

1. Apri la schermata iniziale e inserisci il nome artista/band.
2. Clicca Test microfono e seleziona il dispositivo.
3. Clicca Calibra ambiente (5 secondi di silenzio).
4. Clicca Avvia misurazione:
   • countdown 3 secondi
   • analisi live 10 secondi
   • calcolo finale Audience Energy Score
5. Salva il risultato in classifica locale.
6. Da classifica puoi eliminare righe, resettare tutto, esportare CSV.

Note tecniche

• Il dato audio usa RMS relativo: non è una misura in dB calibrati.
• Dati classifica e metriche sono persistiti in localStorage.
• Lo score combina: intensità media, picco, durata utile sopra soglia, stabilità.