Skip to content

About

FitProgress : plataforma full stack para acompanhamento de treinos, metas de carga, evolução corporal e nutrição com React, FastAPI e Supabase.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation


🏋️ FitProgress

Plataforma full stack para acompanhamento de treinos, evolução corporal, metas de carga e nutrição.


Python FastAPI React Supabase Docker TailwindCSS


status license rls



📋 Sumário


🎯 Visão Geral

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

✨ Funcionalidades

🗓️ 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

🛠️ Stack

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

📁 Estrutura do Projeto

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

🗄️ Banco de Dados

treinos

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

treino_semana

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

metas

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

exercicios

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.sql no SQL Editor do Supabase para criar todas as tabelas, índices, grants, políticas RLS e o catálogo inicial.


🔒 Segurança

✅  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

⚙️ Variáveis de Ambiente

⚠️ Nunca envie arquivos .env para o GitHub. Eles estão no .gitignore.

Backend — .env (raiz do projeto)

SUPABASE_URL=https://seu-projeto.supabase.co
SUPABASE_KEY=sua-chave-anon-public
CORS_ORIGINS=http://localhost:3001,http://127.0.0.1:3001

Frontend — frontend/.env

VITE_API_URL=http://localhost:8000
VITE_SUPABASE_URL=https://seu-projeto.supabase.co
VITE_SUPABASE_ANON_KEY=sua-chave-anon-public

Use sempre a chave anon public do Supabase.

Sobre a chave anon no frontend

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.


🐳 Rodando com Docker

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

💻 Rodando sem Docker

Backend

python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
uvicorn backend.main:app --reload

Frontend

cd frontend
npm install
npm run dev

📡 Rotas da API

Autenticação

Todas as rotas protegidas exigem o token JWT no header:

Authorization: Bearer SEU_ACCESS_TOKEN

Endpoints

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

🧪 Testes

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.

Testes existentes

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

Rodar os testes localmente

Na raiz do projeto:

pip install -r requirements.txt
pytest

Para uma saída mais detalhada:

pytest -v

Para rodar um arquivo específico:

pytest tests/test_pr_service.py
pytest tests/test_dashboard_service.py

Rodar com ambiente virtual

python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
pytest

O que ainda pode ser evoluído

  • Testes das rotas FastAPI com TestClient.
  • Testes de autenticação para validar respostas 401 sem 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.

☁️ Deploy na AWS EC2

# 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 --build

.env de produção

SUPABASE_URL=https://seu-projeto.supabase.co
SUPABASE_KEY=sua-chave-anon-public
CORS_ORIGINS=http://IP_PUBLICO_DA_EC2

Security Group — portas necessárias

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.

Observação sobre SSH e Security Group

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.

🧰 Comandos Úteis

# 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

🚫 Arquivos que não devem ir ao GitHub

.env
frontend/.env
node_modules/
frontend/node_modules/
frontend/dist/
venv/
__pycache__/
*.pyc

Arquivos de exemplo podem ir: .env.production.example e frontend/.env.example


FitProgress · Desenvolvido para portfólio e estudos

About

FitProgress : plataforma full stack para acompanhamento de treinos, metas de carga, evolução corporal e nutrição com React, FastAPI e Supabase.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages