Documentazione ufficiale

Crea un test perfetto
in pochi minuti.

TestGENIAL permette la creazione di verifiche multi-versione con supporto AI integrato, qualità tipografica LaTeX e chiave di correzione Excel

LaTeXQualità tipografica
01

Cos'è TestGENIAL

Per un insegnante creare una verifica o un test dovrebbe essere idealmente un'attività focalizzata solo e unicamente sui contenuti. Aspetti di formattazione, gestione versioni e controllo di consistenza, invece, spesso richiedono più tempo di quello richiesto per la progettazione del test vero e proprio. TestGENIAL nasce per questo scopo. Permette di creare in poco tempo verifiche multi-versione di alta qualità tipografica con il supporto dell'AI.

Uno dei punti di forza è la qualità delle formule matematiche e scientifiche: ogni testo viene compilato con LaTeX, il sistema di composizione tipografica usato nelle pubblicazioni scientifiche. Il risultato è un PDF dall'aspetto professionale, pronto per la stampa fronte-retro.

Nonostante sia ottimizzato per le materie scientifiche, la versatilità dello strumento lo rende adatto anche alle materie umanistiche

📐
Qualità LaTeX

Formule matematiche, chimiche e fisiche composte con il motore tipografico usato nelle pubblicazioni scientifiche.

🔀
Multi-versione

Domande e opzioni vengono rimescolate automaticamente, con chiave di correzione inclusa.

🤖
AI integrata

Genius valida e corregge le singole domande. Super Genius genera un test completo a partire da un argomento.

📥
Importazione

Importa domande esistenti da PDF, documenti Word (.docx) o file Moodle (XML/GIFT) con un solo click.

📊
Excel automatico

Ogni generazione produce un foglio Excel con la chiave di correzione e i punteggi per ogni versione e ogni domanda.

💾
Formato .tgen

Salva il test nel formato proprietario .tgen e riaprilo in qualsiasi momento per modificarlo o rigenerarlo.


02

Il flusso di lavoro

Questo è il percorso tipico dalla creazione di un test alla correzione:

✍️
Scrivi le domande
o importa da PDF/Word/Moodle
🤖
Valida con AI
Genius corregge e completa
⚙️
Configura
Versioni, layout, allievi
📄
Genera PDF + Excel
Download automatico
📋
Distribuisci
Versioni miste in classe
Correggi con Excel
Voti automatici

Il PDF generato contiene tutte le versioni del test già stampate in sequenza, nell'ordine giusto per la distribuzione: basta stampare fronte-retro e distribuire i fogli agli studenti in sequenza


03

Registrazione e accesso

Accedi a testgenial.it e clicca su Registrati. Puoi creare un account con email e password oppure con il tuo account Google tramite il pulsante dedicato.

Consiglio

Se usi Gmail per la scuola, il login con Google è il metodo più rapido: nessuna password aggiuntiva da ricordare.

Prima apertura

Al primo accesso, TestGENIAL mostra automaticamente una finestra per completare il profilo. Solo i campi grado scolastico e almeno una materia sono obbligatori per poter usare l'applicazione.


04

Profilo e classi

Il profilo si raggiunge in qualsiasi momento cliccando sull'icona utente in alto a sinistra. La finestra è divisa in due schede:

Scheda Profilo

Qui puoi inserire nome, cognome, istituto, provincia, classe di concorso e fino a tre materie insegnate. Il grado scolastico è obbligatorio e viene precompilato nei nuovi test. I valori disponibili sono: Primaria, Secondaria I grado, Secondaria II grado, Università/ITS.

Scheda Classi

Puoi registrare fino a 9 classi con numero, sezione e numero di allievi. Questi dati vengono usati per precompilare il campo numero allievi ogni volta che selezioni quella classe, evitando di reinserirlo ogni volta.

Consiglio

Compila le classi all'inizio dell'anno scolastico: quando selezioni una classe nel form del test, il numero di allievi viene inserito automaticamente.

Le nuove materie che inserisci nei test vengono aggiunte automaticamente al tuo elenco suggerimenti, così da ritrovarle nelle sessioni successive.


05

Metadati del test

Prima di inserire le domande, compila l'intestazione del test:

