Progresso: as marcas, o ranking e a frequência

Onde: aba Progresso

Visão geral

O Progresso responde três perguntas em três leituras: o que você bateu, onde você está na organização e você está treinando. As suas marcas vêm primeiro, depois o ranking da organização, e a tela fecha na frequência: o período, o placar de três números e a grade dos seus dias. As ações moram nas seções que as explicam: Registrar ao lado de Marcas, Histórico completo no pé da lista, Ver tudo ao lado do Ranking.

Nada fica dentro de moldura. As seções se separam pelo título e por filetes finos, como o resto do app, e os dois filtros — o recorte do ranking e o período — são abas: o escolhido ganha um traço grosso embaixo.

📸 Screenshot pendente

assets/07-progresso-tela.png — a tela inteira: marcas, ranking, período, placar e grade.

Nota

a versão web do Progresso, no navegador, ainda abre no período e no placar. A ordem de cima é a do app no celular.

Cuidado

o painel de Volume saiu desta tela. Ele continuava certo, mas eram quatro cartões, cinco réguas e duas listas no meio de uma leitura que é sobre você, e empurravam as marcas e o ranking para 2.000px de rolagem. No computador, na versão de tela grande do Progresso, ele continua onde estava.

Quando usar

• Para saber, em três segundos, se você está aparecendo — e em quais dias não apareceu.
• Para conferir o que bateu no período e quando.
• Para ver onde você está na organização num recorte que interessa a você.
• Para lançar um 1RM ou benchmark antigo.

Pré-requisitos

• Ter matrícula ativa num programa (é ela que diz quais dias são de treino). Sem ela a tela não some — ela mostra traços onde não há dado e a grade fica toda em descanso.
• Ter histórico, ou lançar o primeiro recorde.

Passo a passo (por região)

Marcas

A lista traz as suas três marcas mais recentes. A primeira vem em destaque: a etiqueta PR quando ela é a sua melhor, o movimento, o contexto (1RM · 14 Ago), o valor e o ganho em verde com a seta quando houve melhora. Abaixo dela, as duas seguintes em uma linha cada.

• + Registrar, ao lado do título, abre a folha de lançar uma marca.
• Histórico completo, no pé da lista, abre a tela de Recordes.

Nota

a seta verde quer dizer melhorou, não “subiu”. Num benchmark de tempo, melhorar é o número descer — a seta acompanha o ganho, não a direção do número.

Cuidado

ainda sem nenhuma marca? A seção não some. Ela troca as três linhas por um convite para registrar a primeira, e o Histórico completo continua no pé — quem nunca registrou nada é exatamente quem precisa da porta para ver o que poderia registrar.

Ranking da organização

As abas com os recortes que a organização publica (até três; o resto está em Ver tudo), e abaixo o quadro: os três primeiros e a sua linha, destacada em azul de ponta a ponta da tela, com a etiqueta Você.

Quando você não está no Top 3, entra uma faixa de lacuna entre o 3º e você, dizendo quantos atletas estão no meio — 2 atletas entre você e o 3º. É a distância virando informação, em vez de a numeração pular sem explicação.

Ver tudo abre o quadro completo já no recorte que você estava olhando, com os filtros de scaling, sexo e divisão.

Nota

a organização que ainda não publicou recorte nenhum também tem resposta: a seção diz isso, e a sua posição aparece assim que o coach abrir o primeiro.

A frequência — o período, o placar e a grade

No começo da seção Frequência, quatro abas: 30D · 90D · 6M · TUDO. A tela abre em 90D. Trocar o período refaz o placar e a grade juntos — e só eles: as marcas e o ranking, lá em cima, não mudam com ele.

📐 Regra de negócio

o período conta em semanas inteiras, de segunda a domingo. É por isso que a grade sempre fecha em colunas cheias — 5 semanas em 30D, 13 em 90D, 26 em 6M — e nunca começa no meio de uma semana. TUDO vai até a sua matrícula.

Nota

o ranking não obedece a este seletor. Ele tem o recorte dele, nas abas acima do quadro — “aderência da organização” e “Back Squat” não são períodos, são assuntos.

