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)
