Programas

Onde: menu › Treino › Programas

Visão geral

O catálogo da organização — o que cada atleta recebe todo dia. É aqui que você vê todos os programas de uma vez, cria um novo, publica, olha quem está matriculado em cada um e, quando a temporada acaba, faz um programa parar de entregar sem apagar o treino que ele já entregou.

A divisão de trabalho com o Construtor é simples:

Tela	Responde
Construtor	o que tem dentro do programa — as semanas, os dias, as sessões, os blocos
Programas	o programa como ativo da organização — quem o recebe, se ele aparece na vitrine, quando ele para, e se ele deixa de existir

Nota

a entrada aparece para Head Coach e Criador de treinos. Quem tem perfil Visualizador não vê “Programas” no menu — a tela inteira é de autoria. A exclusão definitiva é mais restrita ainda: só o head coach.

Quando usar

• Para achar um programa entre muitos: por escopo, por foco, por nível, pelo nome do atleta.
• Para criar um programa novo, ou repetir um que deu certo com “Criar a partir deste”.
• Para saber quem está matriculado antes de mexer em alguma coisa.
• Quando um ciclo termina e o programa não deve mais montar o dia de ninguém.
• Para limpar uma duplicata criada por engano — e só ela.

Pré-requisitos

• Perfil de acesso Head Coach ou Criador de treinos (Cap. 17).

Passo a passo (por região)

As duas abas: Ativos e Desativados

📸 Screenshot pendente

assets/20-programas-lista.png — as abas, os chips de escopo, a busca e a grade de cards.

No topo, duas abas com contagem: Ativos · N e Desativados · N. Um programa cai numa ou na outra pela única pergunta que importa aqui: ele ainda monta o dia de alguém?

Dica

trocar de aba zera o chip de escopo e volta para a primeira página. É de propósito: um filtro cheio de um lado costuma estar vazio do outro, e um filtro que você não vê escondendo tudo parece uma lista quebrada.

Chips de escopo e busca

Cinco chips, cada um com a contagem da aba em que você está: Todos, Sistema, Públicos, Específicos e Individuais. São os mesmos quatro escopos do explorador do Construtor (7.1) — passe o mouse em cada chip para ler o que ele significa.

Ao lado, a busca: “Nome, foco, nível ou atleta…”. Ela varre título, headline, foco, nível, o nome do atleta dono e o nome do coach que criou, ignorando acento. Digitar mais de uma palavra estreita: todas precisam bater.

O card do programa

Cada card carrega, de cima para baixo:

Região	O que mostra
Capa	a foto do programa, ou a placa diagonal da marca quando não há foto
Badge de escopo	Sistema · Impact/Elite · Público · Específico · Individual · nome do atleta
Badge de estado	Publicado · Rascunho · Desativado · DD/MM
Texto	título, headline e a linha Nível · N sem (com · dinâmico quando o programa corre sem fim)
Linha de matriculados	“96 atletas matriculados” e, à direita, recebendo / ninguém ainda / parados

Clicar no corpo do card (capa, texto ou linha de matriculados) abre a página do programa. A barra de baixo nunca navega — ela age:

• Abrir no Construtor — leva à semana que está no ar. Em programa desativado o botão vira Reativar.
• Olho — publica ou despublica na hora. Aceso significa publicado.
• O menu de ações, no fim da linha.

Nota

a contagem de matriculados aparece como — por um instante, enquanto é lida. Um traço quer dizer “ainda não sei”, nunca “zero”.

O menu de ações

Quatro ações, e só quatro — o resto mora na página do programa, ao lado da explicação de cada consequência:

1. Página do programa — dados, matriculados, histórico e ciclo de vida.
2. Ver matriculados — abre a gaveta.
3. Criar a partir deste — abre o formulário já preenchido com os dados deste programa.
4. Desativar — ou Reativar, se ele já estiver parado.

Num programa de sistema o quarto item lê “Desativar não se aplica” e fica apagado.

A ordem do catálogo — você escolhe

A lista sai na ordem que você escolher, e ela vale em todo lugar que mostra programas: o seletor do Construtor, a lista do atleta, a grade. Não é mais a cronologia.

Na barra de ações de cada card, à esquerda, dois botões: ↑ move o programa para antes, ↓ para depois. Você também pode arrastar o card para a posição que quiser.

