Manual de usuario — Nuestro Gym

Guía orientada a socios, equipos de gimnasio y administradores. Los enlaces de ejemplo usan la URL base de tu instalación (por ejemplo https://tu-dominio.com).


1. Qué es Nuestro Gym y quién usa qué

RolPara qué sirveTras iniciar sesión
Socio / miembroVer plan, clases, rutinas, progreso corporal, pagosRedirección a /portal
Administrador o staff del gimnasioMiembros, planes, acceso, tienda, contabilidad, etc.Redirección a /g/{id}/dashboard (u otra pantalla según el rol; ver sección 6)
Super admin (plataforma)Alta de gimnasios, catálogos globales, soporte/super-admin

Si al entrar ves “Firebase requerido”, el sitio no tiene bien configuradas las claves públicas de Firebase: es un tema técnico del gimnasio o del proveedor, no del usuario final.


2. Dónde está el manual en la app

El contenido es el mismo (docs/MANUAL-USUARIO.md); cambia desde dónde lo abrís:

SituaciónRuta
Sin sesión (p. ej. desde la pantalla de login)/manual
Dentro del panel del gimnasio (staff)/g/{gymId}/manual — también hay enlace en el menú lateral
Super admin/super-admin/manual

En el manual, un botón flotante puede llevar a soporte técnico (/g/{gymId}/support o /super-admin/support) si tu rol puede gestionar tickets.


3. Registro y acceso del socio (miembro)

Hay dos caminos principales. No se mezclan con la invitación para dueño de gimnasio (ver sección 8).

3.1 Activación por correo (recomendado)

  1. El gimnasio da de alta al socio y puede enviar un correo de invitación.
  2. El correo incluye un enlace del tipo:
    /member/activate/{gymId}/{inviteId}
  3. En esa pantalla el socio solo define contraseña (mínimo 6 caracteres, dos veces iguales). El email ya está asociado a la invitación.
  4. Al terminar, en muchos casos entra directo al portal; si algo falla en el navegador, puede quedar en inicio de sesión con el correo ya cargado.

Importante: Cada envío genera una invitación nueva. El socio debe usar el enlace del último correo válido que recibió.

3.2 Registro abierto con enlace del gimnasio

Si el gimnasio comparte un enlace con el ID del gimnasio en la URL:

  • Ruta: /portal/registro?gym=ID_DEL_GIMNASIO
  • El socio completa nombre, email y contraseña y queda registrado en Firebase; luego suele ir a inicio de sesión para entrar.

Sin ?gym=... la página indica que falta el parámetro: hace falta el enlace completo que armó el gimnasio.

3.3 Inicio de sesión habitual

  • Ruta: /login
  • Mismo correo y contraseña definidos en la activación o en el registro abierto.

4. Portal del socio (/portal)

Desde el portal el socio puede, según lo que el gimnasio tenga activo:

  • Ver estado de membresía (activa, prueba, pago pendiente, vencida, cancelada).
  • Planes, clases y rutinas según su sede y reglas del gimnasio.
  • Progreso / medidas y objetivos; compartir tarjeta de progreso; según configuración, contacto con especialista (salud) en el mismo flujo del portal.
  • Pagos y renovación: si el plan usa la pasarela integrada, el portal puede ofrecer alta o cambio de medio de pago (p. ej. tarjeta, cuenta bancaria o billeteras según región y lo que haya habilitado el gimnasio). Sigue las instrucciones en pantalla y los términos que pida el checkout.
  • Sugerencias al club: /portal/sugerencias (mensaje al gimnasio; puede elegirse alcance general o a un entrenador, y opción de anonimato).
  • Términos de membresía: /portal/terminos-membresia.

Si el estado no es activo, recepción puede explicar pagos pendientes o actualizar el plan en el sistema.


5. Preguntas frecuentes — socio / registro y cuenta

¿Por qué me dice “Invitación no válida” o no carga el nombre del gimnasio?

  • El enlace está incompleto o fue copiado mal.
  • La invitación ya se usó o venció (el gimnasio debe reenviar invitación desde Miembros).
  • Problema puntual de red: probá de nuevo o pedí un nuevo correo de invitación.

“Invitación vencida”

El enlace tiene fecha límite. Pedí al gimnasio que genere una nueva invitación (reenvío de correo).

“Esta cuenta ya fue activada. Iniciá sesión.”

Ese socio ya tiene usuario vinculado al miembro. No hace falta repetir la activación: entrá en /login. Si olvidaste la contraseña, usá la recuperación de contraseña de Firebase (desde la pantalla de login, si está habilitada en el proyecto).

“Este email ya tiene cuenta…”

Ese correo ya existe en el sistema de autenticación. Usá inicio de sesión; si era otro flujo (invitación duplicada), consultá con recepción.

Registro abierto: “No se pudo registrar. Email en uso…”

Ese email ya está registrado. Probá login; si no debería existir, lo revisa el staff del gimnasio.

Contraseña en activación

  • Mínimo 6 caracteres.
  • Los dos campos deben ser iguales.
  • Si el sistema no deja avanzar, revisá que no haya espacios de más al pegar.

¿Por qué después de activar me manda al login y no al portal?

A veces la sesión en el navegador no se abre en el mismo instante; iniciá sesión con el mismo email y contraseña que acabás de crear.

¿El enlace /join/... es para socios?

No. Ese flujo es para invitación de equipo / dueño de gimnasio creada desde la operación central (super admin). Los socios usan /member/activate/... o /portal/registro?gym=....


6. Panel del gimnasio (staff): módulos y roles

Tras el login, el personal del gimnasio entra a /g/{gymId}/.... El menú lateral lista los módulos habilitados para tu rol (y el plan; por ejemplo Especialista solo aparece si el plan de plataforma lo incluye).

6.1 Módulos habituales (resumen)

Módulo en menúRuta (patrón)Para qué sirve (a grandes rasgos)
Dashboard/g/{gymId}/dashboardResumen: accesos, membresías, ventas recientes según permisos
Miembros/g/{gymId}/membersAltas, planes, invitaciones, ficha del socio
Notificaciones/g/{gymId}/notificationsAvisos de facturación y operación (visibilidad: admin, gerente, recepción, super admin)
Medidas/g/{gymId}/measurementsRegistro y seguimiento de medidas corporales
Acceso/g/{gymId}/accessIngreso por búsqueda, huella, tarjeta o manual; con varias sedes, la recepción puede dejar fijada la sede al iniciar sesión
Tienda / Inventario / Balance.../store, .../inventory, .../balanceVentas, stock y movimientos de caja
Reportes/g/{gymId}/reportsExportaciones y reportes (asistencias, ventas, egresos, etc.)
Asignación/g/{gymId}/recepcion-pasarelaVincular ingresos de pasarela (pagos en línea) con el miembro o la recepción que corresponda
Buzón/g/{gymId}/suggestionsSugerencias de socios; solo admin del gimnasio o super admin (indicador de no leídos en el menú)
Clases / Rutinas.../classes, .../routinesCalendario de clases y programación de rutinas
Especialista/g/{gymId}/especialistaFlujo de salud para nutricionista / kinesiólogo (según plan)
Configuración/g/{gymId}/settingsSede, planes, correo, apariencia, Mi plan (Nuestro Gym) (suscripción a la plataforma), etc.
  • Vendedor (seller): suele ver Dashboard, Tienda e Inventario (sin acceso a Miembros ni al resto).
  • Entrenador (trainer): la app limita a Medidas, Clases y Rutinas (no ve Miembros ni Dashboard “completo” de operación).
  • Nutricionista / kinesiólogo: solo el módulo Especialista.

Si la suscripción a la plataforma del gimnasio está vencida o cancelada (sin excepción de catálogo), el sistema puede forzar a abrir Configuración → Mi plan (Nuestro Gym) para regularizar; el manual del panel sigue accesible en esa situación.

6.2 Modo sin conexión

Si se pierde internet, el panel puede mostrar un aviso de modo local: algunas acciones quedan en cola hasta volver a tener red.

6.3 Conciliación (avanzado)

Quien tenga permisos de admin / gerente / super admin puede usar la pantalla de conciliación y cierres (pagos de pasarela) en
/g/{gymId}/reconciliation. No todos los menús la enlazan; el equipo puede guardar el enlace o buscarlo en la documentación interna.


7. Preguntas frecuentes — operación (staff)

Cómo doy de alta a un socio y que active su cuenta

  1. Miembros en el panel: /g/{gymId}/members
  2. Completá datos, plan, sede si aplica, y marcá enviar invitación por correo si querés que el socio active solo.
  3. Si el correo no llega: spam, cuota del proveedor de email, o email mal escrito — revisá y reenviá invitación.

Reenviar invitación

Desde la lista o ficha de miembro, usá la acción de reenviar correo de invitación. El socio debe abrir el último enlace enviado.

El socio figura pero “no puede entrar”

  • ¿Tiene authUid / cuenta activada? Si nunca abrió el enlace de /member/activate/..., no tendrá contraseña en la app hasta activar.
  • Si el email estaba mal, corregilo en Miembros y volvé a invitar.

Acceso / ingreso (/g/{gymId}/access)

  • Registrá ingreso por búsqueda, huella o tarjeta según configuréis; también API o torniquete si aplica.
  • Si la membresía no está activa, el sistema puede avisar de prueba, pago vencido, cuota rechazada o cancelado. Recepción decide política de ingreso; el mensaje en pantalla orienta sobre el estado en el sistema.

Sedes y planes

  • Si el gimnasio tiene varias sedes, al crear o editar miembro puede ser obligatorio elegir sede y si tiene acceso a todas las sedes.
  • Los planes determinan precio y periodicidad; cambios en plan o estado impactan en lo que ve el socio en el portal y en validaciones de acceso.

8. Dueño o equipo del gimnasio (no socio)

Alta “self-service” de un gimnasio nuevo

  • Ruta típica: /register-gym
  • Crea el gimnasio y la cuenta del responsable; luego entrás al panel del gimnasio.
  • Términos del administrador (registro): /terminos-registro-gimnasio

Invitación con /join/{inviteId}

  • La usa quien recibió el enlace para aceptar invitación y crear contraseña como admin del gimnasio (u otro rol que venga en la invitación).
  • Pantalla “Unirme al equipo”: nombre visible, contraseña (mín. 6 caracteres).

9. Membresía, pagos y portal

  • Estados habituales: prueba / pago pendiente, activa, vencida o con deuda, cancelada.
  • Si el socio tiene pago automático rechazado, puede ver reflejo en portal y en Acceso al intentar ingresar.
  • Pasarela (OnePay u otras) y el modelo de suscripción al software se configuran en ajustes del gimnasio y en el servidor. Para el socio, la guía práctica es: seguir el flujo en el portal o regularizar en recepción según indique el gimnasio.

10. Super admin (plataforma)

Quien opera /super-admin dispone, entre otras, de: resumen, gimnasios, planes de plataforma, comisiones y ganancias de pasarela, planes de miembros globales, SaaS OnePay, suscripción V2 (portal), mapa corporal y catálogo de ejercicios, tickets de soporte, documentación, contrato SaaS, manual de usuario y textos de términos de membresía. Herramientas puntuales (p. ej. generar propuesta comercial) pueden estar en rutas adicionales según el despliegue.


11. Resumen rápido de rutas

NecesidadRuta
Manual (sin sesión)/manual
Manual (panel del gimnasio)/g/{gymId}/manual
Manual (super admin)/super-admin/manual
Login/login
Portal del socio/portal
Sugerencias (socio)/portal/sugerencias
Registro socio (con ID gimnasio)/portal/registro?gym=...
Activar cuenta (email invitación)/member/activate/{gymId}/{inviteId}
Unirme al equipo (dueño/staff)/join/{inviteId}
Registrar gimnasio nuevo/register-gym
Términos al registrar gimnasio (admin)/terminos-registro-gimnasio
Términos de membresía (socio)/portal/terminos-membresia
Soporte (staff con permiso)/g/{gymId}/support
Soporte (super admin)/super-admin/support
Conciliación pasarela (admin/gerente)/g/{gymId}/reconciliation

12. Soporte

  • Socios: lo primero es contactar al gimnasio (recepción o email del club) con captura de pantalla y, si aplica, el último enlace que recibieron (sin compartir la contraseña).
  • Gimnasios: revisá invitaciones vencidas, email del miembro, reenvío de correo y estado activo del plan; problemas técnicos de dominio, Firebase o correo transaccional son para quien administra la instalación. El buzón de sugerencias y los tickets de soporte (si tu rol corresponde) complementan el canal con la plataforma.

Documento alineado al comportamiento actual de la aplicación Nuestro Gym. Si el producto cambia, actualizá esta guía en el mismo repositorio (docs/MANUAL-USUARIO.md).