TrainUP Destacado
En producción · cliente de pagojun 2026 – actualidad · cofundador · repositorio privado0.2 publicada el 28 oct 2026 · 0 rollbacks
Un SaaS multi-tenant de gestión de gimnasios: membresías, reservas, pagos, métricas de progreso de los atletas y consolas de administración y de plataforma. Una sola instalación atiende a muchos gimnasios independientes.
| Medida | Valor | Contexto |
|---|---|---|
| Cuentas de socio | 100 | con el rol de socio |
| Reservas | Más de 2.600 | desde el 18 ago 2026 |
| Reservas en octubre | Más de 1.100 | con fecha de octubre de 2026, incluidas las ya agendadas del 29 al 31 |
| Socios que reservaron en octubre | 96/100 | al menos una reserva cada uno |
| Pagos aprobados | 233 | desde el lanzamiento |
| Tests en CI | 628 | suite completa de 0.2.2, obligatoria en cada PR junto con gitleaks |
| Rollbacks en la versión 0.2 | 0 | tres publicaciones el 28 oct 2026 |
| Medido en septiembre de 2026 | ||
| Miembros activos | 101 | de 117 registrados |
| Ingresos enviados en la app | 97 % | de los ingresos de septiembre (Pago Móvil) en lugar de efectivo |
| Capacidad en horas pico | 15 → 20 | por turno (+33 %); la subió el gimnasio usando la vista de ocupación en vivo |
| Escenarios de despliegue | 26 | automatizados; pasan en macOS y en una réplica Ubuntu del servidor |
De la fundación a la versión 0.2
- jun 2026Cofundación; la plataforma la construye un equipo de dos personas.
- 16 ago 2026En producción con su primer cliente, un gimnasio, con 30 días de prueba gratuita.
- 17 sep 2026El gimnasio pasa a ser cliente de pago.
- 28 oct 2026Sale la versión 0.2 en tres publicaciones, con 0 rollbacks.
Gimnasio demo · datos sintéticos
Antes

Después

Lo que construí
- Landing page pública
- Módulo de miembros (clientes)
- Módulo de métricas de progreso
- Módulo de pagos (flujos de miembro y admin)
- Consola de super-admin
- Motor de reservas
- Remediación de seguridad
- Sistema de releases/despliegue
- Toda la 0.2: rediseño, feed del socio, check-in, metas, lista de espera
Mi cofundador construyó los módulos restantes y ayudó a pulir los míos.
Demo disponible bajo solicitud
TrainUP está en producción con un cliente real, así que no publico accesos compartidos. Si quieres probarlo, te envío un acceso temporal al demo con datos de ejemplo, normalmente en menos de 24 horas.
Diseñado para móvil; se ve mejor en el teléfono.
- commit en main
- backup de BD
- nuevo directorio
- migrar (expand)
- cambiar symlink
- salud: versión exacta
- en vivo, sin caídarollback automático
Leer el caso de estudio de la versión 0.2 (oct 2026)
El problema
En el teléfono, la app del socio era densa. En 176 capturas de la app demo (44 pantallas a 360, 390, 768 y 1280 px) había 2.706 textos de menos de 12 px y 96 campos de menos de 16 px, en los que iOS hace zoom. Algunos estados se contradecían, como una insignia Pendiente sobre una membresía Inactiva.
Mi hipótesis era que, fuera de reservar o pagar, el socio no tenía motivo para abrir la app. Es una hipótesis, no una medición; cómo la pondría a prueba está en “Qué mediría después”.
Qué trajo la 0.2
Rediseño
- La app del socio, el panel del admin y la consola de super-admin, rehechos sobre un design system documentado en
DESIGN.md. - Tokens de color por gimnasio generados en el servidor a partir del tema de cada uno; el texto secundario derivado mantiene un contraste de 4,5:1 o más.
- Un solo kit de componentes accesible sobre Reka UI: los diálogos atrapan el foco, se cierran con Escape y tienen semántica de diálogo en todas partes.
Feed del socio
- Se arma en el servidor, en un solo servicio (
MemberFeedService); la página solo lo pinta. - Un único aviso priorizado: membresía por vencer o vencida, cupo obtenido en la lista de espera o un feriado en los próximos 7 días.
- La próxima clase con su ocupación real y un archivo de calendario (
.ics, RFC 5545). - Racha semanal y calendario del mes, contrastados con SQL independiente sobre datos reales.
- “Repite tu semana” vuelve a reservar los horarios de la semana anterior por el flujo real de reserva, uno por uno.
- Un resumen mensual y la renovación con el plan actual ya elegido.
Funciones por gimnasio
- Cada gimnasio activa funciones en
gyms.features. Apagada, sus rutas responden 404 y su interfaz no aparece; los datos se conservan. - Check-in con QR: el código rota cada 15 s, va firmado con HMAC y sirve una sola vez.
- Metas: las fija el coach, el socio solo las lee y el avance nunca va en verde ni en rojo, porque “bajar” es progreso para unas metas y no para otras.
- Lista de espera con asignación automática: cuando alguien cancela, el primero que todavía puede reservar recibe el cupo, un aviso en la campana y un email.
- Las tres están activas en el gimnasio cliente.
| Medida | Antes → después | Alcance |
|---|---|---|
| Textos de menos de 12 px | 2.706, Después: 0 | 176 capturas, 44 pantallas × 4 anchos |
| Campos de menos de 16 px | 96, Después: 0 | las mismas capturas |
| Objetivos táctiles de menos de 44 px, socio | 140, Después: 8 | pantallas del socio y de acceso; los 8 restantes son enlaces legales en línea |
| Objetivos táctiles de menos de 44 px, admin | 670, Después: 94 | quedan enlaces en línea, muestras de color y la tira de días del aforo |
| Scroll horizontal | 0, Después: 0 | ya no había; sigue sin haber a 360 px |
Gimnasio demo · datos sintéticos
Antes