📐 Regra de negócio

um programa novo entra no fim. Entrar no topo faria o catálogo se reorganizar sozinho a cada criação — que é exatamente o que a ordem por data fazia.

Nota

os botões movem dentro da lista inteira, não da página. O último card da página 1 descendo vai para a página 2, que é o que “descer” quer dizer numa lista paginada.

Cuidado

os controles só aparecem sem filtro, na aba Ativos. Com busca ou chip de escopo ligados a tela mostra um recorte, e mover dentro dele escreveria posições de programas que você não está vendo. Limpe a busca e volte para Todos para reordenar.

Dica

a ordem começa igual à de hoje — do mais recente ao mais antigo. No primeiro dia nada se mexe; você arrasta a partir do que já conhece.

Nota

se a gravação falhar, a lista volta exatamente ao que era e a faixa diz o motivo. Meia reordenação na tela seria pior que nenhuma. O caso mais comum é outra aba ter criado ou apagado um programa desde que esta tela carregou — recarregue e reordene de novo.

Paginação

Nove cards por página. Embaixo, à esquerda, “Mostrando 1–9 de 15 · página 1 de 2”; à direita, Anterior e Próximo. Mudar de aba, de chip ou de busca volta para a página 1.

Ver matriculados

📸 Screenshot pendente

assets/20-programas-matriculados.png — a gaveta com a lista de atletas e a nota do rodapé.

A gaveta lista quem recebe o programa hoje: iniciais, nome, “Desde 14 ago 2026” e um selo Base ou Adicional (o papel daquela matrícula). No alto, quantas matrículas ativas existem.

No rodapé, a frase que evita o mal-entendido mais caro desta tela:

📐 Regra de negócio

desativar um programa não cancela matrícula nenhuma. O atleta continua no roster, na mensageria, no leaderboard e na aderência. O que para é a entrega do dia. A matrícula é o vínculo do atleta com a organização; desligar um conteúdo não pode apagar a pessoa de metade do sistema.

Novo programa · Editar · Criar a partir deste

📸 Screenshot pendente

assets/20-programas-formulario.png — os quatro painéis do formulário.

As três formas de preencher os dados de um programa usam a mesma tela — e ela é a única que cria programa no sistema. São quatro painéis:

1. Tipo do programa — para quem ele é: Público, Específico ou Individual (a seção abaixo explica cada um). Escolher Individual pede também o atleta.
2. Identidade — Título, Headline, Capa e Metodologia. É o que o atleta lê no card.
3. Como ele corre no tempo — Baseado em tempo (começo e fim) ou Dinâmico (recorrente, segue o calendário). O parágrafo abaixo do seletor explica de onde as métricas do atleta passam a contar em cada caso.
4. Dose e alvo — Nível, Duração (semanas), Foco (separado por vírgula), Competição-alvo e a Âncora.

Nota

a capa agora entra na criação também. Escolha a imagem, enquadre e clique em Usar esta capa: ela fica guardada no navegador e sobe junto assim que o programa é criado. Se o programa nascer e só a imagem falhar, nada se perde — a faixa avisa e você tenta a capa de novo pela página dele.

Os três tipos de programa

O Tipo responde “para quem este programa é?”, e a resposta muda o que acontece com ele no resto do sistema:

Tipo	Para quem	O que acontece
Público	todo mundo	vai para a vitrine quando publicado; uma edição atinge todos os matriculados
Específico	ninguém, diretamente	é o molde de um plano sob medida: matricular um atleta nele clona o programa inteiro e matricula a cópia, deixando o molde intacto
Individual	um atleta só	fica fora da vitrine e só aparece para ele; edite à vontade que nenhum outro atleta é afetado

📐 Regra de negócio

Individual não precisa de Específico. Um plano para uma pessoa só pode nascer assim, direto — escolha Individual, escolha o atleta, pronto. O Específico existe para quando você vai repetir o mesmo plano com vários atletas: ele é o molde que se clona.

📐 Regra de negócio

salvar um Individual já matricula o atleta. Ele passa a receber o programa por cima do programa base dele, sem substituir nada. Trocar o atleta — ou mudar o tipo de volta para Público — encerra a matrícula anterior no mesmo gesto.

Nota

