Fit-Plataform — Caso de Estudio
Plataforma web multi-marca para que gimnasios publiquen sus rutinas con video, las entreguen a sus socios desde el móvil y protejan el contenido mientras la membresía física esté vigente.
1. Descripción General
Producto: Fit-Plataform es una base de código multi-marca que se despliega con la identidad, tema, catálogo y conexión de membresías de cada gimnasio.
Problema: Las rutinas enviadas por WhatsApp, PDF o papel se pierden, quedan obsoletas, no incluyen video y siguen circulando cuando el socio deja de pagar.
Propuesta: El gimnasio publica una vez y todos sus socios consultan la versión vigente desde una web instalable. El acceso se vincula a la membresía física y se corta al vencer, sin trasladar la base de clientes del dueño a la aplicación pública.
2. Arquitectura del Sistema
Visión General
El frontend es una SPA/PWA estática multi-marca. Firebase gestiona identidad, perfiles y rutinas; V-Forge aporta el catálogo y media licenciada. La instalación final incorpora un contenedor Docker en el equipo o red del dueño del gimnasio: ahí vive un API middleware que consulta el sistema local de socios y expone únicamente el estado indispensable para vincular y validar membresías.
┌─ Socios y administradores ──────────────────────────────┐
│ Móvil / Escritorio · Web instalable (PWA) │
└──────────────────────┬──────────────────────────────────┘
│ HTTPS
┌─ Fit-Plataform (build por marca) ───────────────────────┐
│ React + Vite + MUI · Firebase Auth · Firestore │
│ Rutinas · sesiones · ingesta IA · panel de organización │
└───────────────┬─────────────────────────┬───────────────┘
│ X-Api-Key │ HTTPS firmado
▼ ▼
┌─ V-Forge API ───────────────┐ ┌─ Instalación del gimnasio ──────────────┐
│ Catálogo y media licenciada │ │ Túnel seguro / reverse proxy │
│ filtrados por marca │ │ └─ Contenedor Docker: API middleware │
└─────────────────────────────┘ │ vinculación + estado de membresía │
│ └─ Sistema/BD local del dueño │
└──────────────────────────────────────────┘Flujo de vinculación y acceso
1. El socio crea su cuenta o inicia sesión. 2. Fit-Plataform envía correo, teléfono o pairing code al API middleware del gimnasio. 3. El middleware consulta la fuente local autorizada y vincula la cuenta al socio. 4. Devuelve solo tier, fecha de expiración y estado activo; no replica la base de datos completa. 5. MembershipGuard valida esa vigencia antes de mostrar rutinas. 6. Activo → rutina, ejercicios y videos. Vencido → acceso bloqueado y recordatorio de renovación.
Separación de responsabilidades
| Capa | Tecnología | Responsabilidad |
|---|---|---|
| Frontend | React + Vite + MUI + PWA | Experiencia de socio, entrenador y organización |
| Datos de aplicación | Firebase Auth + Firestore | Identidad, perfiles, rutinas y sesiones |
| Membresías local | API middleware + Docker | Puente protegido hacia el sistema de socios, códigos, vinculación y expiración |
| Biblioteca | V-Forge API | Ejercicios, miniaturas y videos por marca |
3. Tecnologías y Justificación
- React 19 + Vite + MUI: una base rápida y consistente para la experiencia móvil, el editor y los paneles administrativos.
- Firebase: autenticación y persistencia sin servidor propio para el frontend; el namespace de almacenamiento evita colisiones entre marcas.
- API middleware en contenedor: se instala junto a la operación del dueño del gimnasio y adapta su sistema de socios sin abrir ni duplicar su base de datos hacia internet.
- Ingesta inteligente: texto, PDF o imagen se convierten en sesiones estructuradas mediante PDF.js, Tesseract.js, Gemini y emparejamiento de ejercicios.
- PWA: el socio puede instalar la web en el teléfono sin App Store, mientras el gimnasio actualiza el contenido desde un solo panel.
4. Capturas de Pantalla
Capturas del frontend Fit-Plataform en sus flujos de acceso, consulta de entrenamiento y gestión.
5. Problemas Encontrados
La membresía no vive en el frontend
Reto: una cuenta Firebase no basta para saber si el socio está al corriente, y la base de clientes no debe salir de la operación del dueño.
Solución: un API middleware dentro de un contenedor Docker consulta el sistema local y devuelve únicamente el resultado de vinculación, vigencia y pairing code necesarios para proteger el contenido.
Un código base, varias marcas
Reto: duplicar la aplicación por gimnasio haría costosas las actualizaciones.
Solución: `VITE_BRAND_ID` selecciona un perfil declarativo con identidad, tema, storage y endpoints propios en build time.
Rutinas heredadas en papel
Reto: digitalizar manualmente cientos de sesiones consume tiempo y genera errores.
Solución: ingesta por texto, PDF o imagen, seguida de normalización y emparejamiento con el catálogo de ejercicios.
6. Decisiones Técnicas Clave
PWA en vez de aplicaciones nativas
Una misma experiencia sirve a socios y administradores, se instala desde el navegador y se actualiza sin tiendas ni dos codebases adicionales.
Middleware local de membresías
El gimnasio conserva la autoridad de sus clientes y pagos. El contenedor adapta su sistema local a Fit-Plataform mediante un túnel seguro; Firebase no se convierte en una copia desactualizada de la operación física.
Multi-marca declarativo
La marca no se resuelve con condicionales dispersos: cada tenant tiene un perfil con identidad, entorno, permisos y namespace de almacenamiento.
7. Aprendizajes
- La vigencia es una frontera de producto: proteger rutinas también convierte la renovación en un beneficio tangible.
- Multi-tenant no significa mezclar datos: marca, API key y cache deben aislarse desde configuración y servicios.
- La ingesta reduce deuda operativa: el valor de la IA está en transformar material existente, no en reemplazar el criterio del entrenador.
- El alcance importa: Fit-Plataform publica rutinas del gimnasio; no promete seguimiento individual, cargas ni historial que no formen parte del producto.
8. Documentación Técnica del Proyecto
Documento comercial y técnico con propuesta de valor, módulos, alcance, licenciamiento y arquitectura de Fit-Plataform.