Sistema completo de gestão para academias — gerencie alunos, treinos, exercícios e evolução física em um único lugar.
GymManager é uma aplicação web progressiva (PWA) desenvolvida em React + TypeScript para gestão de academias. O sistema opera 100% no navegador utilizando localStorage como banco de dados, sem necessidade de backend ou servidor.
| Responsável | GitHub |
|---|---|
| Anderson Chrispim da Silva | @ChrispimSilva |
| Israel Felipe Chaves da Silva | @Raelmat |
| Kayque Pardim dos Santos | @kayque-pardim |
| Marcus Vinícius Campos Machado | @marcusmachado91 |
| Nathan de Sales Messias | @NathanosPregui |
| Robson Silva de Pinho | @RobSlva |
| Fernanda Macedo Klein | @Fernanda9209 |
| Funcionalidade | Descrição |
|---|---|
| 🔐 Autenticação Multi-Tenant | Login segmentado por perfil (SuperAdmin, Admin/Academia, Personal, Aluno) e isolamento por Tenant |
| 🏢 Gestão de Academias & Assentos | Painel SuperAdmin para administrar academias (Tenants), contas Admin e ocupação de assentos (Seats) |
| 👥 Gestão de Equipe & Alunos | Cadastro de Personais e Alunos com controle de assentos ativos, medidas corporais e status |
| 🏋️ Montagem de Treinos | Criação de fichas de treino vinculadas a alunos com séries, repetições e carga |
| 💪 Catálogo de Exercícios | +200 exercícios com GIFs animados, filtro por grupo muscular e equipamento |
| 📊 Evolução Física | Acompanhamento de peso, % gordura, massa muscular e IMC com gráficos |
| 📱 PWA | Instalável no celular/desktop, funciona offline |
| 🌙 Tema Escuro/Claro | Alternância de tema com persistência |
| 📜 Histórico de Atividades | Log de ações realizadas no sistema |
| Perfil | Escopo | Permissões |
|---|---|---|
| SuperAdmin | Plataforma (SaaS) | Dono da plataforma; gerencia Academias (Tenants), usuários Admin e limites/uso de assentos |
| Admin | Tenant (Academia) | Dono da academia; gerencia Personais, Alunos, treinos, aparelhos, identidade visual e assentos do tenant |
| Personal | Tenant (Academia) | Funcionário da academia; gerencia treinos, alunos, aparelhos, exercícios e evolução no seu tenant |
| Aluno | Tenant (Academia) | Visualiza e executa seus treinos, consulta exercícios, evolução pessoal e histórico no seu tenant |
## 🛠️ Stack Tecnológica
- React 19 — Biblioteca de UI
- TypeScript 6 — Tipagem estática
- Vite 8 — Build tool e dev server
- Tailwind CSS 4 — Framework CSS utilitário
- React Router 7 — Roteamento SPA
- Chart.js + react-chartjs-2 — Gráficos de evolução
- Lucide React — Ícones SVG
- Vite PWA Plugin — Suporte a Progressive Web App
- Node.js ≥ 18
- npm (incluso no Node.js) ou yarn / pnpm
# 1. Clone o repositório
# Via HTTPS
git clone https://github.com/ChrispimSilva/gymmanager.git
# Ou via SSH
git clone git@github.com:ChrispimSilva/gymmanager.git
# 2. Entre na pasta do projeto
cd gymmanager
# 3. Instale as dependências
npm install
# 4. Inicie o servidor de desenvolvimento
npm run devO servidor será iniciado em http://localhost:5173 e ficará acessível também na rede local.
| Comando | Descrição |
|---|---|
npm run dev |
Inicia o servidor de desenvolvimento com HMR |
npm run build |
Compila o TypeScript e gera o build de produção na pasta dist/ |
npm run preview |
Pré-visualiza o build de produção localmente |
npm run lint |
Executa o ESLint para análise estática do código |
O sistema inclui dados de exemplo pré-carregados via localStorage. Na primeira execução, quatro usuários ficam disponíveis:
| Perfil | Senha | Escopo | |
|---|---|---|---|
| SuperAdmin | superadmin@gym.com |
super123 |
Dono da Plataforma (Gerencia Academias / Admins) |
| Admin | admin@gym.com |
admin123 |
Dono da Academia (tenant-default) |
| Personal | personal@gym.com |
personal123 |
Personal da Academia (tenant-default) |
| Aluno | aluno@gym.com |
aluno123 |
Aluno da Academia (tenant-default) |
Nota: Todos os dados são armazenados no
localStoragedo navegador. Limpar os dados do navegador restaurará o estado inicial da aplicação.
gymmanager/
├── public/ # Arquivos estáticos (favicon, ícones PWA)
├── src/
│ ├── assets/ # Imagens e SVGs da aplicação
│ ├── components/
│ │ └── layout/ # Header, Sidebar, MobileNav, MainLayout
│ ├── contexts/ # AuthContext, ThemeContext (React Context API)
│ ├── data/ # Catálogo de exercícios (exercises.json)
│ ├── hooks/ # Custom hooks (useExercises)
│ ├── pages/ # Páginas da aplicação
│ │ ├── LoginPage.tsx # Tela de login e cadastro
│ │ ├── DashboardPage.tsx
│ │ ├── StudentsPage.tsx
│ │ ├── WorkoutsPage.tsx
│ │ ├── MyWorkoutsPage.tsx
│ │ ├── ExercisesPage.tsx
│ │ ├── ProgressPage.tsx
│ │ └── HistoryPage.tsx
│ ├── services/ # Camada de serviços (CRUD via localStorage)
│ │ ├── userService.ts
│ │ ├── studentService.ts
│ │ ├── workoutService.ts
│ │ ├── progressService.ts
│ │ └── activityService.ts
│ ├── types/ # Definições de tipos TypeScript
│ ├── utils/ # Dados iniciais (seed)
│ ├── App.tsx # Rotas e providers
│ ├── main.tsx # Entry point
│ └── index.css # Estilos globais
├── index.html # HTML template
├── vite.config.ts # Configuração do Vite + PWA
├── tsconfig.json # Configuração do TypeScript
├── eslint.config.js # Configuração do ESLint
├── package.json
└── .gitignore
Para entender a fundo como o projeto funciona e conferir o plano de testes, consulte os documentos:
- 📖 docs/ARCHITECTURE.md — Arquitetura técnica, diagramas de entidades, fluxo de autenticação e guia de migração.
- 📋 docs/QA.md — Manual de QA, instruções para subir a aplicação localmente e matriz de cenários de teste funcionais e de regressão.
- 🧭 docs/USER_JOURNEYS.md — Documentação visual das jornadas de usuário por perfil (
SuperAdmin,Admin,PersonaleAluno) com capturas via Playwright.
Nota: Este projeto usa
localStorageatravés do Repository Pattern com interfaces desacopladas (ideal para estudo, prototipação e PWA offline). Consulte o guia de migração na documentação para evoluir para um backend real.
Contribuições são bem-vindas! Para contribuir:
- Faça um fork do projeto
- Crie uma branch para sua feature (
git checkout -b feature/nova-feature) - Faça o commit das suas alterações (
git commit -m 'feat: adiciona nova feature') - Faça o push para a branch (
git push origin feature/nova-feature) - Abra um Pull Request
Distribuído sob a licença MIT. Veja o arquivo LICENSE para mais informações.
Feito com 💚 para a comunidade fitness