CampoDescrizioneObbligatorio
TitoloNome del test, max 100 caratteri
DataData della verifica (testo libero)
ClasseNumero di classe (1–5)
SezioneLettera di sezione — suggerisce automaticamente le sezioni già usate per quella classe
Grado scolasticoPrecompilato dal profilo
MateriaPrecompilata dal profilo, con suggerimenti automatici dalle materie salvate
Numero allieviUsato per dimensionare il PDF; precompilato se la classe è nel profilo

I primi quattro campi (titolo, data, classe, sezione) vengono stampati nell'intestazione del PDF. Gli altri sono usati internamente dal sistema e dall'AI.


06

Inserire le domande

L'area domande è l'editor principale di TestGENIAL. Ogni domanda ha un proprio riquadro (card) con editor, toolbar, semaforo e anteprima in tempo reale.

Barra di stato superiore

Sopra l'area domande si trova una barra con 30 quadratini numerati, uno per ogni domanda. Ogni quadratino riflette lo stato della domanda corrispondente con un colore:

ColoreStatoSignificato
⚪ BiancoVuotaDomanda non ancora compilata
🔴 RossoIncompletaTesto presente ma mancano almeno due opzioni o non è segnata la risposta corretta
🟡 GialloCompletaDomanda compilata correttamente ma non ancora validata dall'AI
🟢 VerdeApprovataValidata da Genius o approvata manualmente

I quadratini hanno due funzioni: navigazione e riordinamento. Cliccando un quadratino si scorre automaticamente alla domanda corrispondente, evidenziata per un secondo. Trascinando un quadratino in un'altra posizione si sposta la domanda corrispondente: è questo il modo per riordinare le domande, non trascinando le card stesse. Passando il mouse sopra un quadratino appare un tooltip con il testo della domanda.

Il semaforo della domanda

Ogni card ha nella sua intestazione sinistra un piccolo semaforo a tre luci (rosso, giallo, verde) che rispecchia lo stesso stato del cerchietto nella barra superiore. È un riferimento visivo immediato senza dover guardare la barra in alto.

Testo della domanda

Scrivi nel campo testo della card. Il campo ha un evidenziatore sintattico in tempo reale: le formule matematiche $...$ vengono colorate di indaco, i placeholder immagine [[{...}...]] di grigio. L'anteprima renderizzata appare nel pannello a destra della card, con formule composte in LaTeX e immagini visibili.

Formule matematiche

Usa $...$ per formule inline e $$...$$ per formule centrate su riga separata. Tutto il LaTeX standard è supportato: frazioni, radicali, matrici, integrali, sommatorie.

Simboli speciali

Alcuni simboli hanno un significato speciale in LaTeX e vanno scritti in modo particolare: il simbolo % va scritto come \%, e i simboli < e > vanno sempre racchiusi tra $ (es. $x > 0$). Genius si occupa di queste conversioni automaticamente.

Toolbar di ogni domanda

Ogni card ha una barra degli strumenti in cima con i seguenti pulsanti:

PulsanteFunzione
AnnullaRipristina lo stato precedente all'ultima modifica significativa (es. dopo aver usato Genius)
RicominciaAzzera completamente la singola domanda
ImmagineCarica un file immagine dal computer
FotocameraScatta una foto con la fotocamera del dispositivo (solo mobile). Caso d'uso tipico: fotografa un esercizio da libro o da quaderno, poi usa Genius per trasformarlo automaticamente in domanda con opzioni.
ImportaImporta domande da un file .tgen esistente: puoi selezionarne singolarmente alcune oppure importarle tutte in una volta
CopiaCopia la domanda negli appunti
IncollaIncolla una domanda dagli appunti
GeniusInvia la domanda all'AI per validazione e completamento automatico
ApprovaSegna manualmente la domanda come approvata senza passare per Genius

Opzioni di risposta

Per le domande a scelta multipla, scrivi il testo di ogni opzione e seleziona quella corretta con la checkbox a sinistra. Il numero di opzioni visibili dipende dall'impostazione Max Opzioni nella barra laterale. Una e una sola opzione deve essere marcata come corretta.

Risposta corretta

Non c'è bisogno di preoccuparsi di cambiare la posizione della risposta corretta nelle varie domande. Quando il test viene generato le opzioni di risposta vengono rimescolate automaticamente prima di iniziare a generare le versioni.

