Works
sistema-gym "Gestión integral del gimnasio"
01 El problema
Una administración con demasiado control a mano.
Antes de que existiera el sistema, el gimnasio se administraba con hojas de Excel, cuadernos y registros a mano. A medida que llegaban más socios, llevar el control individual de las membresías se volvía cada vez más complicado.
El problema se notaba en los horarios pico cuando llegaban diez personas juntas, el dueño tenía que identificar a cada socio, buscar sus datos y fijarse si tenía la cuota al día. Eso generaba demoras y a veces algún ingreso terminaba sin quedar registrado.
No había una herramienta simple que juntara toda esa información y permitiera resolver esas tareas rápido y de forma consistente.
02 Origen del proyecto
De un proyecto académico a una necesidad de verdad.
sistema-gym arrancó como un proyecto personal académico. Pero al conocer de cerca las necesidades operativas de un gimnasio de verdad, decidí adaptar el desarrollo y agrandarlo para que resolviera problemas concretos de administración.
La idea dejó de ser simplemente armar una app de gestión: pasó a ser una herramienta que se pudiera usar todos los días para organizar la información de los socios y simplificarles el trabajo a los propietarios.
03 Visión del producto
Menos tareas manuales, todo en un solo lugar.
La propuesta era llevar las operaciones principales del gimnasio a una única plataforma desde el registro de socios nuevos hasta el seguimiento de membresías, pagos y movimientos de caja.
Buscaba cortar la dependencia de los registros manuales, hacer que consultar la información sea fácil y automatizar esas tareas administrativas que se repetían cada diez minutos durante el día.
04 Solución y desarrollo
Una plataforma para administrar el día a día.
Desarrollé solo un sistema web pensado para el uso interno del personal administrativo, principalmente los dueños del gimnasio.
La plataforma trae módulos para registrar socios, administrar planes, gestionar renovaciones y adelantos de cuotas, registrar pagos y controlar los movimientos de caja.
Además armé un panel de registro de ingresos para ver quién entró al gimnasio, a qué hora y cómo estaba con su membresía.
Una parte importante del desarrollo fue automatizar las reglas del negocio: actualizar vencimientos, registrar pagos parciales, mantener deudas pendientes y descontar las clases disponibles según el plan de cada socio.
05 Arquitectura de datos
Una base de datos pensada como el negocio.
Diseñé el modelo de datos y sus relaciones para representar cada entidad que interviene en la gestión del gimnasio.
La base contempla socios, planes, métodos de pago, movimientos de caja, registros de ingreso y estados de membresía, con claves foráneas para mantener la integridad de la información.
También dejé una estructura multi-tenant inicial: identificadores de administrador para separar los datos de cada gimnasio y límites de miembros según el plan contratado.
Y como parte de la documentación, armé el diagrama entidad-relación para mostrar la estructura y que se entienda fácil.
06 Decisiones técnicas
PHP nativo y una arquitectura ordenada por componentes.
El sistema está hecho con PHP 8.2, MySQL/MariaDB y JavaScript, sin frameworks de backend.
Organicé el código por capas: páginas PHP para las vistas, endpoints independientes en componentes/ para procesar operaciones y requests AJAX, y archivos JavaScript separados para las interacciones de cada módulo.
Para la base uso MySQLi con consultas preparadas, y Bootstrap para una interfaz administrativa directa y funcional.
07 Automatización y control de acceso
Del ingreso a mano a identificarte con un código.
Uno de los desafíos más divertidos era reducir el tiempo que llevaba identificar a los socios.
Implementé la lectura automática del DNI argentino con un lector de códigos de barras compatible con PDF417. El dispositivo funciona como un teclado manda el contenido del documento y corta la lectura con Enter.
Desarrollé un mecanismo que interpreta esa info, reconoce los campos y completa solo el formulario de registro: nombre, apellido, sexo y DNI.
Encima sumé un código único por socio, que lo identifica al entrar o al escanear su código o número de tarjeta.
Al identificarlo, el sistema consulta su información y valida todo automáticamente: vencimiento de la membresía, pagos pendientes y clases disponibles. Según el resultado muestra si el acceso está habilitado o restringido, registra el ingreso y descuenta una clase cuando corresponde.
Esa lógica le trasladó al sistema buena parte del control que antes hacía el propietario a mano.
08 Desarrollo futuro
Rumbo al control de acceso automatizado.
Hoy sistema-gym sigue en desarrollo. Una de las líneas más grandes es integrarlo con hardware de control de acceso, en particular molinetes y lectores RFID.
La lógica de validación y registro de ingresos ya existe en la app; lo que falta es la comunicación física con el molinete.
Ese avance me empujó a investigar protocolos de comunicación, controladores, proveedores internacionales y hasta los procesos de importación de hardware desde China.
La meta es llegar a una solución integral donde el sistema no solo administre las membresías, sino que valide y gestione el ingreso de los socios por su cuenta.
Stack tecnológico
Portada
Pantallas del sistema
Base de datos
Muchas Gracias por llegar hasta el final :D