CASO DE ESTUDIO / 08
KontrolFit Web
Una cabina de administración web para centralizar la recepción y los ingresos de un gimnasio.
En esta página
01 / CONTEXTO
El problema y la solución
El punto de partida
Sustituir cuadernos y planillas por un historial de socios, pagos y asistencias que permita saber quién está al día y qué ingresos se registraron.
La propuesta
Un sistema web con gestión de membresías, validación de acceso, visitas diarias y panel de vencimientos, además de consulta pública para los socios.
02 / PRODUCTO
Funciones principales
Socios y planes
Códigos únicos y planes configurables en precio y duración; búsqueda y estados de membresía.
Pagos y períodos
Registro por socio con vista previa del período cubierto, método de pago e importe editable.
Asistencias y visitas
Acceso de socios validado contra un pago vigente; las visitas diarias permanecen separadas de las membresías.
Seguimiento y consulta
Dashboard de ingresos, filtros de vencimientos, contacto por WhatsApp y consulta pública del historial del socio.
03 / IMPLEMENTACIÓN
Decisiones técnicas
Operación web full-stack
Nuxt y Vue construyen la aplicación, con Nuxt UI para la interfaz y Drizzle ORM para gestionar los datos almacenados en Turso.
Validar antes de cobrar o ingresar
No se registra un pago sin una vista previa válida del período; tampoco una asistencia sin pago activo que cubra la fecha.
Separar visitas de socios
Las entradas diarias usan planes activos de un día y cuentan en los ingresos sin crear una membresía.
04 / CAPTURAS
El proyecto en pantalla
Una selección de vistas del proyecto. Pulsa una captura para verla a tamaño completo.
05 / DOCUMENTACIÓN
Explorar en detalle
El recorrido completo por los módulos, las reglas y las pantallas del proyecto.
Leer documentación completa
Sistema web para gimnasios pequeños y medianos que centraliza socios, planes, pagos, visitas diarias, vencimientos, asistencias e ingresos básicos desde una cabina de administración simple. Reemplaza cuadernos, planillas y registros manuales con una herramienta rápida y clara para recepción y administración. Desarrollado con Nuxt y Vue, utilizando Nuxt UI para la interfaz, Turso para almacenar los datos y Drizzle ORM para gestionarlos.
Resumen del Producto
KontrolFit permite saber rápidamente quién está al día, quién debe, qué pagos ingresaron, qué visitas se registraron y qué socios asistieron. El sistema ordena la gestión diaria evitando pérdida de información de socios, dificultades para saber quién pagó y quién debe, socios activos sin pago real asociado, vencimientos calculados manualmente con errores, visitas diarias mezcladas con socios reales, poca visibilidad de ingresos diarios o mensuales, y falta de historial confiable de pagos y asistencias.
Login Admin
Pantalla de inicio de sesión para acceder al panel de administración.
Dashboard Básico
Indicadores: socios activos, socios vencidos, socios inactivos, cobros del día (incluyendo pagos y visitas diarias), ingresos del mes (incluyendo pagos y visitas diarias), asistencias del día, nuevos socios del mes.
Gestión de Socios
El sistema permite crear, editar, listar, buscar y desactivar socios. Cada socio tiene código único generado automáticamente (formato LLLLNNNN), nombre completo, teléfono, fecha de inscripción, plan actual, fecha de vencimiento, estado operativo y observaciones. Los estados son: active (activo y con vencimiento vigente), expired (activo pero vencido o sin vencimiento vigente), e inactive (desactivado).
Registro de Pagos
El sistema permite registrar pagos asociados a un socio con datos: socio, plan, monto, método de pago, fecha de pago, período cubierto calculado por el sistema, observaciones. Métodos: efectivo, transferencia, tarjeta, otro. El plan se precarga con el plan actual del socio, el monto se precarga con el precio del plan y es editable, la fecha se precarga con hoy. El sistema muestra un preview del período que cubrirá el pago antes de guardarlo. El botón de registrar pago se bloquea si no hay preview válido.
Visitas Diarias
Las visitas de un día se gestionan separadas de socios. Datos: nombre del visitante, plan de visita diaria, fecha de visita (por defecto hoy), costo tomado automáticamente desde el precio del plan, observaciones opcionales. Reglas: no se crea socio, solo se aceptan planes activos con duration_days = 1, el dashboard suma visitas diarias en ingresos del día y del mes.
Registro de Asistencia
El sistema registra entrada de socios con fecha y hora automática. Se puede registrar por código o socio. El socio debe existir, no debe estar inactivo, debe tener suscripción vigente, y debe existir un pago activo que cubra la fecha actual. Si no hay pago activo, la asistencia se bloquea y se solicita registrar pago. Datos guardados: socio, fecha y hora, estado de membresía al momento del ingreso.
Gestión de Planes
El sistema permite crear, editar y desactivar planes con nombre, precio, duración en días, descripción opcional y estado activo/inactivo. Ejemplos: visita diaria, musculación mensual, funcional 3 veces por semana, plan anual.
Control de Vencimientos
La vista de vencimientos muestra socios vencidos, al día o próximos a vencer. Incluye: socio, código, plan, fecha de vencimiento, días restantes o días vencidos, estado, acción de contacto por WhatsApp. Filtros: operativos, vencidos, vencen hoy, próximos 7 días, al día, por plan.
Configuración (Backup)
Panel de configuración para realizar copias de seguridad de la base de datos del sistema.
Consulta Pública de Socios
Vista pública donde los socios pueden consultar su información personal, estado de membresía, vencimiento y historial de pagos.