Checkbox "Aperta"

Spuntando la checkbox Aperta nell'intestazione della card, la domanda viene convertita da scelta multipla a risposta aperta. Compaiono i controlli per il tipo di spazio risposta e l'altezza.

Pagina soluzioni

Il pulsante Pagina soluzioni sotto la barra di stato apre una finestra con tutte le risposte corrette di tutte le domande compilate, incluse le domande aperte. È utile in fase di restituzione agli allievi della verifica corretta, ad esempio proiettandola alla LIM.

Somma punteggi

Accanto al pulsante Pagina soluzioni è sempre visibile la somma totale dei punteggi di tutte le domande compilate, aggiornata in tempo reale.

Nuovo test

Il pulsante Nuovo nella barra laterale azzera completamente il test: domande, metadati e impostazioni. Usalo per iniziare da zero.


07

Immagini nelle domande

Puoi associare immagini a qualsiasi domanda in tre modi:

  1. Caricamento file — clicca sull'icona immagine e seleziona un file dal computer. Formati supportati: PNG, JPG, GIF.

  2. Incolla dagli appunti — fai uno screenshot e incolla direttamente con Ctrl+V nell'area della domanda.

  3. Fotocamera — su dispositivi mobili, puoi scattare una foto direttamente dall'app e inserirla nella domanda.

Ogni immagine viene rappresentata nel testo con un placeholder [[{1.0}IMGxxxxxxxx.png]] dove il numero indica la larghezza relativa (1.0 = tutta la larghezza della colonna, 0.5 = metà). Puoi modificare questo valore direttamente nel testo.


08

Tipi di domanda

Domanda chiusa (scelta multipla)

Il tipo predefinito. Lo studente sceglie una risposta tra le opzioni disponibili e la segna nella griglia di risposta stampata nel foglio. Al momento della correzione, basta trascrivere nel foglio Excel le lettere riportate dallo studente nella griglia

Domanda aperta

Lo studente scrive la risposta in uno spazio dedicato. Nel PDF viene stampato uno spazio bianco la cui dimensione puoi configurare scegliendo tra:

Tipo spazioAspetto
RigheLinee orizzontali per la scrittura
QuadrettiGriglia a quadretti per calcoli o schizzi
VuotoSpazio bianco libero

Per le domande aperte puoi specificare l'altezza dello spazio con un numero intero (da 0 a 30), che corrisponde al numero di righe o alla dimensione della griglia nel PDF

Domanda aperta senza spazio per la risposta

Se preferisci che lo studente scriva la sua risposta altrove (ad esempio sul foglio protocollo), basta porre a 0 (zero) lo spazio dedicato alla risposta

È disponibile anche un campo facoltativo per scrivere la risposta attesa, cioè la risposta corretta ideale. Se non la scrivi, puoi far generare una risposta modello a Genius. La risposta attesa ovviamente non viene stampata nel PDF degli studenti, ma appare nella pagina soluzioni — utile da proiettare alla LIM durante la restituzione del test corretto.

Misto chiuso e aperto

TestGENIAL supporta test misti: alcune domande a scelta multipla e altre a risposta aperta nello stesso PDF.


09

Punteggi

Ogni domanda ha un campo punteggio (default: 1). Il totale dei punteggi viene calcolato in tempo reale e mostrato nell'intestazione dell'editor, e stampato anche nel PDF sotto il titolo del test.

Nel foglio Excel di correzione, il foglio PUNTEGGI riporta il valore di ogni domanda per ogni versione del test. Questo consente di calcolare automaticamente il voto in decimi o centesimi con semplici formule Excel.

Nota

Poiché le domande vengono rimescolate nelle diverse versioni, il foglio Excel mantiene l'associazione corretta tra posizione della risposta e punteggio per ogni versione.

Salvare il test (.tgen)

Il formato .tgen è il formato nativo di TestGENIAL. Contiene tutto: metadati, domande, opzioni, punteggi, immagini e parametri dell'ultima generazione. Le immagini sono incorporate direttamente nel file, che è quindi completamente autonomo e non richiede file separati.

Clicca Salva per scaricare il file. Il nome viene generato automaticamente dal titolo del test. Dopo ogni generazione PDF, TestGENIAL mostra una finestra che ricorda di salvare il .tgen: non chiuderla senza aver scaricato il file se vuoi poter riaprire il test in futuro.

