Skip to content
AvilaCarlosDevPublic

About

App para entrenadores personales y sus clientes: rutinas asignadas, dieta, medidas, evolución y cobros. React + Supabase con seguridad por fila, PWA instalable. En producción.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

Forja

La app para entrenadores personales y sus clientes. Rutinas, dieta, medidas, progreso y cobros del coach con sus clientes: en el teléfono y en la computadora.

Probar Forja → · Novedades · Plan del proyecto

Pruebas Release Licencia PWA Hecho en


Forja en la computadora y en el teléfono: ficha de una clienta con sus medidas y la pantalla de entrada

Qué hace hoy

Entrenador Cliente
Cuenta Correo y contraseña o Google; foto de perfil Igual; menores de 18 con permiso de madre, padre o tutor
Gimnasio Elige uno o varios donde trabaja Elige el suyo, o «entreno en casa»
Vínculo Recibe la solicitud como notificación y acepta o rechaza Elige a su entrenador entre los de su gimnasio y puede cambiarlo
Medidas Carga peso, talla, grasa corporal y visceral, masa muscular, perímetros y meta Las ve en solo lectura; sin entrenador, carga lo básico él mismo
Historial Al recibir a un cliente, ve todo lo que trae de su entrenador anterior Su historial lo acompaña siempre
Rutinas Las arma con el buscador de ejercicios (con animación): series, repeticiones, peso e indicaciones Le llegan a su plan de la semana y las entrena tal cual
Dieta (Pro) Comidas con alimentos por porciones, objetivos de calorías y macros, plantillas y copiar de otro cliente La ve en Mi coach
Evolución (Pro) Gráfica por medida con la meta y avance desde el inicio Ve su peso y su meta en el inicio
Finanzas (Pro) Mensualidad por cliente, pagos registrados, pendientes y vencidos —
Avisos Solicitudes y respuestas «Tu coach te asignó una rutina», «te envió tu dieta», «cargó tus medidas»
Plan Free: hasta 5 clientes · Pro: ilimitados, dieta, evolución, comparativa y finanzas Nunca paga

Además, todo lo que trae openGym: más de 1.300 ejercicios, planificador semanal, entrenamiento guiado y estadísticas.

Lista inicial de gimnasios de Punto Fijo, cada uno con fuente oficial: Gold Stars Gym (Sambil Paraguaná, Las Virtudes y Ciudad del Viento), Altitude y New Life Training Center. Si falta el tuyo, lo agregas desde la app con su Instagram o una foto del logo (fuentes).

Cómo se ve

El coach y su cliente

Rutinas que el coach asigna a su clienta, con la animación de cada ejercicio, series, repeticiones y peso
Rutinas asignadas (coach)
Gráfica de evolución del peso con la meta y el avance desde el inicio
Evolución (Pro)
Dieta del cliente: objetivos de calorías y macros y comidas con sus alimentos
Dieta (Pro)
Finanzas del coach: cobrado, por cobrar, vencidos y pagos por cliente
Finanzas (Pro)
Inicio de la clienta: entrenamiento de hoy asignado por su coach y su peso con la meta
Inicio del cliente
Plan semanal de la clienta con las rutinas que le asignó su coach
Plan de la semana (cliente)

En el teléfono

Pantalla de entrada con video de un entrenador y su clienta
Entrar
Elegir gimnasio de Punto Fijo
Elegir gimnasio
Elegir entrenador del gimnasio
Elegir entrenador
Pasos para instalar Forja en iPhone
Instalar como app
Pestaña Clientes del entrenador con notificaciones y solicitudes
Clientes (entrenador)
Ficha de una clienta con medidas, meta y avance
Ficha del cliente
Mi coach: gimnasio, entrenador y medidas en solo lectura
Mi coach (cliente)
Crear cuenta como Personal Trainer o Cliente
Crear cuenta

Completar el perfil — la primera vez que se entra:

Tus datos: foto de perfil, nombre, sexo y fecha de nacimiento
Foto y datos
Menor de edad: permiso de madre, padre o tutor
Menores: permiso del tutor
Cuenta creada con Google: elegir Personal Trainer o Cliente y aceptar los términos
Entrar con Google: tipo de cuenta

En la computadora

Pantalla de entrada en la computadora Clientes del entrenador en la computadora
Ficha del cliente en la computadora Mi coach en la computadora

Capturas de la versión 0.8 con datos de ejemplo. Se regeneran con scripts/forja-screenshots.mjs.

Instálala en tu teléfono

Forja es una app web instalable (PWA): no hace falta tienda.

  • iPhone (Safari): Compartir → Agregar a inicio.
  • Android (Chrome): botón Instalar Forja en la pantalla de entrada, o menú ⋮ → Instalar app.

Privacidad y seguridad

  • Los datos se usan solo para operar y mejorar Forja. No se venden ni se ceden; sin publicidad ni rastreadores.
  • Cada tabla tiene seguridad por fila en Postgres: un entrenador solo ve a sus clientes activos, y el anterior pierde el acceso al cambiar de entrenador. Las reglas tienen pruebas automáticas que corren contra la base (supabase/tests).
  • La otra parte de un vínculo solo lee las columnas públicas del perfil; el perfil propio completo llega por una función de la base.
  • Fotos de perfil en almacenamiento privado, una carpeta por persona.
  • Cabeceras de seguridad en Vercel: CSP sin código en línea, frame-ancestors 'none', HSTS, nosniff y Referrer-Policy.
  • Términos y política de privacidad aceptados al crear la cuenta y al entrar.

Stack

Capa Tecnología
Frontend React 19 + Vite, PWA (heredado de openGym), sin SDK de Supabase: REST con fetch
Cuentas y datos Supabase: Auth, Postgres con RLS, Storage
Hosting Vercel
Pruebas Vitest (3.300+ tests, 160 propios de Forja) y 109 pruebas de permisos SQL en Supabase y en PGlite

Desarrollo

cd frontend
npm ci
npm test           # usar Node 22 (con Node 26 fallan tests en falso por localStorage)
npm run dev

Vista previa sin servidor (cuentas y datos de ejemplo en el navegador):

VITE_FORJA_AUTH_PREVIEW=1 npx vite

Sesiones demo con meses de datos (un coach Pro y una clienta): node scripts/forja-demo-sessions.mjs y abrir /demo/cargar-sesiones.html con el servidor de desarrollo. No llegan a producción.

Base de datos: las migraciones están en supabase/migrations y se aplican en orden en el editor SQL de Supabase. Para probar los permisos en local: node supabase/tests/run-local.mjs (con PGlite instalado).

Documentación

Basado en openGym

Forja es un fork de openGym, de Duarte Santos, un tracker de gimnasio autoalojado. De openGym vienen la librería de ejercicios, el planificador semanal, el workout guiado, las estadísticas y la PWA. Su README original se conserva en docs/upstream/README.openGym.md. Forja añade la capa de entrenador: cuentas, gimnasios, vínculo coach–cliente, medidas y planes.

Licencia y créditos

Forja se distribuye bajo GNU AGPL-3.0, la misma licencia de openGym, de la que es obra derivada. Ver LICENSE y NOTICE.md.

  • openGym — Copyright (C) 2026 Duarte Santos.
  • Modificaciones de Forja — Copyright (C) 2026 Carlos Ávila.
  • Video de la pantalla de entrada: Mixkit, licencia libre de Mixkit.

Los datos e imágenes de ejercicios son de terceros y tienen sus propias condiciones, detalladas en NOTICE.md.

About

App para entrenadores personales y sus clientes: rutinas asignadas, dieta, medidas, evolución y cobros. React + Supabase con seguridad por fila, PWA instalable. En producción.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages