Mini Espacio - Sistema de Gestión para Gimnasios

Aplicación full stack desarrollada con FastAPI, Supabase y React/Vite para la operación diaria de un gimnasio. El proyecto hoy cubre clientes, pagos, asistencias, reportes, configuración del negocio y un primer módulo de rutinas por grupos musculares.

Demo online

• Frontend: https://libre-funcional.vercel.app/
• Backend: https://gymapp-backend-xe0n.onrender.com
• Healthcheck: GET /health

Qué resuelve hoy

• Gestión de clientes con alta, edición, estado y ficha operativa
• Registro y seguimiento de pagos
• Check-ins y calendario de asistencias
• Reportes de ingresos, asistencia y altas
• Configuración operativa del gimnasio
• Roles Dueño y Coach
• Rutinas por grupos musculares con carga de repeticiones y kilos

Módulos principales

Clientes

• Alta y edición de clientes
• Spotlight Search para búsqueda rápida
• Ficha con pagos recientes y calendario de asistencias

Pagos

• Registro de pagos por período
• Métodos cash y transfer
• Seguimiento de cobros pendientes

Asistencias

• Check-in por cliente
• Historial de asistencias
• Calendario visual por cliente

Reportes

• KPIs de ingresos
• Asistencia por rango
• Altas de clientes
• Detalle diario de check-ins

Ajustes

• Identidad del gimnasio
• Datos de contacto
• Medios de pago
• Mensaje operativo para recepción

Rutinas

• Día 1: Pecho y Bíceps
• Día 2: Espalda y Tríceps
• Día 3: Hombros
• Día 4: Piernas
• Plantilla global de ejercicios por día
• Selección de ejercicios activos por parte de owner/coach
• Registro de series, repeticiones, carga en kg y nota por cliente

Stack técnico

Frontend

• React + Vite
• TypeScript
• Tailwind CSS
• shadcn/ui
• React Router
• SweetAlert2

Backend

• FastAPI
• SQLAlchemy
• Alembic
• JWT Auth
• Routers modulares

Base de datos

• PostgreSQL en Supabase

Estructura del proyecto

backend/
|-- app/
|   |-- routers/
|   |-- auth.py
|   |-- config.py
|   |-- main.py
|   |-- middleware.py
|   |-- models.py
|   |-- routine_catalog.py
|   |-- schemas.py
|-- migrations/
|-- requirements.txt

frontend/
|-- public/
|-- src/
|   |-- components/
|   |-- lib/
|   |-- pages/
|   |-- types.ts
|-- package.json
|-- vite.config.js
|-- vercel.json

Desarrollo local

Backend

cd backend
pip install -r requirements.txt
python -m alembic upgrade head
uvicorn app.main:app --reload

Frontend

cd frontend
npm install
npm run dev

Usuario inicial

Si necesitás crear el usuario owner:

cd backend
python scripts/create_owner.py

Credenciales por defecto:

• Email: owner@miniespacio.com
• Password: Cambiar123

Deploy y sincronización

Frontend

• Desplegado en Vercel
• Si hay cambios de UI, alcanza con redeploy del frontend

Backend

• Desplegado en Render
• Si cambian modelos, routers o lógica de negocio, hacé redeploy del backend

Base de datos

• PostgreSQL en Supabase
• Si agregás migraciones nuevas, corré:

cd backend
python -m alembic upgrade head

Flujo recomendado cuando cambia backend

1. git pull o deploy del último commit
2. python -m alembic upgrade head
3. Redeploy de Render
4. Redeploy de Vercel si el frontend también cambió

Estado actual del proyecto

El sistema ya está listo para demo funcional. La siguiente etapa natural del roadmap es profundizar el módulo de rutinas:

• gráficos de progreso por ejercicio
• más contexto dentro de la ficha del cliente
• presets por objetivo o nivel

Autor

Ezequiel Bellino

• GitHub: https://github.com/ezebellino
• LinkedIn: https://www.linkedin.com/in/ezebellino

Licencia

MIT