Recupero emergenziale

Il file .tgen contiene tutti i parametri dell'ultima generazione. Se perdi il foglio Excel, riapri il .tgen e rigenera: otterrai un Excel identico all'originale.

Ricaricare un test

Clicca Apri e seleziona il file salvato in precedenza. TestGENIAL caricherà tutte le domande, le immagini e la configurazione esattamente come erano al momento del salvataggio. Il formato è retrocompatibile con le versioni precedenti dell'app.


10

Genius: valida la domanda

Importante

Qualsiasi motore di Intelligenza Artificiale può sbagliare

Il tasto Genius su ogni domanda la invia all'AI per validazione e correzione automatica. È la funzione AI più usata, ideale per rifinire domande scritte a mano.

Cosa fa Genius

  1. Verifica che il testo della domanda abbia senso e sia formulato correttamente.

  2. Se il numero di opzioni è inferiore al massimo configurato, genera le opzioni mancanti.

  3. Forza esattamente una risposta corretta tra le opzioni.

  4. Converte automaticamente formule matematiche e chimiche nel formato LaTeX corretto.

  5. Corregge errori di battitura nelle opzioni senza alterare il contenuto.

  6. Restituisce un campo note con un log sintetico di cosa è stato modificato, oppure "OK" se la domanda era già corretta.

Importante

Genius non modifica il testo della domanda se è già corretto. Non modifica mai i placeholder di immagini [[{...}...]]. Modifica le opzioni solo per correggere LaTeX o refusi, mai il contenuto.

Genius con immagini

Se la domanda contiene immagini, Genius le analizza per estrarne il contenuto testuale prima di elaborare la domanda. Può quindi generare o validare le opzioni tenendo conto di quanto raffigurato.


11

Super Genius: genera il test

Super Genius è la funzione AI più potente: genera o completa un intero test in una sola operazione. Si attiva dal pannello Contesto, collassabile, che si trova nell'intestazione dell'editor sopra le domande.

Modalità di utilizzo

Super Genius funziona in tre modalità in base allo stato attuale del test:

Stato del testComportamento
Test vuotoGenera un test completo da zero usando il contesto fornito e i metadati
Test parzialeCompleta le domande mancanti e corregge quelle incomplete
Test completoRevisione globale: coerenza, difficoltà, LaTeX, duplicati

Configurazione nel pannello Contesto

Aprendo il pannello trovi:

  1. Testo contesto — area di testo libera dove descrivere l'argomento del test, la difficoltà, eventuali istruzioni particolari.

  2. Domande chiuse — due campi affiancati: il valore attuale (grigio, sola lettura) e il valore target. L'AI porterà il numero di domande chiuse al valore target.

  3. Domande aperte — stessa logica: valore attuale → valore target.

  4. Pulsante Super Genius (icona lampadina dorata) — avvia la generazione.

Consiglio

Compila prima i metadati (materia, classe, grado scolastico) e fornisci un contesto specifico. Super Genius usa questi dati per calibrare la difficoltà e il registro linguistico.


12

Importa da PDF

Hai vecchi test in PDF? TestGENIAL li importa automaticamente convertendoli nel formato .tgen modificabile. Il processo usa un doppio passaggio AI:

  1. Trascrizione ottica — ogni pagina del PDF viene analizzata dall'AI, che trascrive il testo con piena comprensione delle formule matematiche.

  2. Conversione strutturata — il testo trascritto viene convertito nel formato .tgen, identificando automaticamente domande, opzioni e risposte corrette.

  3. Selezione domande — al termine dell'elaborazione si apre una finestra con tutte le domande estratte. Puoi scegliere Importa Tutte oppure selezionare singole domande e cliccare Importa Selezionate.

Le immagini presenti nel PDF vengono estratte, salvate e associate alle rispettive domande.

Opzioni di importazione

Puoi specificare un intervallo di pagine da importare (prima pagina – ultima pagina), utile se il PDF contiene più test o materiale di copertina da saltare.


13

Importa da Word