O placar — três números

Três colunas de largura igual, separadas por filetes, logo abaixo do período.

Coluna	O que é
Aderência	quantos, dos dias que o seu programa pediu no período, você treinou
Recordes	quantas marcas suas foram batidas dentro do período
Ranking	a sua colocação no recorte que o ranking está mostrando, e de quantos atletas

A aderência muda de cor: verde de 80% para cima, tinta normal entre 62% e 79%, e vermelha abaixo de 62%. A legenda embaixo diz a conta — 21/45 dias.

Cuidado

onde não há dado, a coluna mostra um traço, nunca 0%. Zero por cento é uma afirmação — e seria falsa para quem ainda não tem matrícula ou ainda não registrou marca nenhuma.

Nota

a coluna Ranking não muda com o período. Ela lê o mesmo quadro que está desenhado logo acima, no ranking, então trocar o recorte lá em cima troca o número aqui — e é para ser assim: é a mesma leitura, dita duas vezes.

A grade — um quadrado por dia

Sete linhas (segunda a domingo) por uma coluna por semana. Cada quadrado é um dia, e há três estados:

Quadrado	O que quer dizer
Treinado	o programa pediu treino nesse dia e você registrou
Perdido	o programa pediu treino e não houve registro
Descanso	o programa não pediu nada nesse dia

A legenda embaixo da grade nomeia os três — ela é obrigatória, porque sem ela o quadrado riscado do “perdido” parece um defeito da tela.

📐 Regra de negócio

a grade e o placar contam exatamente os mesmos dias. O número da aderência é a soma dos quadrados “treinado” dividida pela soma de “treinado” e “perdido” — dá para conferir contando na tela.

Cuidado

um treino feito num dia que o programa não pediu aparece como descanso, não como treinado. É a mesma regra da aderência: um dia extra nunca derruba a sua conta e nunca a empurra acima de 100%. O treino está registrado e continua valendo no Calendário — o que ele não faz é mexer num denominador que ninguém prescreveu.

Nota

os dias da semana corrente que ainda não aconteceram ficam em branco. A tela não chama amanhã de descanso nem de falta.

Dica

em 30D os quadrados ficam largos, e em 6M ou TUDO a grade rola para o lado — arraste sobre ela. A coluna com os nomes dos dias fica parada, para você não perder a referência no meio da rolagem.

A tela de Recordes

Onde: Progresso › Recordes

A tela abre em duas abas: Meus recordes e Ranking.

Meus recordes é uma lista só, separada por Tipo: primeiro os seus recordes por tipo de marca (Carga máxima, Reps unbroken, Reps no tempo, Tempo p/ reps, Distância) e, na sequência, os benchmarks por classe (Girls, Heroes, Benchmarks). Tocar num benchmark abre a prescrição dele.

Modalidade — o primeiro corte da lista

Acima do Tipo fica a faixa Modalidade, e é por ela que se chega a um recorde sem rolar a lista inteira: escolha a modalidade, depois o movimento.

Modalidade	O que ela junta
Strength & Weightlifting	levantamento e força com barra e halteres
Gymnastics	ginástica — barra, argola, parada de mão
Bodyweight	peso do corpo
Conditioning	condicionamento — corrida, remo, bike, corda
Benchmarks	os WODs de referência (Girls, Heroes…)
Sem modalidade	as suas marcas que ainda não têm uma, com o número delas no chip

📐 Regra de negócio

a modalidade é do movimento, e o coach a define na Biblioteca dele — ela não fica gravada na sua marca. É de propósito: se ele recategorizar um movimento, todo o seu histórico daquele movimento acompanha. Gravar a modalidade no dia do PR faria a tela ter duas verdades sobre o mesmo levantamento.

📐 Regra de negócio

Benchmarks fica ao lado das modalidades, não dentro de uma. Um benchmark é um treino completo, não um movimento — ele não tem um implemento nem uma modalidade única. Ele aparece na mesma faixa porque é ali que você procura.

Cuidado