o programa clonado a partir de um Específico também é Individual. Não existe diferença entre “nasceu sozinho” e “veio de um molde”: o que define o tipo é de quem o programa é hoje, não de onde ele veio.

Cuidado

base de tier não muda de tipo. Impact Performance e Elite Performance são sempre públicas — o seletor fica apagado, com o motivo escrito. Para mudar o tipo de uma delas, tire a base do tier na página do programa primeiro.

Dica

“Criar a partir deste” num Individual traz o tipo, mas não o atleta. Um segundo programa para a mesma pessoa, criado sem você pedir, seria o engano fácil aqui: a cópia nasce sem dono e você escolhe de quem ela é.

Cuidado

o quadro de enquadramento desenha, em preto, a barra do título que o cartão do atleta põe sobre a foto. O que ficar debaixo dela não desbota: some. Enquadre rosto, marca e qualquer coisa que precise sobreviver acima dessa barra e dentro da zona segura.

O que acontece ao salvar depende de onde você entrou:

• Criar e montar no Construtor — cria o programa e abre o Construtor na semana 1, para você montar os dias. À direita, o lembrete: “O programa nasce rascunho — invisível na vitrine do atleta.”
• Salvar dados (edição) — volta para a página do programa. “Salvar não mexe nos dias já montados.”

Dica

“Criar a partir deste” não é “Duplicar”. “Criar a partir deste” copia só os dados — título com um — v2 no fim, headline, metodologia, nível, foco — e nada é criado até você salvar; a âncora nasce na segunda que vem. Duplicar, na página do programa, copia o programa inteiro, com todos os dias já autorados. Use o primeiro para começar um plano parecido do zero; o segundo para repetir um plano pronto.

A página do programa

📸 Screenshot pendente

assets/20-programas-pagina.png — o hero com a barra de ações, o painel Dados e a coluna de Histórico e Ciclo de vida.

No topo, a capa em faixa larga: os badges de escopo e estado no canto de cima e, no pé da foto, o título e a headline sobre uma barra preta sólida — a mesma barra que o atleta vê. Abaixo dela, a barra de ações, nesta ordem: Abrir no Construtor · Publicar/Despublicar · Trocar capa · Mover âncora · Duplicar.

Nota

Trocar capa e Mover âncora abrem a mesma tela que o Editar do painel Dados — o formulário —, porque os três campos moram lá. Programas consumidos, Definir base de tier e Atribuir a atleta saíram da barra: os dois primeiros são os painéis Composição e Alcance, logo abaixo, e o terceiro virou o Tipo do programa, no formulário.

Embaixo, quatro painéis:

• Dados — tipo, nível, no tempo, duração, semana no ar (ou parou na semana), âncora, foco, competição-alvo, programas consumidos, quem criou, quando, e matrículas ativas. Ao lado do título, Editar abre o formulário.
• Matriculados — a mesma lista da gaveta, com a nota que muda quando o programa está desativado: “Estes atletas continuam matriculados — o programa só parou de montar o dia deles em DD/MM/AAAA.”
• Histórico — o trilho de auditoria do programa: data, o que foi feito e por quem — criou, editou os dados, moveu a semana 1, mudou os programas consumidos, publicou, montou um dia, desativou, reativou.
• Composição — os programas que este consome antes de montar o dia, na ordem.
• Alcance — o tipo do programa, com um Editar que abre o formulário, e o Padrão do tier, que é a única coisa desta caixa que se muda aqui mesmo.
• Ciclo de vida — a caixa que explica o estado atual em uma frase antes de oferecer qualquer botão.

📐 Regra de negócio

um lugar só decide o tipo. Ele se escolhe no formulário, junto do resto dos dados; a caixa Alcance apenas o mostra. O switch Modelo específico e a ação Atribuir a atleta, que escreviam a mesma coisa por dois caminhos diferentes, deixaram de existir.

Cuidado

num programa desativado a barra de ações mostra apenas Duplicar. Não é tela quebrada: programa parado não aceita escrita nenhuma — nem autorar dia, nem matricular, nem publicar, nem virar componente de outro. Para voltar a mexer, reative primeiro.

Desativar

📸 Screenshot pendente

assets/20-programas-desativar.png — o diálogo com o campo de data e a contagem de atletas.