I file .docx vengono importati con un parser dedicato che gestisce correttamente:

  1. Testo normale — tutti i paragrafi del documento vengono estratti in ordine.

  2. Formule Word — le equazioni create con l'editor di equazioni di Word vengono convertite automaticamente in LaTeX. Sono supportate frazioni, esponenti, pedici, radicali, integrali, sommatorie, matrici e molti altri costrutti.

  3. Immagini inline — le immagini incorporate nel documento vengono estratte e associate alle domande corrispondenti.

  4. Tabelle — il contenuto delle tabelle viene serializzato con separatori di colonna, incluse le eventuali immagini nelle celle.

Dopo l'estrazione del testo, lo stesso motore AI converte il contenuto nel formato .tgen strutturato. Come per il PDF, al termine si apre la finestra di selezione domande per scegliere quali importare.


14

Importa da Moodle

Se usi Moodle per la didattica online, puoi esportare le domande da una banca domande e importarle direttamente in TestGENIAL. Sono supportati due formati:

FormatoEstensioneTipi domanda supportati
Moodle XML.xmlScelta multipla, saggio (aperta), risposta breve
GIFT.txt / .giftScelta multipla, risposta aperta

Le formule LaTeX nei file Moodle (formato \(...\) e \[...\]) vengono convertite automaticamente nel formato $...$ usato da TestGENIAL. Le immagini incorporate nel file XML vengono estratte e associate automaticamente alle domande corrispondenti.

Anche per Moodle al termine dell'elaborazione si apre la finestra di selezione per scegliere quali domande importare.

Come esportare da Moodle

In Moodle vai su Banca domande → Esporta, scegli il formato "Moodle XML" e scarica il file. Poi importalo in TestGENIAL.


15

Scegliere il layout

TestGENIAL offre 6 layout predefiniti che combinano tre variabili: numero di colonne, orientamento delle opzioni e presenza del bordo attorno al foglio.

1
2 colonne con bordo
Due colonne, bordo esterno
2
2 colonne
Due colonne, senza bordo
3
Opzioni in verticale con bordo
1 colonna, opzioni su righe separate, bordo esterno
4
Opzioni in verticale
1 colonna, opzioni su righe separate, senza bordo
5
Opzioni in orizzontale con bordo
1 colonna, opzioni affiancate, bordo esterno
6
Opzioni in orizzontale
1 colonna, opzioni affiancate, senza bordo
Quale scegliere?

Il layout a 2 colonne (1 o 2) è ideale per test con molte domande chiuse: occupa meno spazio. Il layout a 1 colonna (3 o 4) è migliore per test con domande lunghe o con immagini. Usa l'anteprima per vedere il risultato prima di generare il PDF definitivo.

Font

Puoi scegliere la dimensione del carattere tra quattro opzioni: Piccolo, Medio (default), Grande e Molto grande. È disponibile anche la selezione della famiglia del carattere. Valori più piccoli consentono di comprimere un test lungo in meno pagine; valori più grandi migliorano la leggibilità.


16

Anteprima

Prima di generare il PDF definitivo puoi visualizzare un'anteprima rapida della prima versione del test. Il suo scopo principale è verificare il numero di pagine che il test occuperà una volta stampato, in modo da aggiustare layout o dimensione del font se necessario.

Attenzione

Nell'anteprima le immagini appaiono come spazi bianchi: non è un errore, ma una caratteristica della modalità rapida. Le immagini saranno presenti correttamente nel PDF finale.

Consiglio

Se il test occupa più pagine del previsto, prova a passare al layout a 2 colonne o a ridurre la dimensione del font.


16

Versioni e allievi

Numero di versioni

Specifica quante versioni diverse del test generare, fino a un massimo di 5. Per ogni versione, TestGENIAL calcola una permutazione diversa dell'ordine delle opzioni. Se attivi l'opzione Ruota domande, viene ruotato anche l'ordine delle domande tra le versioni: in questo caso il numero di versioni diverse generabili è teoricamente una per ogni allievo, rendendo praticamente impossibile la copia.

Numero di allievi

Inserisci il numero totale di studenti in classe. TestGENIAL distribuisce automaticamente le versioni: i fogli nel PDF vengono ordinati in modo che studenti seduti vicini abbiano versioni diverse.

Come funziona la distribuzione

Il PDF finale contiene i fogli in sequenza alternata per versione. Basta stampare e distribuire nell'ordine: studenti vicini riceveranno automaticamente versioni diverse.


17

