Revisão: aprovar e publicar um Programa de aprendizagem

Rota: aprendizagem/revisao · Onde: menu › Programas › Revisão (só para o head coach)

Visão geral

A Revisão é onde o head coach decide o que chega ao atleta num Programa de aprendizagem. Um coach escreve o Programa no Construtor e o envia para revisão (27 · Programas de aprendizagem); aqui você lê o que aquele envio muda desde a versão publicada e dá o veredito: aprovar e publicar a versão nova, ou pedir ajuste com uma nota para quem escreveu. Abaixo da fila ficam os Programas já publicados, onde você decide quem aparece na vitrine.

📐 Regra de negócio

coach escreve, head coach aprova e publica. O Programa vai inteiro, como uma versão, depois do checklist de envio. Só o head coach aprova, pede ajuste e mexe na vitrine. Qualquer outro coach que abrir a tela lê a fila e o que cada envio muda, sem as ações.

Nota

a Revisão aparece no seu Coach onde a Impacto abriu os Programas de aprendizagem.

Quando usar

• Quando o número ao lado de Revisão, no menu, mostrar Programas esperando você.
• Quando um coach avisar que enviou um Programa, ou uma versão nova de um Programa já publicado.
• Quando quiser tirar um Programa publicado da vitrine, ou voltar com ele.
• Quando for vender um Programa publicado: a caixa Venda mora aqui (26 · A venda na loja do atleta).

Pré-requisitos

• Ter o perfil Head Coach para aprovar, pedir ajuste e mexer na vitrine. Criador de treinos e Visualizador não veem o item no menu; se chegarem à tela por um link, leem.
• Ter um Programa enviado para revisão. O envio só sai com o checklist de envio em dia, no Construtor (27 · Programas de aprendizagem).

Passo a passo (por região)

O item Revisão no menu

📸 Screenshot pendente

assets/28-revisao-menu.png — o grupo Programas do menu com Revisão e o número de Programas esperando.

O item fica no grupo Programas, entre Construtor e Painel, e só aparece para o head coach. O número ao lado conta os Programas esperando revisão. Ele é lido quando você entra no Coach e de novo a cada envio ou veredito, e acompanha a fila enquanto a tela está aberta. Sem nada esperando, o número some.

Dica

a busca rápida (Ctrl+K) também abre a Revisão: digite revisão, aprovar ou vitrine.

A fila: Esperando você

📸 Screenshot pendente

assets/28-revisao-fila.png — a coluna da esquerda com Esperando você (dois Programas) e, abaixo, Publicados · vitrine.

1. Na coluna da esquerda, a caixa Esperando você lista os Programas enviados, o enviado há mais tempo primeiro. Cada linha diz o nome e a versão (Double Under · v2), quem enviou e quando (enviada em dd/mm às hh:mm, ou só às hh:mm quando foi hoje).
2. A tela já abre no primeiro da fila. Clique em outra linha para ler outro envio.
3. O endereço da página guarda o Programa que está aberto: recarregar ou compartilhar o link volta nele.

Para quem não é head coach, a caixa se chama Esperando o head coach, e uma faixa Leitura no topo diz que só o head coach aprova, pede ajuste e mexe na vitrine.

O envio: cabeçalho e as quatro placas

📸 Screenshot pendente

assets/28-revisao-placas.png — o cabeçalho de um envio (Revisão · v2 · enviada por …) com Abrir no Construtor e as quatro placas, com Atletas no meio · 2.

No alto, a linha pequena diz Revisão · vN · enviada por quem enviou; embaixo do nome, o tema, os níveis, as etapas, as aulas e o autor. O botão Abrir no Construtor abre o Programa inteiro para ler.

As quatro placas resumem o envio. Elas mudam conforme a versão:

Versão	Placas
Primeira versão (nada publicado ainda)	Níveis, Etapas (cada uma fecha num marco), Aulas (com quantas são Verificações) e Atletas no meio
Versão nova de um Programa publicado	Aulas novas e Aulas editadas (com o nível e as etapas onde estão), Aulas removidas (viram histórico de quem fez) e Atletas no meio

