V-Forge — Documentación Técnica

1. Propósito

V-Forge es una plataforma para convertir el entrenamiento personalizado en un flujo medible: planificar, ejecutar, registrar y aprender de cada sesión.

El producto está diseñado alrededor del atleta, pero también contempla entrenadores, nutrición, administración, catálogo multimedia y herramientas de creación asistidas por IA.

2. Módulos del Producto

• Entrenamiento: rutinas, sesiones, modo de entrenamiento, descanso y progreso.
• Registro de cargas: pesos, series y repeticiones como base del historial.
• Nutrición: perfil biométrico, alimentos, recetas y planes.
• Creación: ingesta desde texto, PDF o imagen, generación con Gemini y planificación manual.
• Bibliotecas: ejercicios, alimentos, demostraciones y media.
• Perfiles y comunidad: configuración, privacidad, perfiles públicos y funciones sociales.

3. Arquitectura

React + TypeScript + MUI + PWA
          │
          ├── Firebase Auth / Firestore
          │     ├── usuarios y perfiles
          │     ├── rutinas y sesiones
          │     └── registros de entrenamiento
          │
          ├── Servicios .NET / API Gateway
          │     └── catálogo, media e integraciones
          │
          ├── MongoDB
          │     └── datos de soporte y producto
          │
          └── Gemini / ingesta
                └── propuesta editable de rutinas

La separación entre componentes, servicios y datos permite evolucionar cada módulo sin convertir la interfaz en el lugar donde vive toda la lógica de negocio.

4. Principios de Producto

• Dato sobre estética: primero registrar progreso real, después visualizarlo.
• IA como copiloto: toda sugerencia se puede revisar y editar.
• Mínima fricción: una sesión debe poder avanzar con pocos toques.
• Privacidad y control: perfiles, organización y datos de entrenamiento requieren límites claros.

5. Alcance

El kernel cubre entrenamiento, nutrición, perfiles, comunidad, bibliotecas, configuración, tutoriales y creación asistida. La arquitectura también conserva puntos de extensión para nuevas marcas, organizaciones y servicios externos.

6. Evolución Técnica

El proyecto ha evolucionado desde una experiencia de rutinas hacia una plataforma de progreso: separación de sesiones, registro de cargas, modo de entrenamiento, ingesta de documentos, generación contextual y visualización de evolución.

7. Referencias del Proyecto

La visión de producto, los planes de implementación y la documentación de arquitectura viven en el repositorio V-Forge Kernel. La aplicación pública utilizada para las capturas es v-forge.web.app.