Generare PDF ed Excel

Quando il test è pronto, clicca Genera PDF. Il sistema:

  1. Verifica che tutte le domande non vuote siano compilate correttamente.

  2. Avvia la compilazione del PDF con tutte le versioni, garantendo sempre un numero pari di pagine per ogni versione, ottimizzato per la stampa fronte-retro.

  3. Genera il foglio Excel con chiavi di correzione e punteggi — sempre, indipendentemente dal formato scelto.

  4. Avvia automaticamente il download di entrambi i file.

  5. Mostra una finestra non chiudibile che ti ricorda di salvare anche il file .tgen per poter rigenerare il test in futuro.

Domande in rosso

Per poter generare il PDF, ogni domanda compilata deve essere almeno in stato giallo. Una domanda rimane rossa se mancano almeno due opzioni oppure se nessuna opzione è segnata come corretta. Risolvi queste situazioni prima di procedere.

Formato di output

Dal selettore accanto al pulsante Genera puoi scegliere il formato:

FormatoUtilizzo
PDFIl formato standard, pronto per la stampa. Sempre accompagnato dal foglio Excel.
LaTeXFile sorgente .tex, per chi vuole modificarlo manualmente. Anche in questo caso il foglio Excel viene generato.

19

Somministrazione e correzione

Distribuire i fogli in classe

Il PDF generato contiene tutti i fogli in sequenza, già ordinati per la distribuzione. Stampando fronte-retro e distribuendo nell'ordine, gli studenti seduti vicini ricevono automaticamente versioni diverse. Non è necessario fare nulla di manuale: basta stampare e distribuire in fila.

Ogni foglio riporta in cima un ID univoco per quello studente. Questo numero è diverso per ogni allievo e serve per identificare la versione del test durante la correzione.

Con rotazione domande attiva

Se hai generato il test con la rotazione domande, ogni allievo ha una versione potenzialmente unica. L'ID sul foglio è ancora più importante in questo caso: è l'unico modo per risalire all'ordine esatto delle domande di quello studente.

Il foglio Excel di correzione

Il file Excel scaricato insieme al PDF è lo strumento per correggere le verifiche e calcolare i voti. È composto da due fogli visibili: RISPOSTE e RISULTATI.

Foglio RISPOSTE

Qui trascrivi le risposte degli studenti dopo che hanno consegnato il foglio. Per ogni studente trovi una riga con:

  1. ID allievo — va inserito manualmente: è il numero univoco stampato sul foglio della prova di ogni studente, diverso per ciascuno.

  2. Versione (VER) — calcolata automaticamente dal sistema a partire dall'ID inserito. Non va compilata a mano.

  3. Nome studente — precompilato con "ALLIEVO 1", "ALLIEVO 2"… da sostituire con i nomi reali.

  4. Risposte (1–30) — inserisci la lettera della risposta data dallo studente (A, B, C…) per ciascuna domanda.

Come leggere l'ID

Ogni foglio consegnato dallo studente riporta un numero ID univoco. Inseriscilo nella colonna ID: il foglio calcolerà automaticamente la versione corrispondente e troverà la chiave di correzione giusta.

Foglio RISULTATI

Non richiede nessun inserimento manuale: si aggiorna automaticamente non appena compili il foglio RISPOSTE. Per ogni studente mostra il voto finale calcolato automaticamente e il dettaglio domanda per domanda.

Domande aperte

Il foglio è predisposto anche per le domande aperte. Il punteggio delle risposte aperte non può essere calcolato automaticamente: va inserito manualmente dall'insegnante per ogni studente, dopodiché il voto finale viene ricalcolato includendo anche quelle domande.

Personalizzare la scala voti

In cima al foglio RISULTATI trovi due celle modificabili: VOTO MIN e VOTO MAX. Cambia questi valori per adattare il calcolo alla tua scala (es. 0–10, 1–10, 0–100). Tutti i voti si aggiornano istantaneamente.


22

Segnalazioni e feedback

Hai trovato un bug? Vuoi suggerire una funzione? Clicca il pulsante rosso circolare fisso in basso a destra nello schermo. Si apre una finestra dove puoi classificare la segnalazione (Bug, Suggerimento, Altro) e descrivere il problema liberamente. Ogni segnalazione riceve un numero progressivo.