Después

Gimnasio demo · datos sintéticos
Racha y calendario

Metas del coach

Resumen del mes

Decisiones y trade-offs
La lista de espera ensaya la reserva real
Apuntarse ejecuta el book() real dentro de una transacción que siempre se deshace, y solo acepta el fallo de “horario lleno”.
- Por qué
- Membresía, una reserva por día, feriados, restricciones por perfil y la regla de 2 horas viven en un solo sitio. Una segunda copia de esas reglas acabaría desalineada.
- Costo
- Cada alta toma los mismos bloqueos de fila que una reserva, mientras dura esa transacción que se deshace.
Feature flags por tenant
El check-in, las metas y la lista de espera salen apagados para todos los gimnasios y se activan uno por uno.
- Por qué
- Una instalación atiende a muchos gimnasios; una función nueva llega al gimnasio cliente solo cuando ese gimnasio está listo.
- Costo
- El check-in necesita además una bandera global, y sus rutas se cachean al desplegar, así que cambiar esa bandera exige un despliegue.
Migraciones que solo añaden
Los cinco cambios de esquema de la 0.2 añaden tres tablas y dos columnas nullable; ninguno renombra ni borra nada.
- Por qué
- La versión anterior sigue funcionando con el esquema nuevo, así que un rollback de código nunca necesita un rollback de la base de datos.
- Costo
- Quitar lo viejo queda para una versión posterior.
Metas de solo lectura y en color neutro
El coach fija las metas; el socio las lee. El avance no lleva verde ni rojo.
- Por qué
- Es la regla que TrainUP ya aplica a las métricas corporales: perder centímetros es progreso para un socio y un retroceso para otro.
- Costo
- El socio no puede crear ni editar sus propias metas.
El feed se calcula en el servidor
Un servicio de PHP decide qué muestra Inicio, y sus reglas están cubiertas por tests de PHPUnit.
- Por qué
- Un solo sitio para las reglas, junto a los datos y al código de reservas que reutiliza.
- Costo
- Se calcula en cada petición y no tiene caché. No he medido su costo con más de un gimnasio.
Bugs y causas raíz
| Síntoma | Causa raíz | Arreglo |
|---|---|---|
| Dos socios podían llevarse el último cupo. | lockForUpdate() corría sin DB::transaction, así que el bloqueo se soltaba al instante. | La reserva corre en una transacción que bloquea al socio y luego el horario antes de contar. |
| La regla de cancelar con 2 horas no se cumplía en clases temprano, y una clase especial del mismo día no se podía cancelar. | startOfDay() sobre un Carbon mutable llevaba “ahora” a la medianoche antes de comparar. | La regla se mide desde el inicio de la clase y no se muta ninguna fecha compartida. |
| El check-in rechazaba a los socios creados por el admin. | Exigía un rol que esas cuentas no tienen, y los tests creaban ese rol, lo que escondía el bug. | Socio es todo el que no es admin ni super-admin, como en el resto de la app; probado con un socio sin rol. |
| Se podía reservar una fecha pasada con una petición hecha a mano. | El servicio de reservas no rechazaba fechas en el pasado. | Ahora las rechaza. |
La tabla cache crecía sin límite. | Con la caché en base de datos, cada código de check-in dejaba una fila para siempre. | Una tarea cada hora borra las filas vencidas. |
| Renovar en un toque no preseleccionaba el plan (0.2.1). | El feed leía el plan de una relación precargada solo con algunas columnas, sin is_active, así que el plan siempre parecía inactivo. | El servicio carga ahora el plan completo; probado con la petición HTTP real. |
| “No se encontró una cámara” en teléfonos con cámara (0.2.2). | Ver el postmortem. | Ver el postmortem. |
Antes de publicar, una revisión de código independiente encontró 10 problemas más; los 10 se corrigieron con un test.
Cómo llegó a un cliente en producción
- Respaldos verificados en tres sitios: en el servidor, en almacenamiento de objetos privado y en una copia offline.
- Ensayo: un dump de producción restaurado en una base MySQL 8 desechable, con un usuario de base de datos sin acceso a la real. Migrar, revertir, migrar;
CHECKSUM TABLEidéntico. - Una huella CRC de cada fila del gimnasio cliente, antes y después: idéntica.
- Cambio atómico a la nueva release; el health check prueba que PHP sirve la release nueva y no una vieja en caché.
- Rollback automático si esa prueba falla. Hizo falta 0 veces en 0.2.0, 0.2.1 y 0.2.2.
A los pocos minutos, los socios reservaban en la versión nueva, y un socio nuevo se registró y pagó.
Postmortem: “No se encontró una cámara”
- Síntoma
- Al activar el check-in, el escáner decía “No se encontró una cámara” en teléfonos que sí tienen cámara.
- Causa
- El navegador fija la
Permissions-Policyal cargar la página. La página se había cargado con la cámara todavía bloqueada, e Inertia solo recarga cuando cambia la versión de los assets, no la configuración. La librería de QR reduce cualquier fallo a “no hay cámara”, lo que escondía el motivo real. - Arreglo
- La 0.2.2 mete la bandera del check-in en la versión de Inertia, así que la siguiente navegación tras un cambio recarga la página, y el escáner ahora dice el motivo real: hace falta recargar, el permiso se denegó o la cámara está ocupada.
- Verificación
- Reproducido antes y después del arreglo en Chromium.
Qué mediría después
- Si el feed mueve las renovaciones: la tasa de renovación del mismo gimnasio antes y después de la 0.2. Con un solo gimnasio y la estacionalidad, eso puede mostrar un cambio, no probar una causa.
- El uso real de la lista de espera: cuántas entradas se asignan, cuántas se omiten y por qué.
- Check-in: cuántos escaneos fallan por código vencido, para ajustar el margen de gracia.
Pregunta abierta: muchos gimnasios
El feed se calcula en cada petición. Antes de sumar gimnasios mediría su costo por petición, y luego elegiría entre guardar el feed de cada socio en caché en la base de datos, invalidándolo al reservar o hacer check-in, o construirlo en colas. Todavía no me ha hecho falta ninguna de las dos, y no sé cuál gana.
Pendientes conocidos
- Backfill de 99 membresías heredadas sin gym_id: pendiente.
- El admin todavía no ve la lista de espera de cada horario, y la lista no avanza si se borra una cuenta o se sube la capacidad de un horario.
- La 0.3.0 (gimnasios de entrada libre) está en revisión, sin desplegar.
Cómo lo construí
Toda la 0.2 es mía, construida con Claude Code a partir de mis especificaciones: escribí los requisitos, las reglas de negocio y los criterios de “hecho”, revisé cada plan y cada PR, y cada cambio en el servidor de producción necesitó mi OK explícito.
Leer el caso de estudio de la plataforma (jun–sep 2026)
Arquitectura multi-tenant
- Una sola instalación atiende a muchos gimnasios independientes.
- El tenant se resuelve a partir del slug de la URL (
/{gym}), con subdominio como alternativa. - Un trait de modelo compartido,
BelongsToGym, aplica un global scope y rellena automáticamente el id del tenant. - Tres niveles de privilegio: super-admin de plataforma, admin/coach del gimnasio y miembro.
- La lógica de negocio vive en clases de servicio y la autorización en policies.
Motor de reservas
- Capacidad por turno definida por cada gimnasio.
- Cada reserva corre en una transacción de base de datos que bloquea al socio y luego el horario (
lockForUpdate), así dos socios no pueden quedarse con el último cupo. Hasta la 0.2.0 el bloqueo corría fuera de una transacción y no hacía nada; ese bug está en el caso de la 0.2. - Cancelación con al menos 2 horas de antelación (medidas desde el inicio de la clase desde la 0.2.0), feriados del gimnasio y restricciones de turnos por perfil configuradas por cada gimnasio.
- Ocupación en vivo con código de colores. El gimnasio usó esa vista para detectar sus horas pico y subir la capacidad de 15 a 20 en esos turnos.
Pagos
- Cuatro métodos: Pago Móvil, Zelle, Binance y efectivo.
- Los pagos en línea quedan pendientes hasta que un admin los aprueba; carga de comprobantes con validación de archivos.
- Conversión USD/VES en tiempo real con la tasa oficial del BCV, y recargos por mora configurables.
- El 97 % de los ingresos de septiembre se envió dentro de la app (Pago Móvil) en lugar de en efectivo.
Métricas de progreso y consola de super-admin
- Coaches y admins registran métricas corporales; los miembros ven su historial en solo lectura con comparación mes a mes.
- La consola de super-admin gestiona el ciclo de vida de cada gimnasio (tenant), los planes de suscripción y las pruebas, la suplantación auditada del admin real de un gimnasio y un registro de actividad de la plataforma.
Operaciones
- VPS de DigitalOcean con Nginx detrás de Cloudflare, más protección antibots con Cloudflare Turnstile.
- Comprobantes de pago guardados en almacenamiento de objetos compatible con S3 (DigitalOcean Spaces).
- Backups diarios de la base de datos con rotación y copia externa. La restauración se verificó de extremo a extremo restaurando un backup real en una base de datos temporal y comparando checksums de las tablas.
- Seguimiento de errores con Sentry y alertas deduplicadas.
- Un endpoint
/healthque responde 503 cuando la base de datos cae, para que los monitores de disponibilidad detecten la degradación.
Remediación de seguridad
- Hice una auditoría de seguridad y arquitectura del código con Claude Code (subagentes y skills) que produjo 9 informes, y después corregí yo mismo cada hallazgo crítico.
- Las 4 clases críticas: una falla de autorización entre tenants (los admins de un gimnasio podían entrar al panel de admin de otro); un límite de intentos de login/registro compartido globalmente que permitía una denegación de servicio trivial (ahora por email+IP y por IP, verificado detrás de Cloudflare, incluido IPv6); la exposición de las métricas corporales de los miembros a otros miembros; y una credencial de base de datos que había quedado en el historial de git (rotada, historial limpiado).
- También añadí escaneo de secretos con gitleaks en cada PR más un escaneo semanal de todo el historial, y eliminé las contraseñas de admin por defecto.
- La suite llegó a 451 tests de PHPUnit en GitHub Actions (sep 2026); 628 en la 0.2.2.
Sistema de despliegue (trainup-deploy)
- Reemplacé un script manual por directorios de release y un cambio atómico de symlink.
- Un backup de la base de datos antes de cada despliegue.
- Una verificación de salud que confirma que PHP sirve exactamente la nueva versión.
- Rollback automático ante fallos; solo se pueden desplegar commits que ya están en
main. - Migraciones retrocompatibles (expand, luego contract).
- 26 escenarios automatizados pasan en macOS y en una réplica Ubuntu del servidor.
- Ensayado contra una copia de producción antes de la primera ejecución real.
- El primer release de producción con este sistema (el release de seguridad) salió sin tiempo de inactividad.
StackLaravel 13 · PHP 8.4 · Vue 3 (Composition API) + Inertia.js · Tailwind CSS · Reka UI · MySQL · SQLite (tests) · Vite · colas en base de datos con workers de Supervisor · email transaccional · Chart.js









