Tu gimnasio,
con acceso inteligente.

1. Descarga el instalador PowerGymAccess-2.0.0-win64.zip desde la sección Descargar.
2. Descomprime el .zip en una carpeta fija (por ejemplo C:\PowerGymAccess).
3. Ejecuta PowerGymAccess.exe. No requiere Python ni instalar nada más.
4. Se abre automáticamente el navegador en http://localhost:8005 y aparece el asistente para crear la única cuenta de administrador.
5. Desde /admin → Cuentas Staff crea las cuentas de recepción/gerencia, y desde Configuración conecta el terminal Hikvision.

💡 Los secretos (clave JWT, cifrado, VAPID) se generan solos en el primer arranque y se guardan en un .env que el propio sistema crea. No hay que copiar plantillas ni ejecutar scripts.

1. Descubrir IP y puerto

Usa SADP Tool (gratis, de Hikvision) para escanear la red y obtener la IP y el puerto HTTP del equipo (por defecto 80).

2. Puerto ISAPI

Si el 80 está ocupado: en la web del equipo, Configuration → Network → Basic Settings → Port.

3. Listener de eventos

El equipo debe saber a dónde enviar cada marcaje: Configuration → Network → Advanced Settings → HTTP Listening / Event Notification → la IP local de esta PC y el puerto 8080 (por defecto).

4. Enrolamiento de huellas

Dos escenarios soportados:

• Cédula = ID del equipo (recomendado): usa la cédula (solo dígitos) como employeeNo. El sistema hace match automático desde el primer marcaje.
• ID autogenerado: el primer marcaje sin match queda en Huellas pendientes para vinculación manual desde el portal Staff.

Windows

Usa NSSM (Non-Sucking Service Manager) o el Programador de Tareas con disparador “Al iniciar el sistema”, ejecutando PowerGymAccess.exe con el directorio de inicio de la carpeta descomprimida.

Linux (systemd)

Para instalación desde código fuente, crea /etc/systemd/system/power-gym-access.service con ExecStart=/ruta/venv/bin/python main.py y actívalo con sudo systemctl enable --now power-gym-access.

Tu sistema corre en tu PC (localhost:8005). Para que staff, admin y clientes accedan desde internet, usas Cloudflare Tunnel (gratis) con tu URL fija: tu-gym.powergym.dev.

Cómo funciona: tu proveedor configura esa URL única para ti y te entrega las credenciales del túnel (un archivo .json y un config.yml). Tú solo ejecutas cloudflared con esa configuración:

# config.yml (te lo entrega tu proveedor)
tunnel: TUNNEL_ID
credentials-file: C:\cloudflared\TUNNEL_ID.json
ingress:
  - hostname: tu-gym.powergym.dev
    service: http://localhost:8005
  - service: http_status:404

cloudflared tunnel run tu-gym

Instálalo como servicio para que se reconecte solo tras reinicios. La URL es fija y única por gimnasio: no cambia nunca.

python scripts/backup_db.py

Programa este script a diario (cron o Tarea Programada). Copia data/power_gym_access.db a data/backups/ con timestamp y rota automáticamente (14 días).

• El .env nunca debe subirse a un repositorio (contiene secretos JWT, cifrado y VAPID).
• Toda acción sensible queda firmada con HMAC en audit_log, verificable desde Auditoría.
• Fotos y comprobantes se comprimen en el navegador (máx. 500 KB) y se revalidan en el backend.
• Credenciales (Hikvision, SMTP) cifradas en reposo con Fernet.
• Contraseñas: mínimo 8 caracteres (clientes) y 10 (admin/staff), con letra y número.
• Bloqueo por fuerza bruta: 5 intentos fallidos → bloqueo temporal creciente.