nada some por não ter modalidade. Uma marca cujo movimento o coach ainda não nomeou — ou cujo nome não bate com a Biblioteca dele — vai para Sem modalidade, com o número no chip. Ela continua na busca e continua abrindo normalmente; o que falta é o balde dela.

Dica

a faixa só aparece quando há mais de um balde. Se todas as suas marcas são da mesma modalidade, ela não entra — um filtro com uma opção só não filtra nada. Escolher uma modalidade devolve o Tipo para “Todos”, porque o tipo que você tinha escolhido pode não existir na nova.

No topo, três ícones:

Ícone	O que faz	Onde aparece
Lupa	busca por nome — olha os seus recordes e os benchmarks ao mesmo tempo	só em Meus recordes
Configurações	alterna entre Meus recordes (padrão) e Todos os movimentos	só em Meus recordes
Mais	abre Registrar recorde	nas duas abas

Nota

a lupa e a engrenagem filtram a lista, então só existem na aba que tem lista. Registrar fica nas duas — é a ação que você pode querer a qualquer momento. O sinal de Registrar era um troféu e virou +: troféu é a marca ser a sua melhor, + é somar uma marca nova.

Em Todos os movimentos, entram também os que você ainda não registrou, com um traço no lugar da marca — tocar num deles já abre o registro com o movimento escolhido. Quais movimentos podem virar recorde é o head coach quem define.

📐 Regra de negócio

recorde não tem mais nível. A sua melhor marca de um movimento é a melhor marca, tenha sido feita em RX, Scaled ou Iniciante. O nível continua valendo no quadro da organização, onde comparar níveis diferentes seria injusto — lá o filtro de scaling segue existindo.

Dica

o filtro Tipo só oferece os tipos que têm alguma linha — e ele obedece à Modalidade escolhida acima. Se você ainda não tem recorde de distância, ele não aparece; não é erro, é a tela não oferecendo um filtro que não filtraria nada.

Abrir um recorde: a evolução daquela marca

Toque numa linha e ela abre a história daquela marca, em dois blocos: o card de duas faces no topo e o Ranking da organização logo abaixo.

O card de duas faces. Ele é uma moeda: de um lado a progressão, do outro as marcas. Toque nele e ele vira.

Face	O que mostra
Progressão (a que abre)	melhor, último, a variação entre as duas últimas e o gráfico ao longo do tempo
Marcas	todas as tentativas, da mais recente para a mais antiga, com um troféu na que é a sua melhor e uma lixeira em cada uma

A faixa no alto do card diz em que face você está e nomeia a outra — PROGRESSÃO / MARCAS de um lado, 4 MARCAS / GRÁFICO do outro. Toque na faixa para virar. Do lado do gráfico, o card inteiro vira; do lado das marcas, só a faixa — para o toque não escapar da lixeira.

Nota

a variação vem com sinal e com seta — −3 kg com a seta para baixo é uma marca abaixo da anterior, −0:30 com a seta para cima é meio minuto a menos num tipo em que menor é melhor. Com uma marca só, o gráfico ainda não aparece: ele começa na segunda.

O Ranking da organização. Logo abaixo do card, sem tocar em nada: os cinco primeiros da organização naquele movimento e naquele tipo, com quantos atletas o quadro tem. É a mesma marca lida de duas formas — o número é seu no card de cima, e é da organização aqui.

• A sua linha vem destacada quando você está entre os cinco.
• Quando não está, a sua posição aparece logo abaixo do quadro, com a sua marca — você nunca precisa procurar onde ficou.
• Ver ranking completo abre o quadro cheio: a organização inteira, com os filtros de scaling, sexo e divisão. Voltar devolve a história aberta onde você estava.

📐 Regra de negócio

o quadro aqui é o da organização inteira, sem categoria. Recortar por scaling, sexo ou divisão é do quadro completo — dois lugares com a mesma cara respondendo coisas diferentes seria pior do que um toque a mais.

Nota

o quadro é do tipo de marca, não do contexto dela. Os seus 40 reps em 5 min e os 70 reps em 10 min do mesmo movimento entram no mesmo quadro de Reps no tempo.