Atletas no meio responde “quem vai encontrar a versão nova no meio da trilha”. Com alguém, a placa diz leem a versão nova na próxima aula; com ninguém, ninguém no meio da trilha. Na primeira versão é sempre 0: primeira versão: ninguém começou. Pare o mouse sobre a placa para ler a regra.

📐 Regra de negócio

quem conta como “no meio”. O atleta ativo que já começou a volta atual num nível que ele tem — com alguma aula registrada, feita ou não — e ainda tem aula a fazer nesse nível. Ficam de fora quem se inscreveu e não registrou nada (a primeira aula dele já é lida da versão nova), quem terminou tudo o que tem, o progresso num nível que deixou de ter, quem só deixou para trás a Verificação final dispensada e o perfil desativado.

O que mudou

📸 Screenshot pendente

assets/28-revisao-mudancas.png — a lista Mudanças desde a v1 com uma linha Ficha, linhas Nova, Editada e Removida, e o estado Checklist em dia no canto.

1. A caixa se chama Mudanças desde a vN (a versão publicada mais nova) ou, na primeira, Primeira versão · o que vai ao ar. No canto, Checklist em dia ou Checklist · N pendências.
2. Leia as linhas, nesta ordem:
   • Ficha — algo mudou na Ficha do Programa: nome, tema, resultado, público, pré-requisito, material, ritmo ou autor;
   • Nova — uma aula nova, com o lugar no mapa (RX · 2.3 · Double under em série) e o que ela tem (25 min · 2 blocos · 3 critérios). Uma etapa inteira nova vira uma linha só (Scaled · Etapa 1 · Ritmo — 5 aulas · 1 Verificação); na primeira versão, a lista inteira é assim, por etapa;
   • Editada — uma aula que já existia e foi reescrita;
   • Removida — uma aula que saiu, com quem fez mantém no histórico.
3. Clique numa linha Nova ou Editada para abrir aquela aula no Construtor, só para ler.

Cuidado

a lista diz que a aula mudou, não o quê. Para ver o campo, o bloco ou o critério, abra a aula. E a lista ainda não mostra mudança na ordem das aulas nem no nome, no marco ou no vídeo de uma etapa: se nada aparecer, a caixa avisa “Nenhuma aula nova, editada ou removida. O que mudou pode ser a ordem das aulas, ou o nome, o marco ou o vídeo de uma etapa — que esta lista ainda não mostra.” Use Abrir no Construtor.

Ler no Construtor sem pegar a vez

📸 Screenshot pendente

assets/28-revisao-leitura.png — o Construtor aberto pela Revisão, com a faixa Leitura · revisão e Voltar à revisão.

Abrir no Construtor e as linhas da lista abrem o Programa com a faixa Leitura · revisão: “Você está lendo o Programa sem pegar a vez de editar: nada do que abrir aqui muda o envio.” Ande pelo mapa à vontade; a leitura continua em cada aula que abrir. Clique em Voltar à revisão para voltar ao mesmo Programa na fila.

📐 Regra de negócio

ler não tranca o autor. Pela Revisão, o Construtor não pega a vez de editar: o autor continua livre, e o envio não muda. Aprovar e pedir ajuste ficam na Revisão.

O veredito: pedir ajuste ou aprovar

📸 Screenshot pendente

assets/28-revisao-veredito.png — a caixa do veredito com o comentário preenchido, o contador e os botões Pedir ajuste e Aprovar e publicar v2.

Para pedir ajuste:

1. No campo Comentário para quem enviou, escreva o que precisa mudar antes de publicar (até 500 caracteres; o contador fica embaixo, à direita).
2. Clique em Pedir ajuste.
3. A faixa verde Ajuste pedido confirma: ”… voltou para … com a sua nota. Ele aparece de novo aqui quando for reenviado.” O Programa sai da fila e volta a rascunho.

Nota

quem escreveu lê a nota no Construtor, acima do Programa, na faixa Ajuste pedido — “O head coach pediu: …” —, até enviar de novo.

Para aprovar e publicar:

