📘 Documentação Técnica
Aqui você encontra os detalhes técnicos sobre progressão, conquistas, estágios, regras de ciclos e cálculos exibidos no app.
Procurando os princípios e a filosofia do TrueStreak? Visite a página de metodologia.
Use este índice para navegar rapidamente pelos tópicos.
O TrueStreak registra ações reais e transforma constância em reconhecimento, sem apagar história.
A progressão no TrueStreak acontece dentro de categorias de reconhecimento. Em vez de depender de um número único de pontos, você avança conforme acumula marcos em áreas específicas.
O foco é presença e continuidade. Você pode pausar e voltar. Seu histórico fica preservado.
Semanas e meses com regularidade podem desbloquear marcos de longo prazo em algumas categorias. Isso não é punitivo. Pausas não retrocedem seu progresso. Elas apenas interrompem o avanço até você retomar.
Importante: não existe perda de progresso. O TrueStreak preserva sua história.
O TrueStreak reconhece esforço em 7 categorias. Cada categoria possui 11 estágios progressivos.
Mede quantos treinos você completou ao longo do tempo.
Mede a maior sequência de dias com atividade registrada, incluindo pausas justificadas.
Observação: um dia sem treino e sem pausa justificada quebra a sequência.
Mede o total de unidades internas de exercício registradas ao longo do tempo. O foco é presença, não intensidade.
Mede a proporção entre treinos completados e treinos planejados dentro de um período. Treinos parciais podem contar proporcionalmente.
Quantas semanas você completou 100% do que planejou.
Mede meses com taxa de conclusão acima de um limiar sugerido, como 75%.
Mede há quanto tempo você usa o app e continua registrando atividade.
Os 11 estágios de cada categoria seguem esta nomenclatura visual. O objetivo é celebrar progresso, não competir.
| Nível | Nome |
|---|---|
| 0 | Sem estágio (ponto de partida) |
| 1 | Cobre |
| 2 | Ferro |
| 3 | Bronze |
| 4 | Prata |
| 5 | Ouro |
| 6 | Platina |
| 7 | Esmeralda |
| 8 | Rubi |
| 9 | Diamante |
| 10 | Diamante Azul |
Observação: os nomes são referência visual. Requisitos e marcos são definidos por categoria.
Um ciclo é uma sequência recorrente de tipos de treino ou atividades. O ciclo avança quando você treina, não por dias do calendário.
Exemplo 1: academia (ABCD)
Ciclo: "Musculação ABCD"
Dia A: Peito + tríceps
Dia B: Costas + bíceps
Dia C: Pernas
Dia D: Ombros + core
Após o Dia D, volta para o Dia AExemplo 2: atividades variadas
Ciclo: "Movimento leve (3 dias)"
Dia 1: Caminhada (15 a 30 min)
Dia 2: Mobilidade e alongamento (10 a 20 min)
Dia 3: Yoga ou dança (20 a 40 min)
Após o Dia 3, volta para o Dia 1Criar um novo ciclo não remove conquistas, não reduz progresso e não altera sua streak. O ciclo antigo é arquivado para que você possa ver sua evolução ao longo do tempo.
Regra importante: o ciclo avança quando você registra um treino. Se você não treinar em um dia, o ciclo não avança sozinho.
Exemplo: ciclo A/B/C/D
Dia 1: treino A (ciclo vai para B)
Dia 2: treino B (ciclo vai para C)
Dia 3: sem treino (ciclo continua em C)
Dia 4: treino C (ciclo vai para D)
Dia 5: treino D (ciclo volta para A)Pausas justificadas são dias em que você não treinou, mas registrou a intenção e o motivo (doença, compromisso, indisposição, etc.).
Recomendação: muitas pausas seguidas podem indicar que o ciclo precisa ser ajustado para o seu momento atual.
Esta seção descreve como o TrueStreak calcula as principais métricas exibidas no app.
Definição: proporção entre treinos completados e treinos planejados em um período.
Taxa de conclusão = (Treinos completados / Treinos planejados) x 100Semana:
- Segunda: treino completo = 1.0
- Quarta: treino parcial = 0.6
- Sexta: pausa justificada = evento separado
- Sábado: treino não feito = 0
Treinos completados: 1.0 + 0.6 + 0 = 1.6
Treinos planejados: 3
Taxa: (1.6 / 3) x 100 = 53.3%Definição: dias consecutivos com atividade registrada ou pausa justificada (conforme regras do app).
Streak atual = dias desde o último dia sem atividade registrada
Melhor streak = maior streak no históricoDefinição: soma de unidades internas de exercício registradas. O TrueStreak não tenta comparar intensidade entre atividades.
Volume total = soma das unidades registradasObservação: as unidades internas existem para medir constância, não performance.
Critério: uma semana completa ocorre quando 100% dos treinos planejados na semana foram completados.
Semana completa = taxa de conclusão da semana igual a 100%Semana com 4 treinos planejados:
- Seg: completo
- Qua: completo
- Sex: completo
- Sab: completo
Resultado: semana completaCritério sugerido: um mês é marcado como disciplinado quando a taxa de conclusão mensal atinge um limiar, como 75%.
Taxa mensal = (completados no mês / planejados no mês) x 100
Se taxa maior ou igual a 75%, mês disciplinadoRespostas objetivas para dúvidas técnicas comuns.
Quando seus dados estão sincronizados na nuvem, ao fazer login novamente, seu histórico, conquistas e ciclos voltam.
Por padrão, a experiência é focada em um ciclo ativo por vez para reduzir confusão sobre o que fazer hoje. Você pode arquivar e alternar entre ciclos.
Ciclos arquivados existem para preservar histórico. Se você quiser usar um ciclo antigo novamente, reative-o ou crie uma nova versão.
Nada é apagado. Seu progresso fica pausado. Quando você voltar, seu histórico continua lá.
O app pode usar o fuso do dispositivo. Mudanças de fuso não devem, por si só, apagar histórico ou conquistas.
Em geral, é possível registrar treinos offline e sincronizar depois. Algumas áreas, como estatísticas em tempo real, podem exigir conexão.
Dúvidas não respondidas aqui? Volte para metodologia para o contexto, ou fale com a equipe de suporte pelo canal oficial do projeto.