Dica

ele nunca te mostra o quadro de outro movimento. Se ninguém mais na organização tiver marca nesse recorte, ele diz isso com todas as letras — e a sua marca continua sendo sua.

Excluir uma marca lançada errada

Vire o card para a face Marcas: cada tentativa tem uma lixeira. Toque nela e o app pede confirmação dizendo o movimento, o valor e a data — para você não apagar a linha de cima por engano.

📐 Regra de negócio

você só apaga as suas marcas, e o que a tela mostra se refaz sozinho: melhor marca, última, variação, gráfico, contagem e o Ranking da organização logo abaixo saem todos do que sobrou. Se a marca apagada era o seu recorde, a próxima melhor assume — você não precisa fazer nada.

Cuidado

quando a marca veio de um treino que você registrou, a confirmação avisa. O registro do treino continua lá — só a marca sai —, e por isso ela pode voltar se você editar aquele registro depois. Se o número errado está no treino, o lugar de corrigir é o registro, não aqui.

Dica

apagou a última marca daquele movimento? O app volta para a lista — não existe história de uma marca que não existe mais.

Abrir um benchmark: o que é aquele WOD

Toque num benchmark e você vê o que ele é antes de qualquer comparação: a sua melhor marca no topo e, abaixo, a prescrição — movimento, quantas repetições e a carga quando houver, com os descansos e os complexes na ordem. A nota do coach, quando existe, vem no fim. O quadro da organização continua a um toque, no botão Ver o quadro, no rodapé.

Nota

carga em % de 1RM aparece como percentual, não convertida em quilos: esta tela mostra o que o coach prescreveu para todo mundo, não a sua carga.

Registrar recorde

Toque no + (topo direito da tela de Recordes, e também do detalhe de um recorde) ou em “Registrar recorde”:

• Carga — escolha o movimento, informe o 1RM e a data.
• Benchmark — escolha o benchmark, informe o score e a data.
• Outros — reps unbroken, reps num tempo, tempo para reps, distância.
• Salvar mantém a folha aberta (para lançar vários de uma vez) e limpa os campos.

Nota

a folha não pergunta mais o nível. O recorde é seu ao longo do tempo, sem separar por nível — e o nível em que a marca foi feita continua sendo guardado para o quadro da organização.

📐 Regra de negócio

num score de tempo, o campo aceita 42 (só os segundos), 1:30 e 1:02:03. O que ele não aceita é um tempo que não existe: 2:75 é recusado na hora, em vez de virar 3:15 guardado no seu nome.

📐 Regra de negócio

o seletor de movimento oferece a lista que o head coach liberou para recorde, não a biblioteca inteira. Se o movimento que você quer não está lá, fale com ele.

O quadro da organização

📸 Screenshot pendente

assets/07-progresso-leaderboard.png — o quadro da organização com o recorte e os filtros.

Dentro de Recordes, a aba Ranking abre o quadro da organização: o mesmo que o coach vê. É onde o card “Leaderboard” do Progresso foi parar.

Ele tem duas portas, e a diferença é o que você já sabe quando entra. Pela aba Ranking você chega sem recorte escolhido e navega pelos filtros; pelo botão do rodapé — Ver ranking completo dentro de um recorde, Ver o quadro dentro de um benchmark — você chega já no quadro daquela marca.

• Fonte — Recordes ou Benchmarks.
• Recorte — qual quadro (“Back Squat”, “Fran”), com quantos atletas ele tem.
• Filtros — scaling, sexo e divisão.

Cada linha mostra colocação, nome, o scaling e a procedência da marca (no treino quando ela saiu de um registro, autodeclarado quando foi cadastrada à mão), e o valor.

📐 Regra de negócio

empate divide a colocação — dois atletas em 100 kg ficam ambos em 2º, e o próximo é 4º.

Nota

a sua posição aparece sempre, mesmo quando ela está fora da parte visível do quadro. Ela vem num rodapé abaixo da lista, com o seu número, o selo sua posição e a sua marca.

