Plataforma full stack para acompanhamento de treinos, evolução corporal, metas de carga e nutrição.
- Visão Geral
- Funcionalidades
- Stack
- Estrutura do Projeto
- Banco de Dados
- Segurança
- Variáveis de Ambiente
- Rodando com Docker
- Rodando sem Docker
- Rotas da API
- Testes
- CI/CD
- Deploy na AWS
- Comandos Úteis
FitProgress é um dashboard moderno de academia com autenticação via Supabase, backend em FastAPI e frontend em React. O sistema permite que o usuário:
- Faça login e cadastro via Supabase Auth com renovação automática de sessão
- Cadastre e acompanhe treinos planejados por dia da semana
- Execute treinos registrando séries, cargas e repetições reais
- Visualize recordes pessoais (PRs) por exercício calculados automaticamente
- Crie metas de carga e repetições com detecção automática de conclusão
- Registre evolução de peso com gráfico histórico
- Registre refeições com calorias, proteína e tipo de refeição
- Use tema claro/escuro com personalização visual
🗓️ Planejamento Semanal
- Cadastro de treino por dia da semana
- Cada treino pode conter múltiplos exercícios com nome, grupo muscular, categoria, séries, repetições e carga alvo
🏃 Execução de Treinos
- Seleção de treino planejado
- Registro de execução real com séries, cargas e repetições
- Histórico completo por sessão
- Remoção de registros individuais
- Suporte a treinos avulsos
🏆 Recordes Pessoais (PRs)
- Cálculo automático de PRs com base nos treinos registrados
- PRs recentes visíveis no dashboard principal
🎯 Metas
- Cadastro de meta por exercício (carga e repetições opcionais)
- Barra de progresso visual
- Conclusão manual ou detecção automática com base nos PRs
⚖️ Evolução de Peso
- Registro de peso por data
- Histórico e gráfico de evolução corporal via Recharts
🥗 Dieta & Nutrição
Registro por data com:
| Campo | Opções |
|---|---|
| Tipo de refeição | Café · Almoço · Janta · Pré treino · Pós treino · Lanche · Livre |
| Nutrição | Calorias · Proteína (g) |
| Descrição | Texto livre dos alimentos |
💪 Catálogo de Exercícios
- Catálogo inicial pré-carregado
- Filtro por grupo muscular
- Busca por nome
- Criação de exercícios personalizados
- Favoritos por usuário
| Camada | Tecnologias |
|---|---|
| Backend | Python · FastAPI · Pydantic · Uvicorn · Supabase Python Client |
| Frontend | React · Vite · TailwindCSS · Axios · React Router · Recharts |
| Banco & Auth | Supabase PostgreSQL · Supabase Auth · JWT · Row Level Security |
| Infra | Docker · Docker Compose · Nginx (produção) · AWS EC2 |
project01/
├── backend/
│ ├── main.py
│ ├── db.py
│ ├── auth.py
│ ├── routes/
│ │ ├── dashboard.py
│ │ ├── dieta.py
│ │ ├── exercicios.py
│ │ ├── metas.py
│ │ ├── peso.py
│ │ ├── semana.py
│ │ └── treinos.py
│ ├── schemas/
│ │ ├── dieta_schema.py
│ │ ├── exercicio_schema.py
│ │ ├── meta_schema.py
│ │ ├── peso_schema.py
│ │ ├── semana_schema.py
│ │ └── treino_schema.py
│ └── services/
│ ├── dashboard_service.py
│ └── pr_service.py
│
├── frontend/
│ └── src/
│ ├── components/
│ ├── context/
│ ├── layout/
│ ├── pages/
│ ├── services/
│ └── utils/
│
├── supabase/
│ └── schema.sql ← execute no SQL Editor do Supabase
│
├── docker-compose.yml
├── docker-compose.prod.yml
├── requirements.txt
└── README.md
| Campo | Tipo | Descrição |
|---|---|---|
id |
uuid | Identificador único |
usuario_id |
uuid | Vinculado ao auth.uid() |
sessao_id |
uuid | Agrupador de sessão |
nome_treino |
text | Nome da sessão |
exercicio |
text | Nome do exercício |
grupo |
text | Grupo muscular |
categoria |
text | Categoria do exercício |
series |
int | Número de séries |
carga |
numeric | Carga utilizada |
repeticoes |
int | Repetições executadas |
data |
date | Data do treino |
created_at |
timestamp | Criação do registro |
| Campo | Tipo | Descrição |
|---|---|---|
id |
uuid | Identificador único |
usuario_id |
uuid | Vinculado ao auth.uid() |
dia_semana |
text | Dia da semana |
nome_treino |
text | Nome do treino planejado |
exercicios |
jsonb | Lista de exercícios planejados |
| Campo | Tipo | Descrição |
|---|---|---|
exercicio |
text | Exercício alvo |
meta_carga |
numeric | Carga alvo |
meta_repeticoes |
int | Repetições alvo (opcional) |
concluida |
boolean | Status da meta |
concluida_em |
timestamp | Data de conclusão |
| Campo | Tipo | Descrição |
|---|---|---|
nome |
text | Nome do exercício |
grupo |
text | Grupo muscular |
categoria |
text | Categoria |
criado_por |
uuid | null = padrão · auth.uid() = personalizado |
Setup: execute
supabase/schema.sqlno SQL Editor do Supabase para criar todas as tabelas, índices, grants, políticas RLS e o catálogo inicial.
✅ Backend valida JWT antes de qualquer rota protegida
✅ usuario_id nunca vem do body — obtido do token autenticado
✅ Todas as rotas protegidas usam Depends(get_current_user)
✅ Consultas usam cliente Supabase autenticado com JWT do usuário
✅ RLS garante que cada usuário acessa apenas seus próprios dados
✅ Favoritos e exercícios personalizados isolados por usuário
⚠️ Nunca use a chave service_role no backend deste projeto
⚠️ Nunca envie arquivos.envpara o GitHub. Eles estão no.gitignore.
SUPABASE_URL=https://seu-projeto.supabase.co
SUPABASE_KEY=sua-chave-anon-public
CORS_ORIGINS=http://localhost:3001,http://127.0.0.1:3001VITE_API_URL=http://localhost:8000
VITE_SUPABASE_URL=https://seu-projeto.supabase.co
VITE_SUPABASE_ANON_KEY=sua-chave-anon-publicUse sempre a chave
anon publicdo Supabase.
O frontend usa VITE_SUPABASE_ANON_KEY. Em projetos Vite, toda variável iniciada com VITE_ é embutida no bundle final e fica visível no navegador.
Isso é uma decisão consciente neste projeto: a chave anon public do Supabase foi feita para uso em clientes web. A proteção dos dados não depende de esconder essa chave, e sim das políticas de RLS no Supabase, da validação do JWT no backend e da regra usuario_id = auth.uid().
Nunca use a chave service_role no frontend. Essa chave tem privilégios administrativos e deve permanecer fora do cliente.
Pré-requisitos: Docker Desktop · Docker Compose · Projeto Supabase configurado
# Subir
docker compose up --build
# Parar
docker compose down
# Limpar containers órfãos
docker compose down --remove-orphans| Serviço | URL |
|---|---|
| Frontend | http://localhost:3001 |
| API | http://localhost:8000 |
| Swagger | http://localhost:8000/docs |
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
uvicorn backend.main:app --reloadcd frontend
npm install
npm run devTodas as rotas protegidas exigem o token JWT no header:
Authorization: Bearer SEU_ACCESS_TOKEN| Método | Rota | Descrição |
|---|---|---|
GET |
/ |
Health check |
GET |
/dashboard/resumo |
Resumo do dashboard |
GET POST |
/treinos |
Listar / criar treino |
GET POST |
/treinos/sessoes /treinos/sessao |
Sessões |
GET |
/treinos/pr |
Recordes pessoais |
PATCH DELETE |
/treinos/{id} |
Editar / remover treino |
GET POST |
/semana |
Planejamento semanal |
PATCH DELETE |
/semana/{id} |
Editar / remover dia |
GET POST |
/peso |
Registros de peso |
PATCH DELETE |
/peso/{id} |
Editar / remover peso |
GET POST |
/metas |
Metas |
PATCH DELETE |
/metas/{id} |
Editar / remover meta |
GET POST |
/dieta |
Refeições |
PATCH DELETE |
/dieta/{id} |
Editar / remover refeição |
GET POST |
/exercicios |
Catálogo de exercícios |
GET POST |
/exercicios/favoritos |
Favoritos |
DELETE |
/exercicios/favoritos/{id} |
Remover favorito |
O projeto possui testes automatizados iniciais para a camada de serviços do backend. Eles ajudam a garantir que as regras principais de cálculo continuem funcionando durante refatorações e novas funcionalidades.
| Arquivo | O que valida |
|---|---|
tests/test_pr_service.py |
Cálculo de recordes pessoais por exercício, tratamento de cargas inválidas e dados incompletos |
tests/test_dashboard_service.py |
Montagem do resumo do dashboard, totais, último treino, peso atual e métricas semanais |
Na raiz do projeto:
pip install -r requirements.txt
pytestPara uma saída mais detalhada:
pytest -vPara rodar um arquivo específico:
pytest tests/test_pr_service.py
pytest tests/test_dashboard_service.pypython -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
pytest- Testes das rotas FastAPI com
TestClient. - Testes de autenticação para validar respostas
401sem token. - Testes de integração simulando respostas do Supabase.
- Testes de componentes críticos do frontend, principalmente login, seleção de exercícios e formulários.
# 1. Clonar repositório
git clone URL_DO_REPOSITORIO fitprogress
cd fitprogress
# 2. Criar arquivo .env
nano .env
# 3. Subir em produção
docker compose -f docker-compose.prod.yml up -d --buildSUPABASE_URL=https://seu-projeto.supabase.co
SUPABASE_KEY=sua-chave-anon-public
CORS_ORIGINS=http://IP_PUBLICO_DA_EC2| Porta | Protocolo | Uso |
|---|---|---|
22 |
TCP | SSH |
80 |
TCP | HTTP |
443 |
TCP | HTTPS (opcional) |
Em produção o frontend usa
VITE_API_URL=/api— o Nginx faz proxy para o backend pelo mesmo domínio.
Secrets:
| Secret | Descrição |
|---|---|
SUPABASE_URL |
URL do projeto Supabase, exemplo https://xxxx.supabase.co |
SUPABASE_KEY |
Chave anon public do Supabase |
EC2_HOST |
IP público ou domínio da EC2 |
EC2_USER |
Usuário SSH da EC2, normalmente ubuntu |
EC2_SSH_KEY |
Conteúdo completo da chave privada .pem |
EC2_PROJECT_PATH |
Caminho do projeto na EC2, exemplo /home/ubuntu/fitprogress |
O arquivo .env de produção continua existindo somente na EC2. Ele não é versionado e não deve ser enviado ao GitHub.
Para o deploy automático funcionar, o GitHub Actions precisa conseguir conectar via SSH na EC2.
Se o Security Group estiver com a porta 22 liberada apenas para o seu IP pessoal, o deploy automático não conseguirá acessar a instância. Para um ambiente de portfólio, é possível liberar SSH temporariamente para a origem necessária durante a configuração, mantendo a autenticação por chave privada.
Em produção real, prefira uma abordagem mais restrita, como:
- AWS Systems Manager Session Manager.
- Runner self-hosted dentro da própria VPC.
- Pipeline que atualiza dinamicamente a regra SSH apenas durante o deploy.
# Docker local
docker compose up --build
docker compose down
docker compose restart backend
docker compose restart frontend
# Docker produção
docker compose -f docker-compose.prod.yml up -d --build
docker compose -f docker-compose.prod.yml logs -f
docker compose -f docker-compose.prod.yml down
# Backend local
uvicorn backend.main:app --reload
# Testes do backend
pytest
# Frontend local
cd frontend && npm run dev
cd frontend && npm run build.env
frontend/.env
node_modules/
frontend/node_modules/
frontend/dist/
venv/
__pycache__/
*.pyc
Arquivos de exemplo podem ir:
.env.production.exampleefrontend/.env.example
FitProgress · Desenvolvido para portfólio e estudos