Desativar abre um diálogo que pede a data em que a entrega para, já preenchida com a segunda que vem. Ele diz, com o número na frente: “A partir de DD/MM/AAAA este programa para de montar o dia. N atletas deixam de receber treino por ele — e nenhuma matrícula é cancelada.”

📐 Regra de negócio

desativar grava uma data, não um interruptor — e a data é exclusiva. O programa entrega normalmente até a véspera e para no dia escolhido. Desativar “hoje” para hoje; quem quiser terminar a semana em curso grava a segunda seguinte. É o que o rótulo do campo diz: “Para de entregar a partir de — exclusiva: o dia anterior ainda entrega.”

📐 Regra de negócio

desativar não esconde o passado. O calendário, o histórico e a aderência de antes dessa data não mudam uma linha. A semana em que o desligamento cai fica partida no dia certo: os dias já vividos continuam contando, os seguintes não. E o atleta continua conseguindo lançar retroativamente um treino de data anterior ao desligamento.

📐 Regra de negócio

base de tier não se desativa. Impact Performance e Elite Performance são o que todo atleta do tier recebe — desligar uma delas deixaria um tier inteiro sem treino. A ação fica apagada, com o motivo escrito ao passar o mouse.

Reativar

Reativar é um clique com uma confirmação, e a confirmação existe por causa do que não acontece:

Cuidado

reativar não re-ancora o programa. Ele volta a entregar na semana do calendário — não na semana em que parou. Um programa que parou na semana 9 e volta três semanas depois volta na semana 12: as semanas do meio foram puladas e não voltam. Se você quer repetir uma delas, mova a âncora à mão (7.1) — a âncora é a única alavanca sobre a linha do tempo, e ela continua sendo sua.

Excluir para sempre

O botão vermelho no fim do Ciclo de vida. Ele é raro de propósito, e quase sempre está desabilitado — com o motivo escrito ao passar o mouse.

📐 Regra de negócio

excluir exige três coisas ao mesmo tempo: o programa precisa estar desativado, não pode ser base de tier, e nunca pode ter tido matrícula — nem ativa, nem encerrada. Programa que já teve atleta não se exclui: o histórico daquele atleta depende dele. Na prática sobra exatamente o caso que a exclusão existe para atender: o programa criado por engano, a duplicata de teste, o que nunca chegou a ninguém.

Nota

o botão só acende quando as três valem — e o motivo escrito conta quantas matrículas já apontaram para o programa, contando as encerradas. O que a tela oferece é o que o sistema aceita: ele não habilita para depois recusar.

Cuidado

excluir é só do head coach. Quem tem perfil de Criador de treinos não vê o botão. É a única ação do produto que destrói conteúdo autorado, e ela não é reversível.

A confirmação é de dois passos no mesmo diálogo. Primeiro ela nomeia o que morre junto:

• todos os dias autorados do programa;
• o trilho de auditoria inteiro;
• o vínculo dos resultados com o bloco — as linhas de resultado ficam, os vínculos ficam vazios.

Depois ela pede que você digite o nome do programa. O botão só habilita com o título exato.

📐 Regra de negócio

desativar preserva o passado; excluir apaga. São ações diferentes, e a diferença é essa frase. Na dúvida entre as duas, a resposta é desativar.

Campos & validações

Campo	O que é	Obrigatório	Regra
Tipo do programa	para quem ele é	sim	Público · Específico · Individual; nasce Público
Atleta	de quem é o programa	sim, se Individual	só o Individual tem dono; trocar de tipo solta o atleta
Título	nome do programa	sim	—
Headline	descrição curta do card	sim	—
Metodologia	como o programa treina (texto longo)	sim	cresce enquanto você escreve
No tempo	Baseado em tempo ou Dinâmico	sim	dinâmico deixa a duração consultiva
Nível	público-alvo	sim	Iniciante · Intermediário · Avançado · Competidor
Duração (semanas)	duração de referência	sim	inteiro 1 ou mais
Foco	áreas de foco	não	separado por vírgula
Competição-alvo	a prova que o ciclo mira	não	avisa (não impede) se o programa for dinâmico
Âncora	a segunda-feira da semana 1	não	precisa ser uma segunda-feira
Capa	a foto do card do atleta	não	na criação sobe junto com o programa; na edição salva na hora
Data de desativação	quando a entrega para	sim (no diálogo)	exclusiva — o dia anterior ainda entrega