Quando você não tem colocação naquele recorte, o rodapé continua lá — com um traço no lugar do número, a sua marca quando existe, e a frase que diz o motivo: “Você ainda não tem marca nesse recorte.”, ou “Você está fora desta categoria.” quando os filtros apontam para um corte que não é o seu (o quadro feminino, uma divisão que não é a sua).

Dica

um quadro em que ninguém da organização tem marca não fica em branco: ele diz “Ninguém registrou esse recorte nessa categoria ainda.” e mantém o seu rodapé embaixo. Solte um filtro e ele volta a ter gente.

Campos & validações

Campo	O que é	Obrigatório	Regra
Levantamento	1RM a exibir	—	seleção
Movimento / Benchmark	O que registrar	Sim	do catálogo
1RM / Score	O valor	Sim	número
Data	Quando	Sim	padrão hoje; pode retroagir

Estados

• Carregando: blocos cinzas parados no lugar das marcas, do ranking e da frequência.
• Sem matrícula: placar com traços, grade inteira em descanso — e todas as seções no lugar.
• Sem marcas: a lista de Marcas convida a registrar a primeira; nada mais desaparece.
• Sem ranking na organização: a seção explica que o coach ainda não abriu um recorte.
• Com dados: três marcas, o quadro da organização, o placar e a grade.

Dicas

Dica

mantenha os 1RMs atualizados — é deles que o Detalhe resolve a carga dos seus exercícios (%1RM). 1RM desatualizado = carga errada no treino.

Erros comuns / troubleshooting

• “Minha carga no treino está estranha.” — Atualize o 1RM do movimento aqui; o Detalhe recalcula.
• “O placar está todo com traços.” — Ou você ainda não tem matrícula ativa num programa — e sem programa não há dia prescrito, então não há aderência a calcular —, ou ainda não registrou nada. Comece registrando os treinos.
• “Treinei num dia e o quadrado ficou de descanso.” — Esse dia não era de treino no seu programa. O registro está guardado e aparece no Calendário; ele só não entra na conta da aderência, porque ninguém o prescreveu.
• “Onde foi parar o gráfico de evolução do 1RM?” — Ele mora na história de cada marca: Histórico completo › toque no movimento. É a mesma curva, agora ao lado das tentativas que a formaram.
• “Onde foi parar o Volume?” — Ele saiu do Progresso no telefone e continua na versão de tela grande.
• “Não acho um movimento no seletor de recorde.” — Só entram os movimentos liberados para recorde pelo head coach.
• “Minha marca aparece como ‘autodeclarado’ e eu fiz no treino.” — Ela foi cadastrada à mão, não derivada de um registro. Acontece, por exemplo, quando um resultado antigo é excluído e o número é re-digitado aqui.
• “Apaguei um resultado e perdi o 1RM.” — Excluir um resultado apaga também o que ele derivou — inclusive o recorde. Como o 1RM resolve as cargas em %1RM, re-cadastre a marca aqui.
• “Apaguei a marca e o treino continua lá.” — É o esperado, e é o caminho inverso do de cima: excluir uma marca não mexe no treino. Um apaga o outro; o outro não apaga o um.
• “Só aparece uma modalidade na faixa.” — A modalidade sai da Biblioteca do coach, e só os movimentos que ele liberou para recorde a têm. Enquanto essa lista for de um tipo só, a faixa terá um balde só — ela cresce quando ele liberar movimentos de ginástica, peso do corpo e condicionamento.
• “Minha marca caiu em Sem modalidade.” — O movimento dela ainda não foi nomeado pelo coach, ou o nome não bate com o da Biblioteca. A marca continua sua e continua inteira — avise o coach e ela muda de balde sozinha, com o histórico junto.

O que o coach vê

Os mesmos PRs, a mesma aderência e o volume aparecem no perfil do atleta no painel do coach — é o retrato do seu progresso que ele usa para ajustar o plano. A aderência que ele lê sai da mesma conta da sua grade: o dia que ficou riscado para você é o dia que ficou de fora para ele.