Use Zwift Click, Zwift Play, Shimano Di2, or any Bluetooth controller with MyWhoosh, Rouvy, Zwift, and more. Free to try on iOS, Android, Windows, and macOS.
8h +2★ 644Sports & fitness
Do you operate this project?
Owners of public repositories under a personal GitHub account can sign in to verify ownership and manage the introduction themselves. No administrator approval is needed.
Organization repository · verify with a repository file
Sign in, generate a verification file, and commit it to this repository’s default branch within 30 minutes. Files on other branches or forks do not count. Then check the file below to manage the project without administrator approval. Keep the file to retain your access.
If needed, you will go to sign-in. After signing in, return here and press your chosen verification button again.
Run /nomorevibe verify in your project folder to verify ownership and manage the introduction yourself.
Loading the full README. The saved excerpt is shown below.
Bora treinar? Registro e acompanhamento de treinos de academia para Personal/Instrutor e Aluno.
Aplicação web mobile-first (PWA) em português do Brasil, com fuso de referência America/Sao_Paulo.
O padrão decorativo de fundo é inspirado no calçadão de Copacabana (ondas em pedra portuguesa), aplicado de forma sutil.
Supabase (Postgres + Auth + Storage) com RLS em todas as tabelas
Vercel (deploy + Vercel Cron para o relatório de domingo)
Resend (e-mail transacional)
Recharts (gráficos)
PWA instalável (manifest + service worker)
IA (Gemini e/ou Claude) para sugestões do relatório semanal, comparadas lado a lado com regras simples (opcional)
Rodando localmente
Pré-requisitos: Node.js 20+ e uma conta no Supabase (ou o Supabase CLI com Docker).
git clone https://github.com/thaylles/boratreinar.git
cd boratreinar
npm install
cp .env.example .env.local # preencha as variáveis
npm run dev # http://localhost:3000
Banco de dados
As migrações SQL ficam em supabase/migrations/. O catálogo padrão é uma migração de dados gerada por python3 scripts/catalogo.py (as ilustrações, por python3 scripts/gerar-ilustracoes.py). O logo e os ícones saem de python3 scripts/gerar-icones.py (os PNGs são renderizados a partir dos SVGs gerados).
# Com Supabase CLI ligado a um projeto remoto
npx supabase link --project-ref SEU_PROJECT_REF
npx supabase db push
# Ou localmente (Docker)
npx supabase start
npx supabase db reset # aplica migrações + seed
Variáveis de ambiente
Veja .env.example. Resumo:
Variável
Onde
Descrição
NEXT_PUBLIC_APP_URL
cliente/servidor
URL pública do app (links de convite, e-mails)
NEXT_PUBLIC_SUPABASE_URL
cliente/servidor
URL do projeto Supabase
NEXT_PUBLIC_SUPABASE_ANON_KEY
cliente/servidor
chave pública (anon)
SUPABASE_SERVICE_ROLE_KEY
só servidor
usada pelo cron do relatório
RESEND_API_KEY / EMAIL_FROM
só servidor
envio de e-mails (relatório e lembrete das 7h; sem elas, só a notificação no app)
GEMINI_API_KEY / GEMINI_MODEL
só servidor
sugestões do relatório pelo Gemini (opcional; faixa gratuita no Google AI Studio)
ANTHROPIC_API_KEY / ANTHROPIC_MODEL
só servidor
sugestões do relatório pelo Claude (opcional)
CRON_SECRET
só servidor
protege a rota do cron
Nenhum segredo vai para o repositório: .env* está no .gitignore (exceto .env.example).
Deploy (Vercel)
Crie um projeto no Supabase e aplique as migrações (npx supabase db push).
Em Supabase → Authentication → URL Configuration, cadastre a URL de produção como Site URL e https://SEU-DOMINIO/auth/confirm em Redirect URLs (para previews: https://*-SEU-USUARIO.vercel.app/auth/confirm).
Recomendado: em Authentication → Email Templates, troque o link de Confirm signup por
{{ .SiteURL }}/auth/confirm?token_hash={{ .TokenHash }}&type=email&next=/personal e o de Reset password por
{{ .SiteURL }}/auth/confirm?token_hash={{ .TokenHash }}&type=recovery&next=/redefinir-senha.
Assim o link funciona mesmo se aberto em outro aparelho/navegador.
Importe o repositório na Vercel e configure as variáveis de ambiente acima.
O vercel.json já agenda os crons (em UTC; Brasil sem horário de verão desde 2019):
relatório semanal 0 1 * * 1 = domingo 22h em São Paulo;
lembrete das aulas 0 10 * * * = todo dia às 7h em São Paulo.
No plano Hobby da Vercel o cron pode disparar em qualquer minuto daquela hora; no Pro, no minuto exato.
Defina CRON_SECRET na Vercel — ela envia esse valor automaticamente no header Authorization das chamadas de cron.
Scripts
Comando
O quê
npm run dev
servidor de desenvolvimento
npm run build
build de produção
npm run lint
ESLint
npm run typecheck
checagem de tipos
npm run test:unit
testes de unidade das funções puras (telefone, WhatsApp, agenda, estatísticas do dashboard)
npm run test:db
aplica as migrações num Postgres descartável (com stub do Supabase) e roda os testes SQL de RLS. Use PGHOST/PGPORT/PGUSER para apontar o servidor
Como funciona o acesso
Personal cria a conta em /cadastro e confirma o e-mail.
Aluno só entra por /convite/<token>. O cadastro é feito no servidor com a service role e a conta já nasce confirmada; um gatilho no banco valida o convite (pendente, não expirado, não revogado), exige o aceite do termo e o WhatsApp, e cria o vínculo com o Personal.
Compartilhar/Transferir: o Personal responsável faz o pedido na página do aluno; o outro Personal aceita em Pedidos. Compartilhar mantém os dois; transferir revoga o acesso do anterior. O aluno é notificado.
Toda escrita sensível passa por funções SECURITY DEFINER no Postgres; as tabelas têm RLS e só permitem leitura do que cada perfil pode ver.
Duplicar ficha (mesmo aluno, outro aluno ou como modelo) e aplicar modelo a um aluno
Aplicar a vários alunos de uma vez: escolher um ou mais modelos/fichas e vários alunos, com a opção de substituir (arquivar) as fichas atuais — tudo numa transação (apply_plans_to_students)
Fichas mostram quem criou; Personal compartilhado também monta fichas
Aluno vê suas fichas (somente leitura)
Etapa 5 — Execução
Execução: 3 séries por padrão, adicionar/remover séries, carga pré-preenchida com a última vez, reps com o alvo, Feita/Não feita
Timer de descanso automático (ajustável ±15s e por exercício), com som e vibração; tela ligada (Wake Lock)
Última carga/reps e recorde em cada exercício; recorde pessoal (PR) detectado ao salvar
Progresso salvo no aparelho durante o treino; treino finalizado sem internet fica na fila e sincroniza depois (idempotente)
Registro manual pelo Personal ("registrado pelo instrutor")
Histórico de treinos, detalhe do treino e histórico por exercício com gráfico de evolução de carga
Lista de alunos com treinos na semana (seg–dom, fuso SP), último treino e status
Migrações fichas e sessoes_treino aplicadas no Supabase de produção
Etapa 6 — Peso corporal
Registro de peso com data (um por dia; registrar de novo no mesmo dia corrige), histórico e gráfico
Privacidade: o Personal só vê o peso se o aluno permitir (padrão: não), garantido por RLS em todas as telas
Frequência de pesagem semanal ou quinzenal
Trava: com pesagem vencida o aluno não inicia treino (tela com o campo de peso); registro manual do Personal não é bloqueado; reforçada no banco
Página do aluno (Personal) mostra a situação da pesagem e o peso apenas quando permitido
Etapa 7 — Treino livre
Treino livre: o aluno monta o treino do dia escolhendo e ordenando exercícios do catálogo (sugere a última seleção)
Só exercícios do catálogo visível ao aluno (padrão + criados pelos seus Personais); aluno não cria exercício — garantido no banco
Mesma execução da ficha (séries, timer, histórico, trava de pesagem, offline) e aparece para os Personais como "livre"
Etapa 8 — Agenda e WhatsApp
Aulas presenciais recorrentes (dias da semana, horário, duração, início) com cancelamento de datas avulsas e reativação
Aluno é avisado de aula nova e de cancelamento; vê "Minhas aulas" e a próxima aula no início
Aulas semanais em um ou mais dias da semana (mesmo horário ou um horário por dia), que repetem todo mês até o Personal remover, ou aulas únicas numa data
Calendário mensal do Personal: alunos de cada dia, navegação entre meses, detalhe do dia (cancelar/reativar, WhatsApp, agendar aula naquele dia) e resumo dos alunos da semana
Lembrete às 7h (SP): notificação no app + e-mail ao Personal com os alunos do dia e o botão do WhatsApp de cada um (cron diário, idempotente)
Botão "Chamar no WhatsApp" na lista e na página do aluno (e na agenda), com telefone normalizado (DDI 55) e a mensagem "Olá, tudo bem? Confirmado nosso treino hoje?"
Testes de unidade (npm run test:unit) para telefone, link do WhatsApp e cálculo da agenda
Etapa 9 — Dashboard
Aba Evolução do aluno e página "Ver evolução" de cada aluno (Personal), com visões semanal (seg–dom) e mensal e navegação entre períodos
Treinos, volume (séries feitas × reps × carga), séries e tempo, comparados com o período anterior
Frequência por semana (últimas 8 semanas) em gráfico de barras
Progressão de carga por exercício (subiu / estável / caiu / primeira vez) com setas e cores; ranking de onde mais aumentou carga
Evoluções notáveis: recordes (PRs), semanas seguidas treinando e maior volume (com aviso de recorde de volume)
Peso corporal no período, respeitando a permissão do aluno (RLS)
Visão geral do Personal no início: ranking de frequência (semana/mês) e alunos sem treinar há 7+ dias
Agregados no banco (training_summary, training_overview, security invoker: o RLS decide o que cada um vê), com testes SQL e de unidade
Etapa 10 — Relatório de domingo
Todo domingo às 22h (SP) o cron gera o relatório de cada Personal: e-mail (Resend) + notificação + histórico em Relatórios
Por aluno: treinos da semana com as fichas feitas e os treinos livres, carga de cada exercício (aumentou/manteve/diminuiu), recordes, semanas seguidas e variação de peso (só com permissão do aluno)
Sugestões de estratégia por regras simples sempre, e ao lado as de cada IA configurada (Gemini e/ou Claude; dados pseudonimizados, sem nome), cada bloco com a fonte identificada
Comparação das IAs (fase de testes): status de cada IA no relatório, voto "qual sugestão foi mais útil" e placar em Relatórios
Inclui alunos compartilhados; idempotente (um relatório por semana, e-mail enviado uma vez)
Botão "Gerar prévia desta semana agora" (sem e-mail)
Tabela weekly_reports com RLS (Personal só lê os seus; só o servidor grava) + testes SQL e de unidade
Etapa 11 — PWA e polimento
Service worker (public/sw.js): telas de treino abrem sem internet (rede primeiro, cópia local), estáticos e imagens em cache, página offline.html para o resto; cache de páginas apagado ao sair da conta
Aviso de "sem internet" e convite para instalar o app (botão no Android; instruções no iPhone)
Treino em andamento salvo no aparelho e fila de sincronização (desde a etapa 5)
Novo logo: halter com anilhas, pegada recartilhada e travas (scripts/gerar-icones.py gera favicon, ícones do PWA e o logo)
Polimento: esqueletos de carregamento, tela de erro amigável, foco visível, respeito a "reduzir movimento", Agenda na navegação do Personal
Extras
Exportar ficha em PDF (ficha + folha de registro para imprimir e preencher à mão: carga, reps e ok por série em 5 dias) e CSV (uma linha por série, abre no Excel), para Personal e aluno
LGPD: o aluno baixa os próprios dados (JSON) e exclui a conta em Personais → Privacidade e meus dados (apaga tudo em cascata, remove dos relatórios e avisa os Personais)
Área do administrador
Papel admin (ninguém escolhe no cadastro nem altera o próprio papel; a promoção é feita no banco: update public.profiles set role = 'admin' where email = '...')
Painel com números do site (Personais, alunos, treinos, fichas, convites, aulas, relatórios) e cadastros recentes
Personais: lista com busca, detalhe com alunos (último treino de cada), edição do cadastro, bloqueio de edição de exercícios e exclusão (alunos são avisados e mantêm o histórico)
Alunos: lista com os Personais de cada um, detalhe e edição do cadastro (nome, e-mail de login, WhatsApp, nascimento)
Exercícios: travar exercícios específicos (padrão ou de Personais) — nenhum Personal edita, exclui ou troca a foto
Travas garantidas no banco (policies + set_equipment_image) e testadas (14_admin.test.sql)
