Quiz interattivi — la guida

Cos'è

Un motore generico per quiz e autovalutazioni. Ogni quiz è descritto da uno schema JSON che definisce: introduzione, item (domande), tipo di item (Likert 1-5, scelta multipla, risposta aperta), regole di scoring (somma Likert, conteggio risposte corrette) e soglie interpretate (range di punteggio → etichetta + messaggio).

Il player è universale: ricevi un URL con ?slug=xxx, fa il fetch dello schema JSON via API, renderizza il quiz, calcola il punteggio in locale, mostra la soglia in cui sei caduto. Le risposte non vengono inviate al server: restano nel browser.

L'authoring avviene in /admin-quiz-builder (richiede login admin): la redazione scrive lo schema con due template di partenza (Likert / Scelta multipla), preview live, validazione JSON, toggle bozza/pubblico.

A chi è rivolto

• Operatori che vogliono uno strumento di auto-osservazione su una pratica specifica.
• Formatori che usano quiz come momento di riflessione (non come voto).
• Redazione: per pubblicare nuovi quiz senza dover scrivere codice nuovo.

Tutorial passo-passo

Per chi compila un quiz

1. Apri un quiz da link diretto: l'URL ha forma /operatori-risorse-quiz-builder?slug=NOME. Esempio: il quiz pilota pronto-a-facilitare.
2. Rispondi agli item in qualsiasi ordine. La barra in basso mostra "N / M domande risposte". Le risposte sono solo nel tuo browser: nessuno le vede, nemmeno noi.
3. Calcola risultato col bottone in fondo: vedi il punteggio (somma o conteggio), la soglia in cui sei caduto (etichetta) e un messaggio interpretativo che la spiega.
4. Ricomincia per pulire e rifare. Niente storico delle risposte: se cambi browser o pulisci cache, parti da capo.

Per chi crea un quiz (admin)

1. Apri /admin-quiz-builder e fai login con la password admin.
2. Click "+ Nuovo": si apre il form con un template Likert pre-compilato. Ti basta cambiare il titolo, lo slug (kebab-case, è l'URL del quiz), gli item, le soglie. Cliccando "Template Scelta multipla" cambi tipo di scoring.
3. Valida JSON col pulsante: se ci sono errori (parentesi sbagliata, virgola di troppo, items[] vuoto), il pannello sotto te lo dice prima di salvare.
4. Salva come bozza (attivo=0): il quiz è raggiungibile dall'admin per anteprima ma non dal pubblico. Quando soddisfatto, toggle attivo=1 e salva di nuovo: è pubblico.
5. Anteprima: pulsante a destra di ogni riga in lista, apre il player in nuovo tab con lo slug giusto.

Schema JSON minimo (Likert):

{
  "intro_md": "Breve introduzione **opzionale**.",
  "items": [
    { "id": "q1", "tipo": "likert_5",
      "domanda": "Mi sento a mio agio nel silenzio.",
      "rev": false,
      "scala": ["Mai","Raramente","A volte","Spesso","Sempre"]
    }
  ],
  "scoring": {
    "tipo": "somma_likert",
    "soglie": [
      { "min": 0, "max": 2,
        "label": "In esplorazione",
        "messaggio_md": "Punto di partenza..." }
    ]
  }
}

Casi d'uso concreti

Quando NON usarlo

FAQ + privacy