O histórico de versões permite voltar o programa base a um estado anterior e escolher qual versão será sincronizada com os alunos que receberam esse programa.
Use esse recurso quando uma alteração não ficou como esperado, quando quiser recuperar uma estrutura anterior ou quando precisar atualizar as cópias já atribuídas aos alunos.
Antes de começar
- O histórico pertence ao programa base da sua biblioteca.
- O rascunho registra o trabalho em andamento; uma versão publicada é o marco que pode ser restaurado e sincronizado.
- Restaurar muda o programa base, mas não atualiza automaticamente todas as cópias já atribuídas.
- Para atualizar alunos, use a ação Sincronizar depois de revisar o impacto.
Se você abriu o editor de um programa já associado a um aluno específico, está editando a cópia desse aluno. Esse fluxo não é o mesmo que o histórico do programa base.
Como restaurar uma versão no painel web
- Abra o programa base no editor.
- No topo da tela, clique em Versões.
- Escolha Histórico de Versões.
- Abra a versão que deseja recuperar.
- Clique em Restaurar.
- Revise o aviso, informe um motivo se quiser e confirme a restauração.
O selo Atual identifica o marco que o programa base usa neste momento. Abra outra versão para revisar as ações disponíveis.
A restauração não apaga a versão atual nem reescreve uma versão antiga. O TreinoAI cria uma nova versão, marcada como restaurada, e ela passa a ser a versão atual do programa.
Se a versão usa um exercício excluído, ausente ou pertencente a outra equipe, a restauração é bloqueada. Substitua o exercício indicado antes de tentar novamente.
Como sincronizar uma versão com os alunos no painel web
- Abra Versões > Sincronizar com Clientes para usar a versão atual; ou abra o histórico e clique em Sincronizar na versão desejada.
- Confira os alunos e o impacto apresentado para cada cópia do programa.
- Selecione quem deve receber a atualização.
- Revise os avisos e confirme a sincronização.
Na imagem:
- as atribuições são agrupadas pelo estado de sincronização;
- Sincronizar só deve ser usado depois de revisar os clientes e os avisos.
O painel pode mostrar estes estados:
| Estado | O que significa |
|---|---|
| Pode sincronizar | A cópia pode receber a versão selecionada. |
| Na fila | O programa ainda não começou; o snapshot da fila será atualizado. |
| Personalizado | A cópia tem edições próprias; sincronizar substituirá essas edições. |
| Já atualizado | O aluno já usa a versão selecionada. |
| Bloqueado | A posição atual do programa não permite aplicar essa versão com segurança. |
Sessões concluídas, em andamento ou puladas são preservadas. O TreinoAI atualiza a parte pendente que ainda pode ser regenerada. Lacunas pendentes que ficam antes do progresso já registrado também são preservadas.
Como usar no app do treinador
-
Abra o programa base no editor mobile.
-
Toque no ícone de Histórico de versões no cabeçalho.
-
Selecione uma versão.
-
Use Rollback para restaurar ou Sincronizar para atualizar as atribuições do programa.
No app, a sincronização atual usa as atribuições ligadas ao programa. Para escolher alunos individualmente e revisar o impacto de cada cópia antes de confirmar, prefira o painel web.
Cuidados importantes
- Leia o aviso de uma cópia Personalizada: a sincronização remove as edições específicas daquela atribuição.
- Restaurar o programa base e sincronizar alunos são duas ações separadas.
- Não tente contornar um bloqueio removendo o histórico; corrija o exercício ou a estrutura indicada.
- Confira a versão marcada como Atual antes de sincronizar em lote.
Problemas comuns
| Situação | O que fazer |
|---|---|
| Não aparece nenhuma versão | O programa ainda não tem uma versão publicada no histórico. Conclua a publicação do programa e tente novamente. |
| A opção Restaurar não aparece | A versão selecionada já pode ser a atual. Escolha uma versão histórica. |
| A restauração foi bloqueada por exercício | Substitua o exercício indisponível por um item da biblioteca da equipe ou da biblioteca master. |
| O aluno não recebeu a mudança | Publicar ou restaurar o programa base não atualiza a atribuição sozinho. Abra Sincronizar com Clientes e confira o resultado. |
| O aluno aparece como Personalizado | Decida se pode substituir as edições específicas. Se não puder, não selecione essa atribuição. |
| O aluno aparece como Já atualizado | Nenhuma ação é necessária para essa versão. |
| O aluno aparece como Bloqueado | Respeite o motivo exibido e mantenha a cópia atual até corrigir a estrutura do programa. |