Manual por perfil · Super administrador
Manual del super administrador
Gestionas la plataforma completa: creas gimnasios y sus administradores, supervisas varios gimnasios a la vez y cuidas que todo funcione.
Lo esencial
- Ves los mismos módulos que un administrador, pero de todos los gimnasios.
- Eres quien crea gimnasios y administradores de gimnasio (módulo Gimnasios).
- Para operar (cobrar, registrar pagos, configurar), elige un gimnasio concreto en el selector del Panel.
- Todo lo del día a día está en el manual del administrador.
Cómo trabajas con varios gimnasios#
Cada gimnasio es un espacio separado: sus clientes, membresías, pagos, clases y reportes no se mezclan con los de otro. En el Panel, el selector Gimnasio activo decide qué espacio estás viendo:
- Todos los gimnasios: vista general, ideal para revisar el panorama o buscar algo sin saber en qué gimnasio está.
- Un gimnasio concreto: necesario para registrar pagos, cobrar, configurar datos de cobro y todo lo que escribe información.
Si vas a cobrar o a registrar un pago, comprueba que el gimnasio activo sea el correcto. Si ves “Selecciona un gimnasio” o “Debe seleccionar un gimnasio”, elígelo en el Panel y repite.
Crear un administrador de gimnasio#
El administrador es quien dirige un gimnasio. Se crea desde Gimnasios → Nuevo administrador de gimnasio:
- Escribe nombre, apellido, correo, DNI y teléfono.
- Define una contraseña inicial (mínimo 6 caracteres).
- Guarda. Verás el aviso “Administrador creado”.
- Entrégale su correo y contraseña de forma privada y recomiéndale leer el manual del administrador.
Crear un gimnasio#
En Gimnasios, pulsa Nuevo gimnasio:
| Campo | Cómo llenarlo |
|---|---|
| Nombre | El nombre comercial del gimnasio. |
| RUC | Obligatorio y único: no puede repetirse entre gimnasios. |
| Dirección principal y teléfono | Datos de contacto del local principal. |
| Precio base mensual (S/) | El precio de referencia de la membresía mensual. |
| Administrador del gimnasio | Elige a quién dirigirá este gimnasio. Puedes elegirte a ti (Yo (super admin)) mientras no tengas otro. |
Guarda y verás “Gimnasio creado”. En la lista de gimnasios aparece con su precio base y un botón Personal para asignar a su equipo.
Entregar un gimnasio listo para operar#
Un gimnasio nuevo está vacío. Esta lista te asegura que el administrador pueda empezar el mismo día:
- Crea el gimnasio y su administrador (secciones anteriores).
- Selecciónalo como gimnasio activo y verifica que aparece en el selector.
- Entra a Cobranza → Datos de cobro y configura el Yape/Plin del gimnasio (o pídele al administrador que lo haga).
- Asigna el personal (entrenadores, nutricionistas) desde Gimnasios → Personal.
- Comparte con el administrador el paso a paso de configuración inicial.
Apoyar a los usuarios#
- Restablecer una contraseña: los administradores te lo piden a ti o al equipo técnico. Hoy no hay una pantalla para hacerlo; el procedimiento está en Operación técnica.
- Un cliente no ve su gimnasio: su cuenta no está asignada como cliente de ningún gimnasio. Pídele al administrador que complete su alta.
- Datos que no coinciden: confirma primero qué gimnasio está activo; la mayoría de “no veo mis datos” son de un gimnasio equivocado.
Operación técnica de la plataforma#
Esta sección es para quien administra el hosting. El resto del equipo puede omitirla.
Cómo está armado#
- Sitio: páginas estáticas en la raíz de
public_html. - API: aplicación Laravel en
public_html/backend, atendida bajo la ruta/api. - Base de datos: MySQL.
Tareas programadas (obligatorio)#
Los recordatorios, el marcado de membresías vencidas y las renovaciones dependen de una única tarea cron que debe ejecutarse cada minuto. En Hostinger: Avanzado → Tareas programadas (Cron), tipo PHP, con el comando:
public_html/backend/artisan schedule:run
y todos los campos de frecuencia en cada minuto (*). Requiere PHP 8.2 o superior. Con Ver resultado puedes confirmar que corre; el mensaje No scheduled commands are ready to run es normal cuando en ese minuto no toca ninguna tarea.
Actualizar la plataforma#
- Haz un respaldo de la base de datos (phpMyAdmin → Exportar).
- Si la actualización incluye cambios de base de datos, aplica el script SQL correspondiente antes de subir el código.
- Sube el contenido de la carpeta
public_html(no sobrescribas el archivo.envdel servidor). - Comprueba que lo publicado es lo último: cada compilación del sitio tiene un identificador único (Build ID) visible en
_next/static/.
Restablecer una contraseña#
Mientras no exista una pantalla para ello, se hace desde la consola del servidor (SSH), en la carpeta public_html/backend:
php artisan tinker
y, dentro de tinker, con el correo de la persona y una contraseña temporal:
$u = App\Models\Usuario::where('email', 'correo@ejemplo.com')->first(); $u->password = 'ClaveTemporal123'; $u->save();
Comparte la clave temporal de forma privada y pide a la persona que la cambie en cuanto pueda.
Integraciones opcionales#
- WhatsApp (envío automático): se activa configurando en el
.envel proveedor y su credencial (WHATSAPP_ENABLED,WHATSAPP_PROVIDER,WHATSAPP_ENDPOINT,WHATSAPP_TOKEN). Sin esto, los administradores usan el botón WhatsApp de la bandeja de Cobranza, que no requiere nada. - Culqi (pago con tarjeta): requiere las llaves de Culqi en el
.envdel backend (CULQI_ENABLED,CULQI_PUBLIC_KEY,CULQI_SECRET_KEY) y la llave pública en la compilación del sitio. Sin ellas, el botón de tarjeta no aparece.
Contiene las claves de la base de datos y de las integraciones. No lo compartas, no lo subas a repositorios ni lo envíes por chat o correo.