Reset Automatico de Sessoes Abandonadas
O que e o Reset Automatico de Sessoes?
O Reset Automatico de Sessoes Abandonadas e uma funcionalidade que detecta e reinicia automaticamente treinos que ficaram "em andamento" por mais de 1 hora sem registrar nenhuma serie completada. Isso garante que seus alunos nao fiquem com sessoes "presas" no sistema e possam retomar seus treinos de forma limpa.
Quando uma sessao e detectada como abandonada, ela e automaticamente reiniciada para o status "pendente" e o aluno recebe uma notificacao explicando o que aconteceu. Assim, quando ele voltar a treinar, podera comecar do zero sem problemas.
Por que usar?
Beneficios para voce (Personal Trainer)
Dados mais precisos: Elimina sessoes incompletas que distorcem suas estatisticas e relatorios de progresso
Menos trabalho manual: Nao precisa mais verificar e resetar manualmente sessoes abandonadas
Visao clara do progresso: Historico de treinos mais limpo, mostrando apenas sessoes realmente executadas
Melhor experiencia para o aluno: Seus alunos nao ficam confusos com sessoes "travadas"
Beneficios para seus alunos
Sem sessoes travadas: Podem sempre iniciar o treino de forma limpa
Notificacao automatica: Sao avisados quando uma sessao foi reiniciada automaticamente
Flexibilidade: Podem abandonar um treino e retomar depois sem preocupacoes
Historico correto: Apenas treinos realmente completados aparecem no historico
Como funciona?
Deteccao de Sessoes Abandonadas
O sistema verifica automaticamente, a cada hora, todas as sessoes que estao:
Em andamento (status "in_progress")
Iniciadas ha mais de 1 hora
Sem nenhuma serie completada ou pulada
Processo de Reset
Quando uma sessao abandonada e detectada:
Sessao em andamento ha mais de 1 hora
|
v
Verificar se ha series completadas
|
v
NAO? -----> Reset automatico
|
v
Status volta para "pendente"
|
v
Exercicios gerados sao removidos
|
v
Notificacao enviada ao aluno
Notificacao ao Aluno
O aluno recebe uma notificacao com o seguinte conteudo:
Titulo: "Sessao reiniciada automaticamente"
Mensagem: "Reiniciamos [nome do treino] porque ela ficou aberta por mais de 1 hora sem registrar series. Quando quiser, e so iniciar novamente."
Como acessar
Esta funcionalidade e automatica e esta ativa para todas as equipes. Nao ha configuracao necessaria - o sistema funciona automaticamente em segundo plano.
O que voce precisa saber:
Execucao automatica: O sistema verifica sessoes abandonadas a cada hora
Criterio de 1 hora: Sessoes precisam estar abertas por mais de 1 hora sem atividade
Serie registrada = nao abandona: Se o aluno registrou ao menos uma serie, a sessao nao sera resetada
Notificacao via app: O aluno recebe notificacao pelo canal de acoes do treinador
Guia Passo a Passo
Para o Aluno: Entendendo o Reset Automatico
Cenario 1: Iniciou o treino mas nao fez nada
Aluno abre o app e clica em "Iniciar Treino"
Algo acontece e ele nao registra nenhum exercicio
Apos 1 hora, o sistema detecta a sessao abandonada
A sessao e reiniciada automaticamente
Aluno recebe notificacao: "Reiniciamos seu treino..."
Quando voltar, pode iniciar o treino normalmente
Cenario 2: Iniciou o treino e registrou series
Aluno inicia o treino
Registra pelo menos uma serie (completa ou pula)
Precisa sair por algum motivo
Mesmo apos 1 hora, a sessao NAO e resetada
Quando voltar, continua de onde parou
Para o Personal: Monitorando Sessoes
O reset automatico funciona em segundo plano, mas voce pode:
Ver historico normal: Sessoes resetadas automaticamente voltam para "pendente"
Acompanhar notificacoes: Alunos recebem notificacoes quando isso acontece
Verificar analytics: Eventos de reset sao registrados para analise
Casos de Uso Praticos
Caso 1: Aluno distraido
Situacao: Joao abre o app para treinar, inicia a sessao mas recebe uma ligacao importante. Esquece o treino aberto e so lembra no dia seguinte.
O que acontece:
Apos 1 hora, sistema detecta sessao sem series registradas
Sessao e reiniciada automaticamente
Joao recebe notificacao explicando
No dia seguinte, Joao pode iniciar o treino normalmente
Beneficio: Joao nao fica com um "treino parcial fantasma" no historico.
Caso 2: Problema tecnico
Situacao: Maria inicia o treino mas seu celular trava/reinicia antes de registrar qualquer exercicio.
O que acontece:
Sistema detecta sessao abandonada apos 1 hora
Reset automatico restaura sessao para "pendente"
Maria recebe notificacao
Pode reiniciar o treino quando resolver o problema do celular
Beneficio: Maria nao precisa contatar o personal para "limpar" seu treino.
Caso 3: Desistencia temporaria
Situacao: Pedro inicia o treino mas nao esta se sentindo bem. Decide parar antes de fazer qualquer exercicio.
O que acontece:
Apos 1 hora sem atividade, sessao e resetada
Pedro recebe notificacao automatica
Pode tentar novamente quando estiver melhor
Beneficio: Nenhuma acao manual necessaria - o sistema cuida automaticamente.
Perguntas Frequentes (FAQ)
Sobre Funcionamento
P: Por que o tempo e de 1 hora? R: Uma hora e tempo suficiente para o aluno completar um treino normal ou retomar se for interrompido brevemente. E um equilibrio entre detectar abandonos reais e nao interferir em treinos legitimos.
P: O que acontece se eu registrei uma serie e depois abandonei? R: Se voce registrou pelo menos uma serie (completa ou pulada), a sessao NAO sera resetada automaticamente. O sistema entende que voce realmente comecou a treinar.
P: E se eu precisar de mais de 1 hora de descanso entre series? R: Enquanto voce tiver registrado pelo menos uma serie, a sessao permanece ativa independente do tempo. A verificacao de 1 hora so se aplica a sessoes sem NENHUMA serie registrada.
P: A notificacao chega por onde? R: A notificacao chega pelo app, no canal de "Acoes do Treinador". Se o aluno tiver notificacoes push ativadas, recebera um alerta.
Sobre Dados
P: Perco meus dados quando a sessao e resetada? R: Como a sessao nao tinha series registradas, nao ha dados de treino para perder. Os exercicios gerados sao limpos, mas isso significa apenas que serao gerados novamente quando voce iniciar.
P: O reset aparece no meu historico? R: Nao. A sessao volta para "pendente", entao e como se nunca tivesse sido iniciada. Seu historico mostra apenas sessoes que voce realmente completou.
P: O personal trainer ve quando minha sessao foi resetada automaticamente? R: O sistema registra eventos de reset para fins de analytics, mas isso nao aparece de forma destacada para o personal. O foco e manter seus dados limpos.
Sobre Comportamento
P: Posso desativar o reset automatico? R: Nao. Esta funcionalidade e automatica para todas as equipes e garante a qualidade dos dados do sistema.
P: E se eu quiser manter a sessao aberta de proposito? R: Se voce precisa pausar um treino por muito tempo, registre pelo menos uma serie (ou pule um exercicio) antes de sair. Assim a sessao nao sera resetada.
P: O que acontece com treinos TRI (variacoes)? R: O comportamento e o mesmo. Se voce escolheu uma variacao mas nao registrou nenhuma serie, a sessao sera resetada e voce podera escolher a variacao novamente.
Resolucao de Problemas
Problema: Minha sessao foi resetada mas eu estava treinando
Causa Provavel: Voce pode ter iniciado a sessao mas nao registrado nenhuma serie antes do timeout de 1 hora.
Solucao: Sempre registre suas series conforme completa os exercicios. Mesmo que precise pausar, ter pelo menos uma serie registrada previne o reset automatico.
Problema: Nao recebi notificacao do reset
Causas Possiveis:
Notificacoes push desativadas no celular
App nao tem permissao para notificacoes
Problema de conexao no momento do envio
Solucao: Verifique as configuracoes de notificacao do seu celular e do app. A sessao ainda foi resetada corretamente.
Problema: Quero resetar minha sessao manualmente antes de 1 hora
Solucao: Voce pode resetar sua sessao manualmente a qualquer momento atraves do app. O reset automatico e um fallback para casos onde voce esqueceu de fazer isso.
Detalhes Tecnicos
Frequencia de Verificacao
O sistema executa verificacao a cada hora (cron job)
Processa em lotes de 200 sessoes por execucao
Registra metricas de quantas sessoes foram processadas/resetadas
Criterios de Selecao
Uma sessao e candidata a reset se:
Status = "in_progress" (em andamento)
Data de inicio (started_at) < [agora - 1 hora]
Nenhuma serie com:
completed_at preenchido, OU
skipped = true
Eventos Registrados
Quando uma sessao e resetada, o sistema registra:
ID da sessao
ID do aluno
ID da equipe
Se havia exercicios que foram deletados
Motivo do reset ("auto_abandoned")
Timestamp do reset
Ultima atualizacao: Janeiro 2026 Versao: 1.0 Funcionalidade: Reset Automatico de Sessoes - Disponivel para todas as equipes