Fit-Plataform — Dossier Comercial y README

1. Introducción y Propósito

Fit-Plataform es una plataforma digital multi-marca para gimnasios que publica rutinas con video y las entrega a sus socios desde cualquier dispositivo mientras su membresía esté vigente.

El problema

El papel, PDF y WhatsApp desorganizan el entrenamiento, no muestran la técnica en el momento y dejan el contenido fuera del control del gimnasio cuando un socio deja de pagar. Además, cada negocio tiene su propia operación de recepción y su propia fuente de datos de socios.

La solución

• El entrenador publica una rutina y todos ven la versión actual.
• Cada ejercicio puede incluir video, series, repeticiones, descanso y notas.
• La cuenta se vincula con la membresía física mediante correo, teléfono o pairing code.
• Un middleware instalado en el gimnasio consulta el estado real de la membresía.
• El acceso se bloquea cuando la membresía expira, sin exponer la base de clientes.

2. Arquitectura e Infraestructura

La solución separa la experiencia pública, los datos de la aplicación y la operación privada del gimnasio. Cada marca recibe su propio build; el dueño conserva su sistema de socios como fuente de verdad.

A. Diagrama de infraestructura

Socios / entrenador
        │ HTTPS
        ▼
Fit-Plataform (React SPA + PWA por marca)
├── Firebase Auth + Firestore
├── Rutinas, sesiones, organización e ingesta IA
├── X-Api-Key → V-Forge API (catálogo y media)
└── HTTPS firmado → túnel seguro del gimnasio
                         │
                         ▼
Instalación del dueño del gimnasio
├── Reverse proxy / túnel seguro
├── Contenedor Docker: API middleware
│   ├── vinculación por correo, teléfono o pairing code
│   └── consulta de vigencia de membresía
└── Sistema o BD local de socios y pagos

B. Flujo de vinculación y acceso

1. El socio crea su cuenta o inicia sesión.
2. Fit-Plataform envía su correo, teléfono o pairing code al middleware.
3. El middleware consulta el sistema local autorizado del gimnasio.
4. Si hay coincidencia, devuelve estado, tier y fecha de expiración.
5. Fit-Plataform guarda la vinculación mínima para la experiencia web.
6. MembershipGuard comprueba la vigencia antes de mostrar rutinas.
   ├── Activa → acceso a rutinas, ejercicios y videos.
   └── Vencida → contenido bloqueado y recordatorio de renovación.

Principio de privacidad

El contenedor no convierte Firebase en una copia de la operación del gimnasio. Actúa como adaptador: recibe solicitudes autenticadas, consulta la fuente local y devuelve solo los datos mínimos para la vinculación y el control de acceso.

3. Módulos del Producto

• Entrenamiento: rutinas, sesiones, calendario, ejercicios y publicación.
• Biblioteca: ejercicios con clasificación, miniatura y video; V-Forge puede aportar catálogo y media licenciada.
• Ingesta inteligente: texto, PDF o imagen convertidos a estructura digital con PDF.js, Tesseract.js y Gemini.
• Panel de organización: identidad del negocio, miembros, vinculación y estado de membresía.
• Video propio: asociación de contenido del gimnasio desde sus propias fuentes.
• Marca propia: nombre, logo, colores, roles y textos configurables por cliente.

Instalación de membresías

El módulo que conecta las membresías físicas se despliega como un contenedor Docker en un equipo o red bajo control del dueño. Su API middleware se adapta al sistema que el gimnasio ya utiliza, por lo que el modelo de datos local puede mantenerse independiente de Fit-Plataform.

4. Modelo Multi-Marca

Una marca es un tenant. VITE_BRAND_ID selecciona el perfil en tiempo de compilación, evitando duplicar la aplicación por cliente.

• Identidad: nombre, tagline y roles del gimnasio.
• Entorno: API de catálogo, assets, middleware de membresías y OAuth.
• Aislamiento: brandId, API key y prefijo de localStorage.
• Temas: variante visual por organización sin ramificar el producto.

5. Alcance Actual y Despliegue

Incluido: publicación de rutinas, videos, vinculación de socios, control de acceso por vigencia, panel de administración, ingesta de rutinas y web instalable.

En la instalación final: configuración de la marca y despliegue del API middleware en contenedor, con un túnel o proxy seguro hacia la operación local del gimnasio.

Fuera del alcance: planes individualizados por socio, registro de cargas, historial de entrenamiento, nutrición, red social y analítica de negocio.

6. Estructura Comercial e Inversión

Fit-Plataform se contrata como una suscripción para el gimnasio, dimensionada por su número de socios activos. El presupuesto separa la puesta en marcha de la operación mensual, para que cada cliente contrate únicamente los componentes que necesita.

Suscripción mensual

El precio se cotiza según el número de socios activos y los módulos contratados. Hosting de la plataforma, actualizaciones y soporte se consideran dentro de la suscripción; el gimnasio aporta un equipo o servicio donde se ejecutará el middleware y su conexión a internet.

7. Módulo Adicional: API V-Forge

La API V-Forge es una integración opcional para los gimnasios que desean una biblioteca de ejercicios lista para usar, sin tener que producir desde cero una imagen, explicación y video para cada movimiento.

Biblioteca profesional bajo licencia

• Catálogo centralizado: ejercicios organizados para que el entrenador los encuentre y los agregue a una rutina con rapidez.
• Material de apoyo: cada ejercicio puede incluir nombre, clasificación, descripción técnica, miniatura y video de ejecución.
• Integración por marca: la API usa una credencial propia del gimnasio y entrega únicamente el contenido autorizado para su tenant.
• Eficiencia operativa: el entrenador selecciona un ejercicio y la plataforma asocia la información visual disponible, reduciendo la captura manual.

8. Referencias Técnicas

La especificación funcional completa se encuentra en Fit-Plataform/docs/SRS.md; la propuesta comercial detallada está en Fit-Plataform/docs/DOSSIER_COMERCIAL.md. El middleware de membresías debe documentar, por gimnasio, el contrato de conexión con su sistema local.