Manual de uso de GGym Planner
GGym Planner es la plataforma con la que un gimnasio organiza sus clases: los alumnos reservan su lugar, los profesores ven a quién les toca entrenar y los administradores manejan horarios, planes y comunidad. Este manual explica cómo se usa, pantalla por pantalla.
Cada documento vive en public/docs/<ruta>.md y se lee en la aplicación en /docs/<ruta> (sin la extensión). Los enlaces de abajo usan la ruta relativa del archivo; para armar la URL de la app, antepón /docs/ y quita .md.
Si buscas el significado de una palabra que aparece en la aplicación, está en el glosario (/docs/glosario).
Cada documento, además de explicar cómo llegar por los menús, trae en "Cómo llegar" el enlace directo a la pantalla que describe. Si no iniciaste sesión, la plataforma te pide entrar antes de dejarte ahí; y las pantallas de administración solo se abren si eres administrador de tu gimnasio.
Enlaces directos a cada pantalla
Las direcciones con <número de la persona> dependen de cada alumno: el número aparece en la barra del navegador al abrir su ficha, y desde ahí se copia el enlace completo.
El resto de las pantallas que se abren encima de otra —el panel de alumnos de una clase, los tipos de clase, el chat con GiGi y el tutorial guiado— no tienen enlace propio: se llega a la pantalla que las contiene y se toca el botón que las abre. Cada documento lo aclara en su "Cómo llegar".
Todos los documentos
Referencia rápida para ubicar, a partir de una pregunta, qué documento (y qué URL) corresponde. Cuando dos documentos podrían confundirse, se aclara la diferencia.
Para cualquier persona
/docs/general/ingresar-y-salir Elegir el gimnasio de una lista, iniciar sesión (usuario, no correo), ver la contraseña, cerrar sesión, "Crear mi cuenta" cuando el registro está abierto, gimnasios con dominio propio, contraseña olvidada.
/docs/general/moverse-por-la-app Ubicar botones y menús: la barra superior en computadora, el menú de tres líneas y la barra inferior en el celular, el menú de tu cuenta, el menú "Administrar" y qué ve cada rol. Es el mapa de la interfaz, no explica qué hace cada función.
/docs/general/avisos-y-notificaciones Qué significa el aviso de vencimiento del plan arriba de la pantalla, la ventana de novedades (anuncios y menciones), el punto rojo de publicaciones sin leer y el globito de cumpleaños. No explica cómo renovar el plan (eso está en Asignar el plan de un alumno para el administrador).
Definición corta de cada término que usa la app (cupo, bloque, plan, sobrecupo, inscripción fija, etc.), con enlace al documento que lo desarrolla. Útil cuando la pregunta usa una palabra puntual y no se sabe a qué función corresponde.
Ayuda
/docs/funcionalidades/gigi-asistente El chat de ayuda (solo administradores y profesores): cómo abrirlo, preguntas sugeridas, contexto de la pantalla, adjuntar a una persona con "@", historial de conversaciones, límites de uso.
/docs/funcionalidades/admin-tutorial-guiado Recorrido interactivo solo para administradores que resalta la pantalla real y hace crear datos de verdad (un tipo de clase, cupos, un plan, etc.). Cómo abrirlo, correrlo completo o por capítulos, minimizar el cuadro, saltar un paso.
/docs/funcionalidades/tutorial-guiado-alumno Recorrido interactivo de ~7 min para alumnos, con tres capítulos (tomar una clase, completar el perfil, usar el muro). Cómo abrirlo desde el botón flotante de GiGi, correrlo completo o por capítulos, y qué pasa con la clase o la publicación que deja creadas.
Alumnos
/docs/funcionalidades/registro-de-alumno Registrarse por primera vez: registro abierto del gimnasio o enlace de invitación, el formulario de 6 pasos (datos, salud, actividad, nutrición, emergencia, cuenta), RUT duplicado o inválido, enlace vencido o ya usado.
/docs/funcionalidades/primer-ingreso Qué pasa la primera vez que entras con una cuenta que ya te creó el gimnasio (sin registro propio): completar tu perfil, definir contraseña, aceptar las reglas.
/docs/funcionalidades/tomar-clases Reservar y cancelar tu propia clase, ver tu semana, qué significa cada estado de un bloque (lleno, deshabilitado, finalizado). Es la guía principal del alumno. Si un administrador necesita agregar o quitar a otro alumno de una clase, eso está en Gestionar los alumnos de una clase, no aquí.
/docs/funcionalidades/lista-de-espera Anotarse cuando un bloque está lleno, tu posición, cómo entras automáticamente si se libera un cupo, salir de la lista.
/docs/funcionalidades/inscripcion-fija Reservar el mismo horario todas las semanas de una vez ("Solo esta vez" vs. "Todas las semanas"), cancelar un solo día o soltar toda la serie, la insignia "🔁 Fijo".
/docs/funcionalidades/entrenar-fuera-del-gimnasio Marcar los días que entrenaste por tu cuenta para que tu rutina avance. Solo lo ven los alumnos a quienes el gimnasio les habilitó la opción. No reserva cupo, no gasta clases del plan y no bloquea nada.
/docs/funcionalidades/mi-suscripcion Tu propia suscripción: ver el plan, su costo, la frecuencia de cobro, el resumen de tus últimos 12 pagos y cancelarla cuando ya estás suscrito; y cuando no lo estás, comprar un plan o sumar tiempo, usar un cupón y distinguir los planes que se pagan en línea de los que activa el gimnasio a mano. Es la pantalla del propio alumno, no la gestión del plan de otra persona (eso es Asignar el plan de un alumno) ni el catálogo del gimnasio (Catálogo de planes del gimnasio y cobros).
/docs/funcionalidades/clases-de-prueba-y-regalo Cómo el alumno usa los créditos de prueba (los da el gimnasio al registrarse) o de regalo (los otorga un administrador) al reservar. Para activar las clases de prueba en todo el gimnasio ver Configuración del gimnasio; para que un administrador otorgue o revoque un crédito a un alumno puntual ver Asignar el plan de un alumno.
El alumno edita sus propios datos: foto, datos personales, salud, actividad física, contacto de emergencia y contraseña. Para que un administrador edite los datos de otro alumno, ver La ficha de un alumno.
Comunidad
/docs/funcionalidades/comunidad-muro Publicar texto, fotos y videos; etiquetar con "@"; encuestas; reaccionar; comentar; editar o borrar una publicación; "Información importante".
/docs/funcionalidades/comunidad-mi-gimnasio Cumpleaños del mes con el botón "Saludar", "tu círculo" (con quién compartiste más clases) y las reglas del gimnasio. No es donde se publica en el muro (eso es el documento anterior).
Profesores
/docs/funcionalidades/agenda-del-profesor La semana y el día del profesor, "Solo mías" vs. "Todas", la lista de alumnos de cada bloque, abrir la rutina de un alumno, el acceso a tomar clases como alumno.
Administradores
/docs/funcionalidades/admin-tipos-de-clase Crear, editar o eliminar una disciplina (Crossfit, Yoga, etc.): nombre, emoji, color, duración y comportamiento (registros de entrenamiento, inscripción recurrente, clases de prueba). Es la configuración de base; no crea horarios ni cupos — eso es el siguiente documento.
/docs/funcionalidades/admin-cupos-y-horarios Crear y editar bloques: qué día, a qué hora, con qué tipo de clase y cuántos cupos totales tiene (horario habitual que se repite cada semana, o una semana concreta puntual), y marcar un día sin clases. Es la grilla del gimnasio, no la lista de alumnos de una clase puntual. Para agregar, quitar o cancelar la reserva de un alumno en un bloque ya creado, ver el siguiente documento.
/docs/funcionalidades/admin-gestionar-alumnos-de-una-clase Abrir un bloque puntual (desde el horario o desde la agenda del profesor) y agregar o quitar/cancelar la reserva de un alumno ahí adentro: confirmados, lista de espera, buscar al alumno por alias, agregarlo aunque el bloque esté lleno (sobrecupo). Esta es la respuesta cuando la pregunta es "cómo cancelo/saco/anulo el cupo de un alumno en una clase" — no Cupos y horarios, que es la configuración del bloque en sí (horario, capacidad total), no la reserva de una persona puntual.
/docs/funcionalidades/admin-usuarios El listado de alumnos: buscar, filtrar por tipo de clase/plan/clases de regalo, agrupar (Activos, Prueba, Vencidos, Profes/Admin), generar el enlace de registro, exportar a Excel. Para entrar al detalle de un alumno puntual, ver el siguiente documento.
/docs/funcionalidades/admin-ficha-del-alumno Editar los datos de un alumno puntual: pestañas Perfil (datos y foto), Rutinas, Planes, Clases (historial) y Cuenta (usuario, contraseña, alias, roles de profesor/administrador). Para asignarle o cambiarle el plan, ver el siguiente documento.
/docs/funcionalidades/admin-asignar-plan-a-un-alumno Lo que se hace dentro de la ficha de una persona: asignarle un plan (partiendo de una plantilla del gimnasio o personalizado), renovarlo cuando paga (atajo "Hoy", que en los planes personalizados no recalcula "Pagado hasta": hay que escribirlo a mano, y conviene pasarlos a un plan del catálogo), activarlo o desactivarlo, darle un segundo plan (la excepción: lo normal es un plan por alumno), otorgar o revocar clases de regalo y revisar por qué no puede reservar. Es la respuesta cuando la pregunta habla del plan de un alumno puntual. Los planes que el gimnasio ofrece se crean en el siguiente documento.
/docs/funcionalidades/admin-catalogo-de-planes-y-cobros El catálogo, que es igual para todos: crear las plantillas de plan (nombre, precio, duración, tipos de clase, los dos topes de clases), publicarlas para cobro automático con Mercado Pago, los productos de tiempo fijo, la lista de suscriptores, vincular una suscripción a un alumno y cancelar una suscripción (con todo lo que eso implica). Es la respuesta cuando la pregunta habla de precios, de Mercado Pago o de suscripciones, no del plan de una persona puntual (documento anterior).
/docs/funcionalidades/admin-configuracion-del-gimnasio Los logos (grande de ingreso y pequeño de la barra), hasta cuándo se puede tomar y cancelar una clase, con cuánta anticipación se reserva, si el registro es abierto o solo con invitación, las reglas de entrenamiento y convivencia, las clases de prueba al registrarse y qué servicios externos están conectados. Es la configuración global del gimnasio, no el crédito o el plan de un alumno puntual (ver Clases de prueba y de regalo o Asignar el plan de un alumno), ni los cupos de cada horario (ver Cupos y horarios).
/docs/funcionalidades/admin-preguntas-para-la-pagina-web El cuestionario de 6 pasos para armar la landing pública del gimnasio: preguntas, imágenes, vista previa, enviar y volver a corregir lo ya enviado.
/docs/funcionalidades/admin-invitar-gimnasios La campaña por tiempo limitado, que vive en la página pública de GGym Planner y no dentro de la plataforma: recomendarle la plataforma a otro gimnasio, avisarnos por WhatsApp que es tu referido (sin ese aviso no hay descuento) y que los dos descuenten $5.000 CLP al mes desde que el gimnasio nuevo paga su primera mensualidad, mientras ambos sigan activos. Cómo se acumula con cada gimnasio. Es la mensualidad que tu gimnasio le paga a GGym Planner, no los planes que tú le cobras a tus alumnos (eso es Catálogo de planes del gimnasio y cobros).
/docs/funcionalidades/admin-importar-y-exportar-configuracion Exportar los tipos de clase y los horarios habituales de un gimnasio a un archivo, e importarlos en otro. Solo la grilla habitual — no alumnos, planes ni semanas concretas.
Cómo leerlo
Cada documento sigue siempre el mismo orden: quién puede hacerlo, cómo llegar, el paso a paso, qué significa lo que ves en pantalla, los casos especiales y qué hacer si algo no funciona. Puedes leerlo completo o saltar directo a la sección que te interesa.