Os erros de validação do formulário aparecem numa faixa acima dos botões: “Preencha título, headline, metodologia e uma duração válida.”, “Um programa Individual é de um atleta só — escolha de quem ele é.” e “A âncora precisa ser uma segunda-feira.”

Estados

• Carregando: “Carregando os programas…”.
• Erro de carga: faixa com o motivo e Tentar de novo.
• Erro de ação: faixa no topo, com Fechar — é onde caem as recusas do sistema (desativar uma base de tier, excluir um programa com matrícula, matricular alguém num desativado).
• Catálogo vazio: “Nenhum programa no catálogo”.
• Busca ou escopo sem resultado: “Nenhum programa encontrado — ajuste a busca ou o escopo.”
• Aba Desativados vazia: “Nenhum programa desativado”.
• Programa que não existe mais: ao abrir um endereço antigo, “Programa não encontrado” com o caminho de volta para a lista.

Dicas

Dica

desativar é a ferramenta certa quase sempre. Fim de temporada, plano aposentado, programa que virou outro: desative. O treino vivido fica, o atleta fica, e a decisão é reversível. Excluir só serve para o que nunca existiu de verdade.

Dica

vai desativar? Grave a segunda seguinte, não hoje. A semana termina inteira e a aderência do seu atleta não fica com metade de uma semana no denominador.

Dica

antes de mexer num programa Público, abra Ver matriculados. Um programa público é compartilhado — a edição atinge todo mundo que está nele, de uma vez. Se o ajuste é para uma pessoa, o tipo certo é Individual.

Dica

o chip De atletas separa as cópias exclusivas (nascidas de cada matrícula num modelo) das suas gerais. É o jeito rápido de enxergar o catálogo “de verdade” quando ele parece cheio demais.

Erros comuns / troubleshooting

Sintoma	Causa provável	O que fazer
“Desativei o programa e o atleta continua no leaderboard e na mensageria.”	Esperado. Desativar não cancela matrícula.	Se a intenção era tirar o atleta do programa, o lugar é a matrícula dele, no perfil.
“Desativei e o treino de ontem continua aparecendo.”	Esperado, e é o ponto da feature.	A data é exclusiva: só o que é igual ou posterior a ela para.
“Reativei e o programa voltou numa semana à frente.”	Reativar não re-ancora.	Mova a âncora à mão se quiser repetir as semanas puladas.
“O botão Excluir está apagado.”	Falta uma das três condições.	Passe o mouse: o motivo está escrito — não está desativado, é base de tier, ou já teve matrícula (e o motivo diz quantas).
“Não vejo o botão Excluir.”	Seu perfil é Criador de treinos.	Só o head coach exclui. Desativar você pode.
“Ninguém está matriculado e o Excluir continua apagado.”	Matrícula encerrada continua contando. O painel de matriculados mostra só quem está ativo hoje; excluir olha tudo que já passou pelo programa.	Desative — esse programa não sai mais do catálogo, e é o correto.
“Não consigo matricular ninguém / autorar um dia neste programa.”	Ele está desativado.	Reative, ou duplique — a cópia nasce ativa.
“Não consigo desativar o Impact/Elite Performance.”	São bases de tier.	Elas não se desativam nem se excluem.
“Salvei a capa e o botão Salvar do formulário nem foi apertado.”	Esperado: a capa salva sozinha, fora do formulário.	Nada a fazer.
“Criei um programa e o atleta não vê.”	Programa nasce rascunho.	Publique — e confira as outras travas em 7.9.

Como o atleta vê

👤 Como o atleta vê

ele não vê esta tela, e não é avisado de nada. Quando um programa é desativado, o “Hoje” dele simplesmente passa a não trazer aquele treino — vira descanso, se não houver outro programa entregando. O calendário, o histórico e os números dele de antes da data continuam iguais. Quem explica a decisão é você, pela Mensageria: o app não anuncia decisão de método.

👤 Como o atleta vê

publicar e despublicar mexem só na vitrine — o catálogo de programas do app. Despublicar tira o programa da vitrine e não interrompe nada para quem já está matriculado. Publicado e ativo são perguntas diferentes: uma é “aparece na vitrine?”, a outra é “continua montando o dia?”.