Proyectos
EscritorioEn producciónHecho con IA

GymApp — Administración de gimnasio

Sistema de escritorio en producción para la gestión integral de un gimnasio: membresías, control de acceso biométrico con apertura automática de puerta, punto de venta, inventario y caja.

300+
clientes registrados
3
formas de entrar: huella, carnet o PIN
31
suites de pruebas automáticas
GymApp — Administración de gimnasio

Sistema de escritorio para la administración integral de un gimnasio en operación: clientes, membresías, control de acceso, punto de venta, inventario y caja. En producción desde septiembre de 2026 en el equipo de recepción, con más de 300 clientes registrados.

Opera sin conexión a internet: la información reside en una base de datos SQLite local y los datos sensibles de los clientes se almacenan cifrados.

El problema

El gimnasio gestionaba pagos, vencimientos, cuentas por cobrar y ventas en hojas de Excel. No existía control de acceso y el cierre de caja se realizaba manualmente.

Qué hace

  • Clientes y membresías: ficha con foto, planes por días o por tiquetes, renovaciones, pausas y pagos a crédito (fiados).
  • Control de acceso: kiosco a pantalla completa donde el cliente entra con huella, código de barras del carnet o PIN. Cada entrada queda registrada con su motivo.
  • Kiosco en la segunda pantalla: con dos monitores, el kiosco se abre a pantalla completa en el de los clientes (un botón o F2) mientras recepción sigue vendiendo en el otro. Los dos comparten el mismo lector de huella: cada huella cuenta una sola entrada y se muestra en ambos. Con tres o más monitores se elige en cuál sale (con un botón que numera cada pantalla), y si se conecta o desconecta alguno el kiosco se recoloca solo, sin tapar nunca la pantalla de recepción. Mientras está abierto, el teclado numérico es del kiosco: quien no marca con la huella escribe su documento y su PIN sin tocar el mouse, aunque recepción esté trabajando en otra ventana.
  • Puerta automática: cuando el acceso es válido, un Arduino Nano con un relé le da la orden al controlador del electroimán y la puerta se suelta unos segundos. Ya está probada de punta a punta; falta montarla en la entrada.
  • Punto de venta, inventario y caja: productos con código de barras, entradas y salidas de mercancía, apertura y cierre por turno. Cada cobro entra a la caja con su medio (efectivo, QR, Llave, Nequi, tarjeta) y al cerrar se ve cuánto entró por cada uno; el arqueo cuenta solo el efectivo.
  • Recordatorios por correo: aviso automático a quien está por vencer o ya venció, con frenos para no escribirle dos veces a nadie.
  • Excel y respaldos: importación masiva de clientes, exportación del padrón y copias de seguridad con restauración verificada.

Cómo está hecha

01Interfaz · React

Kiosco de entrada Pantalla completa: huella, carnet o PIN
Mostrador Clientes, ventas, inventario y caja

02Núcleo · Electron

Reglas del negocio Acceso, membresías, fiados y caja por turno
Seguridad Datos, fotos y huellas cifrados; Argon2
Tareas Recordatorios por correo, respaldos y Excel

03Datos y hardware

SQLite better-sqlite3 con migraciones, sin internet
Lector de huella DigitalPersona a través de un proceso .NET
Puerta Arduino Nano + relé por puerto serie, hacia el controlador del electroimán
  • Electron + React para la interfaz y SQLite (better-sqlite3) con migraciones.
  • Cifrado de datos sensibles, fotos y huellas; contraseñas con Argon2.
  • Un proceso aparte en .NET habla con el lector de huella DigitalPersona.
  • Autodiagnóstico del lector: si detecta el dedo pero deja de entregar la huella, el kiosco lo avisa y pide entrar con PIN, en vez de fallar en silencio.
  • Acceso de mantenimiento con huella: el panel técnico se abre con la huella del desarrollador, guardada cifrada y aparte de la de los clientes para que nunca abra la puerta; la frase secreta queda como respaldo.
  • Firmware propio para Arduino Nano por puerto serie.
  • 31 suites de pruebas automáticas que corren sobre Electron.

Resultado

  • En producción desde septiembre de 2026 en el PC del mostrador, con más de 300 clientes registrados.
  • Lo que antes estaba repartido en hojas de Excel (pagos, vencimientos, deudas y ventas) quedó en un solo sistema.
  • La entrada quedó controlada: cada ingreso queda registrado con su motivo, y la puerta, una vez montada, solo se abrirá con un acceso válido.
  • El cierre de caja por turno se arma solo, separado por medio de pago.

Capturas

Todas con datos de ejemplo, ningún cliente real.

Kiosco de entrada
Kiosco de entrada
Clientes, estados y quién debe
Clientes, estados y quién debe
Ficha del cliente
Ficha del cliente
Fiar una membresía
Fiar una membresía
Punto de venta
Punto de venta
Caja por turno
Caja por turno
Inventario
Inventario
Resumen del día
Resumen del día
Puerta con Arduino
Puerta con Arduino
Recordatorios por correo
Recordatorios por correo
Panel de desarrollador
Panel de desarrollador

Otros proyectos