TAO Community Edition: Guida all'installazione della piattaforma

Contenitore

TAO CE supporta l'implementazione delle proprie risorse come container (utilizzando Docker) per lo sviluppo e la valutazione locali.

Requisiti

Installa Docker. Visita Ottieni Docker per installare Docker per il tuo ambiente.
Se utilizzi Docker Desktop, assicurati di allocare almeno 4 GB di memoria. Puoi regolare l'utilizzo della memoria in Docker Desktop andando su Impostazioni > Risorse.

Recupera e distribuisci il contenitore con TAO CE

1. Estrai e configura il container richiesto:
   1. IMPORTANTE: rimuovere eventuali contenitori, volumi e immagini TAO CE precedentida Docker se TAO CE è stato installato in precedenza.
   2. Scarica un archivio .ZIP con il docker-compose.tao-ce.yaml file:
      https://gist.github.com/tao-community-edition/5ac924d5021aa2d7d3635064edc0e752/archive/eb21e720043a3278655516ae1e5993ef6ca2e3f4.zip e decomprimilo
   3. Apri un terminale/shell e vai alla cartella in cui hai decompresso il file.
   4. Esegui questo comando:

      docker compose -f docker-compose.TAO-ce.yaml up -d

   5. attendere che tutti i volumi siano stati creati e tutti i container avviati. 
      
   6. (facoltativo, ma consigliato) 
      1. Su sistemi Linux e Mac:
         modifica il tuo file /etc/hosts e aggiungi la seguente riga:
         0.0.0.0 community.TAO.internal 
      2. Sui sistemi Windows:
         Modifica il tuo C:\Windows\System32\drivers\etc\hosts e aggiungi la seguente riga:
         127.0.0.1 community.TAO.internal 
   7. apri il browser e vai su https://community.tao.internal/. Potresti ricevere un avviso relativo alla mancanza di un certificato adeguato per la pagina. 
      1. Se ciò dovesse accadere, clicca su Advanced (presentato qui per il Chrome browser)
         
         

      2. Quindi ignorare l'avviso e Procedere a community.TAO.internal
         

   8. ora puoi effettuare il login con amministratore / password
      

Azione immediata richiesta: modifica delle password

Per motivi di sicurezza, è necessario modificare immediatamente le password predefinite.

Modifica della password amministratore

1. Clicca sul tuoavatar utente(in alto a destra).
2. InIl mio account, clicca suIl mio utente.
3. Clicca suModifica password.
4. Scegli una password sicura (almeno 8 caratteri, con almeno una lettera minuscola, una maiuscola e un numero o simbolo).
5. Fai clic suSalva modifiche.

Si noti che potrebbe essere visualizzato un avviso che indica che la password non è sufficientemente sicura, nonostante siano state rispettate le restrizioni consigliate. È possibile ignorarlo, poiché si tratta di un problema noto che verrà risolto in una versione futura.

Modifica delle password dei candidati (utenti: demo01 – demo05, password predefinita: password)

1. Vai al Utenti .
2. Individua gli utenti con il ruolo di partecipante al test (demo01 – demo05).
3. Per ogni utente, apri il menu contestuale (hamburger) → Modifica.
4. Clicca Cambia password.
5. Imposta una password sicura (stessi criteri di cui sopra).
6. Clicca Salva modifiche.

Aspettative di rendimento

• Utenti simultanei: il sistema è stato testato con successo con 500 partecipanti simultanei, con un aumento di 25 utenti al secondo. Tutti i 500 partecipanti hanno inviato con successo i propri test.
• Lentezza nel login:
  • Con 500 candidati contemporaneamente, si è osservata una notevole lentezza durante il login (1-2 minuti), ma alla fine i candidati sono riusciti ad accedere con successo.
  • Con 200 candidati contemporaneamente, la lentezza del login era accettabile (massimo 7 secondi).

Cosa fare dopo

Dopo l'installazione e la modifica della password, segui questi passaggi per creare e inviare un semplice test.

Preparare i contenuti (elementi e test)

1. Dal Portale, clicca su banca dei contenuti .
2. Vai al Items tab.
   1. Crea cartelle e elementi secondo necessità. Consulta la User Guide per sapere come fare.
3. Passa al Test tab.
   1. Crea un nuovo test. Consulta la User Guide per sapere come fare.
   2. Aggiungi gli elementi che hai creato.
4. Pubblica il test come nuova consegna selezionandolo e facendo clic su Pubblica. 

Controllare la  User Guide per sapere come fare.

Crea un gruppo

Un gruppo è un insieme di utenti, ciascuno con un proprio ruolo. I gruppi vengono solitamente utilizzati per raggruppare i partecipanti a un test in base a vari criteri comuni, come l'appartenenza alla stessa classe.

Passaggi:

1. Dal portale, clicca su Gruppi .
2. Clicca Crea gruppo.
3. Compila il campo richiesto:
   1. Nome
4. Passa al Utenti sottoscheda e selezionare dall'elenco esistente degli utenti quelli da aggiungere al gruppo come partecipanti al test
   1. Salva il gruppo.

Per ulteriori informazioni sulla gestione dei gruppi, consultare la User Guide.

Crea una sessione

Una sessione collega:

• a Consegna (test pubblicato) e
• a Gruppo (candidati).

Passaggi:

1. Dall'area di creazione dei test, clicca sulla freccia indietro per tornare alla Portale.
   1. Clicca su Sessioni .
   2. Clicca Crea sessione.
   3. Compila i campi richiesti:
      1. Nome della sessione
      2. Gruppo (puoi usare il gruppo che hai creato sopra)
      3. Delivery (seleziona la delivery che hai pubblicato in precedenza)
   4. Salva la sessione.

Per ulteriori informazioni sulla gestione delle sessioni, consultare la User Guide.

Simula un candidato

1. Esci dall'account amministratore.
2. Per tua comodità, sono già stati creati diversi utenti da utilizzare come candidati. Accedi come uno degli utenti candidati di cui hai modificato la password (ad esempio, demo01).
3. Nell'elenco delle sessioni, trova la sessione appena creata.
4. Clicca Avvia.
5. Completa il test.

Valutare i risultati dei test

1. Esci dall'account del candidato.
2. Effettua nuovamente l'accesso come utente amministratore.
3. Vai a Sessioni.
4. Trova la tua sessione e clicca Accedi alla sessione.
5. Per tutti i candidati che hanno completato la sessione, cliccare su Rivedi test per visualizzare i risultati.

Altre risorse pertinenti

• Sito web della TAO Community
• TAO User Guide
• TAO Knowledge Base
• Forum della Community TAO

Problemi noti

I seguenti problemi sono noti nell'attuale versione TAO CE (2025.10). Si prevede di risolverli in una delle prossime versioni.

Problema	Soluzione alternativa / Note
La Text-to-Speech non funziona per il candidato	Non è ancora disponibile alcuna soluzione alternativa.
La scheda Utilizzodegli articoli non funziona	Non è ancora disponibile alcuna soluzione alternativa.
La scheda delle statistichedegli oggetti non funziona	Non è ancora disponibile alcuna soluzione alternativa.
La modifica della password dell'utente correntegenera un errore relativo al mancato rispetto dei vincoli, nonostante questi siano stati rispettati.	Ignora l'avviso, poiché la password viene effettivamente aggiornata con successo se i vincoli sono soddisfatti.