1. Leia a frase acima dos botões: na primeira versão, “Aprovar publica a v1, a primeira, e põe o Programa na vitrine.”; numa versão nova, “Aprovar publica a vN para todos. Quem está no meio segue da aula em que parou.”
2. Clique em Aprovar e publicar vN.
3. Na confirmação Publicar a vN de …?, confira o que acontece:
   • a vN vira a versão que os atletas leem e fica guardada como está — uma alteração depois disso já é o rascunho da versão seguinte;
   • numa versão nova, quem está no meio segue da aula em que parou, e a aula removida vira histórico de quem fez;
   • a vitrine: na primeira versão, “o Programa entra na vitrine”; nas seguintes, ele continua onde você deixou — na vitrine ou fora dela.
4. Clique em Aprovar e publicar vN de novo para confirmar, ou Voltar.
5. A faixa verde Publicado · vN confirma: ”… vN é a versão que os atletas leem agora.” A tela volta ao topo da fila, e o número do menu baixa.

📐 Regra de negócio

vale a versão publicada mais nova. Publicar troca a versão de todos de uma vez. O progresso do atleta fica preso à aula, não à versão: quem está no meio não perde nada e segue da aula em que parou, lendo já a versão nova. Uma aula removida sai do Programa, mas continua no histórico de quem a fez.

📐 Regra de negócio

aprovar não devolve à vitrine. Só a primeira aprovação põe o Programa na vitrine. Se você o retirou, as versões seguintes são publicadas para quem já tem e ele continua fora: “O Programa continua fora da vitrine: aprovar não o devolve a ela.”

Cuidado

pedir ajuste exige a nota. Sem texto, o campo diz “Escreva o que precisa mudar: o pedido de ajuste vai com esta nota.”, e nada é enviado. Aprovar não leva nota.

Publicados · vitrine

📸 Screenshot pendente

assets/28-revisao-vitrine.png — a caixa Publicados · vitrine na coluna da esquerda e, à direita, a caixa Vitrine de um Programa publicado com Retirar da vitrine.

1. Abaixo da fila, a caixa Publicados · vitrine lista todo Programa com versão publicada: o nome, a versão no ar e Na vitrine ou Fora da vitrine. Se uma versão nova dele estiver esperando, a linha diz vN em revisão; senão, o autor.
2. Clique num Programa publicado. Se ele não está na fila, o alto da tela diz Fora da fila e por quê: “Devolvido com um pedido de ajuste: …”, “O rascunho da próxima versão ainda não foi enviado. Ele aparece na fila quando for.” ou “Nada novo desde a vN.”
3. Na caixa Vitrine, leia onde ele está e:
   • clique em Retirar da vitrine e confirme em Retirar … da vitrine? › Retirar da vitrine; ou
   • clique em Voltar à vitrine, que vale na hora, sem confirmação.

📐 Regra de negócio

retirar da vitrine não corta quem tem direito, e pede confirmação. O Programa deixa de aparecer para quem ainda não o tem. Quem já tem acesso — por compra, cortesia ou Squad — continua com ele, com o progresso e com as versões novas que você aprovar. Dá para voltar à vitrine a qualquer momento, daqui mesmo.

A caixa Vitrine também aparece embaixo do veredito, quando o Programa em revisão já tem uma versão publicada.

Venda

Na organização que vende na loja, um Programa publicado tem, embaixo da Vitrine, a caixa Venda: preço por nível, Programa completo, duração do acesso e parcelas. Ela fica fora da ficha — mudar a venda não cria versão nem tira o Programa da revisão. Tudo sobre ela está em 26 · A venda na loja do atleta.

Campos & validações

Campo	O que é	Obrigatório	Regra
Comentário para quem enviou	a nota que volta com o pedido de ajuste	só para Pedir ajuste	até 500 caracteres; vazio, o pedido não sai
Aprovar e publicar vN	publica o envio como a versão N	—	pede confirmação; só para o head coach
Retirar da vitrine	tira o Programa da vitrine	—	pede confirmação; só para o head coach
Voltar à vitrine	devolve o Programa à vitrine	—	direto, sem confirmação; só para o head coach

Estados

O Programa tem três estados, que a lista de Programas e o Construtor mostram no selo com a versão (27):

Selo	Quer dizer	Na Revisão
Rascunho · vN	a vN está sendo escrita e não foi enviada	não está na fila; se já tem versão publicada, aparece em Publicados · vitrine
Em revisão · vN	a vN foi enviada e espera o head coach	na fila Esperando você
Publicado · vN	a vN é a que os atletas leem, e não há nada novo	em Publicados · vitrine

• Fila vazia: a caixa diz “Nenhum Programa esperando revisão.”, e à direita Nada esperando revisão — “Quando um coach enviar um Programa, ele aparece aqui com o que mudou desde a versão publicada.”
• Carregando: a moldura da tela aparece parada enquanto a fila e o Programa abrem.
• Erro ao abrir a fila: Erro · não carregou, com o motivo e Tentar de novo. Se só a lista de publicados falhar, a fila continua de pé.
• Erro ao abrir um Programa: Erro · não abriu, com o motivo e Tentar de novo.
• Aberto para edição: o autor está com a vez de editar enquanto você revisa. A faixa diz quem e desde quando, e avisa: “Se uma alteração for salva antes do seu veredito, o Programa volta para rascunho e sai desta fila.”
• Leitura: para quem não é head coach, a faixa Leitura no topo, sem os botões do veredito e da vitrine.
• Erro no veredito ou na vitrine: Erro · não publicou, Erro · não devolveu, Erro · não mudou ou Erro · não retirou, com o motivo. A tela relê o Programa.

Dicas

Dica

comece pela placa Atletas no meio. Com gente no meio, uma aula reescrita muda o que alguém lê já na próxima aula. Abra as linhas Editada daquele nível antes de aprovar.

Dica

escreva a nota como um passo. “Scaled · 1.2: falta o vídeo do kip. Troque o critério 2 por marca medida.” rende mais do que “revisar etapa 1”: o autor lê a nota acima do Programa enquanto corrige.

Dica

para parar de oferecer um Programa, use a vitrine. Retirar não mexe em quem já tem, e volta com um clique.

Erros comuns / troubleshooting

Sintoma	Causa	O que fazer
“Não vejo Revisão no menu.”	Seu perfil não é Head Coach.	Só o head coach revisa. Peça a ele, ou abra a tela por um link para ler.
“Abri a Revisão e não tenho os botões.”	Você está em Leitura: só o head coach dá o veredito.	Nada a fazer: a fila e as mudanças continuam legíveis.
“Fui aprovar e deu Este Programa não está em revisão: ninguém o enviou ao head coach.”	O autor salvou uma alteração depois do envio, e o Programa voltou a rascunho.	Recarregue a fila. Ele volta quando o autor enviar de novo.
“A placa diz Aulas editadas · 0, mas o autor disse que mudou.”	A mudança foi na ordem das aulas, ou no nome, no marco ou no vídeo de uma etapa, que a lista ainda não mostra.	Clique em Abrir no Construtor e confira o mapa.
“Aprovei e o Programa não apareceu na vitrine.”	Ele tinha sido retirado: aprovar não o devolve.	Na caixa Vitrine, clique em Voltar à vitrine.
“Pedir ajuste não sai.”	O comentário está vazio ou passou de 500 caracteres.	Escreva o que precisa mudar, em até 500 caracteres.
“Abri a aula pela Revisão e não consigo editar.”	Pela Revisão, o Construtor só lê, para não trancar o autor.	Para editar, abra o Programa pelo menu Programas — e lembre que salvar uma alteração tira o envio da fila.
“Só o head coach aprova, pede ajuste ou mexe na vitrine de um Programa.”	Seu perfil não é Head Coach.	Peça ao head coach.

Como o atleta vê

👤 Como o atleta vê

nada muda no app enquanto o Programa espera revisão: o atleta só lê a versão publicada. Quando você aprova, a versão nova vale para todos: quem está no meio segue da aula em que parou e já lê a aula como você aprovou, e uma aula removida some da trilha, mas continua no histórico de quem a fez (Treinos, no app do atleta). Fora da vitrine, o Programa deixa de aparecer para quem ainda não o tem; quem já tem não percebe diferença. O app nunca mostra preço, botão nem link de compra.

Para acompanhar quem está em cada aula depois de publicar, use o Painel do Programa (29 · Painel do Programa).