Glosario
Esta página define los términos canónicos usados en todo Agon y su documentación. En caso de duda, usa exactamente estos términos — no sinónimos.
Studio manager
El propietario o administrador de una instalación de Agon. El studio manager crea clases, gestiona clientes e instructores, configura membresías y tiene acceso completo a todos los ajustes e informes.
No: administrador, dueño, operador.
Cliente
Una persona que asiste a clases en el estudio. Los clientes usan la aplicación móvil Agon para consultar el calendario, reservar clases y hacer el check-in.
No: miembro, alumno, usuario, consumidor.
Instructor
Un miembro del personal que imparte clases. Los instructores son distintos de los studio managers — pueden ver el calendario de clases y la lista de participantes, pero no pueden cambiar los ajustes del estudio ni acceder a los datos financieros.
No: profesor, coach, entrenador, miembro del personal.
Plantilla de clase
Una definición reutilizable de un tipo de clase — su nombre, su duración predeterminada, su capacidad predeterminada y el instructor asociado. Piensa en ella como el "tipo" de clase, no como una ocurrencia concreta.
Ejemplo: "Yoga Flow" es una plantilla de clase. Cada martes a las 9 h es una clase programada independiente basada en esa plantilla.
No: tipo de clase, definición de clase, actividad.
Clase programada
Una ocurrencia concreta de una plantilla de clase en una fecha y hora concretas, en una ubicación concreta, con un instructor y una capacidad confirmados. Los clientes reservan clases programadas, no plantillas. Una clase programada es una actividad de grupo con capacidad compartida — consulta Cita para el equivalente individual.
No: sesión de clase, evento, franja.
Reserva
La reserva confirmada de un cliente para una clase programada concreta. Una reserva descuenta un crédito de la membresía activa del cliente (si procede) y da al cliente acceso para hacer el check-in.
No: inscripción, registro, apunte.
Cita
La reserva individual confirmada de un cliente con un instructor concreto para un servicio de cita concreto (por ejemplo, entrenamiento personal, masaje o coaching privado) en una fecha y hora concretas. A diferencia de una clase programada, una cita tiene exactamente un cliente y sin capacidad compartida. Reservar una cita descuenta un crédito de la membresía activa del cliente, el mismo mecanismo que reservar una clase — no hay una vía de pago separada para las citas. Un studio manager o un instructor puede marcar después una cita confirmada como completada o como no presentado, y se aplica la misma política de cargo por cancelación tardía / cargo por no presentarse que en las reservas de clases.
No: sesión, clase particular, sesión individual, inscripción, clase.
Servicio de cita
Un tipo de cita definido por el studio manager que los clientes pueden reservar (por ejemplo, "Entrenamiento personal" o "Masaje de 60 minutos"), con una duración fija y un tiempo de margen opcional — un intervalo que se aplica después de cada cita antes de que pueda empezar la siguiente para el mismo instructor. Desactivar un servicio es un borrado lógico: deja de aparecer para nuevas reservas, pero se conserva el historial de citas que lo referencia. No existe una opción de borrado definitivo.
No: tipo de servicio, tipo de sesión, tratamiento.
Disponibilidad del instructor
Las ventanas de tiempo semanales recurrentes durante las cuales se puede reservar a un instructor para citas (por ejemplo, "martes 09:00–13:00"). La disponibilidad es solo semanal recurrente — Agon todavía no admite excepciones para fechas concretas ni ajustes por festivos. Las franjas horarias de cita disponibles se calculan a partir de estas ventanas, menos las citas confirmadas existentes del instructor y el tiempo de margen del servicio que se reserva.
No: horario laboral, agenda, turno.
Lista de espera
Si una clase programada está completa, los clientes pueden unirse a la lista de espera. Cuando se cancela una reserva, el primer cliente de la lista de espera se promociona automáticamente a una reserva confirmada y recibe una notificación.
Check-in
La confirmación de que un cliente asistió físicamente a una clase. El check-in lo puede hacer el cliente (mediante el código QR de la aplicación móvil), el instructor (escaneando el código del cliente) o manualmente el studio manager.
No: entrada, asistencia, fichaje.
Membresía
Un paquete que da a un cliente acceso a clases durante un periodo de tiempo. Hay dos tipos:
- Membresía recurrente — activa durante un número determinado de días (p. ej. 30 días) y renovada automáticamente mediante Stripe.
- Paquete de créditos — un número fijo de créditos que se consumen uno por reserva, sin límite de tiempo.
No: suscripción, plan, paquete, bono.
Crédito
Una única unidad de acceso a una clase, incluida en una membresía de paquete de créditos. Cada reserva descuenta un crédito. Los créditos no caducan a menos que la propia membresía tenga fecha de vencimiento.
No: ficha, punto, crédito de sesión, bono de clase.
Crédito acumulado
Un crédito no utilizado que pasa al siguiente periodo de facturación del cliente en lugar de perderse, cuando un tipo de membresía recurrente tiene activada la acumulación de créditos. Un tipo de membresía puede limitar opcionalmente cuántos créditos pueden acumularse por periodo.
No: crédito traspasado, crédito guardado.
Oferta de introducción
Un precio de primera compra con descuento o una ventana de validez sobre un tipo de membresía, que se muestra automáticamente a un cliente la primera vez que compra ese tipo de membresía (o cualquier otro tipo de membresía con oferta de introducción en el mismo estudio). El precio habitual se aplica a todas las compras posteriores.
No: oferta de prueba, descuento de bienvenida, descuento de primera vez.
Cargo por cancelación tardía / cargo por no presentarse
Un cargo registrado contra un cliente cuando cancela una reserva dentro de la ventana de cancelación (una cancelación tardía, solo si está activada la opción "la cancelación deduce crédito") o cuando se le marca como no presentado en el check-in. Se resuelve por cliente así: el ajuste específico del tipo de membresía del cliente, luego el valor predeterminado del estudio y, por último, sin cargo. Se registra como una fila de Payment en lugar de un cargo automático a la tarjeta — el estudio sigue teniendo que cobrarlo mediante su propio proceso.
No: penalización, recargo por cancelación (como concepto distinto del cargo en sí).
Código promocional
Un código que un cliente introduce al pagar una membresía para obtener un descuento porcentual o de importe fijo. Lo configura el studio manager con un límite de uso opcional, una restricción de uno por cliente y una ventana de validez.
No: código de descuento, cupón.
Tarjeta regalo
Un saldo prepagado identificado por un código (formato GC-XXXXXXXX) que un cliente puede canjear en la compra de una membresía, o que un studio manager emite manualmente para una venta por teléfono o en persona. Un cliente también puede comprar una tarjeta regalo para regalarla a otra persona.
No: vale, nota de crédito.
Etiqueta
Una etiqueta corta y de color que un studio manager asocia a un cliente para organizar y filtrar la lista de clientes (p. ej. "VIP", "Riesgo de lesión"). Las etiquetas se pueden asignar manualmente o automáticamente mediante una regla de etiquetado automático. Los clientes ven sus propias etiquetas en modo de solo lectura en la aplicación móvil.
No: rótulo (como concepto distinto), categoría.
Producto
Un artículo de venta al público que un studio manager mantiene en el catálogo para la venta en persona — p. ej. una barrita de proteínas o una botella de agua — con un nombre, un SKU opcional, un precio y una cantidad de stock controlada. Se gestiona en Productos en el backoffice de escritorio; solo para el manager, sin interfaz orientada al cliente.
No: artículo, SKU (un SKU es un campo de un producto, no el producto en sí).
Venta de producto
Un registro de una venta en persona completada de uno o más productos, anotada por un studio manager después de que el pago ya se haya cobrado en efectivo, con tarjeta u otro método fuera de Agon. Opcionalmente se asocia a un cliente, o se deja como venta sin cliente. Registrar una venta descuenta las cantidades vendidas del stock de cada producto.
No: pedido, transacción, compra (reservado para las compras de membresías o tarjetas regalo procesadas mediante Stripe).
Regla de etiquetado automático
Una regla que asigna automáticamente una etiqueta a un cliente cada vez que le ocurre un evento desencadenante elegido (por ejemplo, un no presentado o una reserva cancelada). La configura el studio manager; se ejecuta automáticamente sin ninguna acción manual una vez creada.
Descargo de responsabilidad
Un documento (por ejemplo, una exención de responsabilidad o una política del estudio) que un studio manager redacta y puede exigir que los clientes firmen digitalmente antes de reservar. Editar el cuerpo de un descargo crea una nueva versión y obliga a todos los clientes a volver a firmarlo, incluso a quienes firmaron una versión anterior. La firma siempre la hace el propio cliente — no hay forma de que un studio manager o un instructor firme en nombre de un cliente.
No: formulario de consentimiento (úsalo solo al referirte al registro de consentimiento del RGPD, que es aparte), exención, acuerdo.
Token de sincronización de calendario
Un secreto de larga duración incrustado en la URL del feed de calendario personal de un cliente, que se usa porque las aplicaciones de calendario (Google, Apple, Outlook) consultan una URL estática y no pueden iniciar sesión en una aplicación. El token de la URL es en sí mismo la credencial. Un cliente o un studio manager puede regenerarlo, lo que invalida el enlace antiguo y obliga a volver a suscribirse.
Ubicación
Un lugar físico donde se imparten las clases. En la V1, Agon admite una única ubicación. La compatibilidad con varias ubicaciones está prevista para la V2. El campo location_id ya está en el esquema de la base de datos.
No: sucursal, local, estudio (usa "estudio" solo para referirte al negocio en su conjunto, no a una sala o edificio concretos).
Túnel
Una URL HTTPS pública y segura creada mediante Cloudflare Tunnel que permite a tus clientes conectar la aplicación móvil a tu instancia de Agon desde cualquier lugar, sin exponer tu red local.
No: URL, conexión, enlace, proxy.
Código QR del estudio
Un código QR que se muestra en Configuración → Conectividad y que codifica la URL del túnel. Los clientes escanean este código una vez al configurar la aplicación móvil para conectarse a tu estudio.
Widget del sitio web
Un panel de calendario de clases incrustable y de solo lectura que un studio manager pega en su propio sitio web público como un <iframe> (el fragmento de incrustación está en Configuración → Widget del sitio web). Muestra las próximas clases programadas con el instructor y las plazas disponibles, usando los colores de marca del propio estudio — nunca precios, membresías, listas de clientes ni datos de contacto de los instructores. Por ahora no permite reservar una clase desde dentro del widget; los clientes siguen reservando mediante la aplicación móvil. El widget se sirve desde la propia URL del túnel del estudio, por lo que su fragmento de incrustación debe volver a copiarse cada vez que cambie la dirección del túnel (por ejemplo, tras reiniciar el backend de Agon).
No: widget de calendario, widget de reservas, incrustación, iframe.
Token de invitación
Un token de tiempo limitado enviado por email a un cliente recién creado. El cliente sigue el enlace para establecer su contraseña y activar su cuenta. Caduca a los 7 días.
Token de restablecimiento
Un token de tiempo limitado enviado por email cuando un cliente solicita restablecer su contraseña. Caduca a las 2 horas.
Lista inteligente
Un filtro guardado que identifica un subconjunto de clientes según el estado de la membresía, la antigüedad de la última reserva, la fecha de alta o el tipo de membresía. Se usa para enviar emails segmentados.
Bloque
Un único elemento en el lienzo del Editor visual de emails — texto, imagen, botón, divisor, espaciador o HTML sin procesar — que un studio manager añade, ordena y configura para crear una plantilla de email. Los bloques se apilan de arriba abajo y cada uno tiene sus propios controles (alineación, color, tamaño, etc.) que se muestran cuando el bloque está seleccionado; el lienzo representa el email exactamente como se enviará, en directo, sin un paso de vista previa aparte. Una plantilla creada o editada antes de esta función no tiene bloques — al abrirla se ofrece "Convertir a lienzo", que envuelve su HTML existente como un único bloque inicial para que no se pierda nada.
No: elemento, componente, widget, módulo.
Asignación de evento
Una configuración que asocia un evento de Agon (p. ej. "nuevo cliente invitado", "reserva confirmada") a una plantilla concreta de email o SMS. Cuando ocurre el evento, la plantilla asignada se envía automáticamente — siempre que ese evento esté realmente conectado para enviar mensajes (actualmente solo "nuevo cliente invitado" y "restablecimiento de contraseña" desencadenan un envío, tanto para email como para SMS).
Automatización de marketing
Una secuencia de emails o mensajes de texto de varios pasos y con retardos que un studio manager crea una vez y no vuelve a enviar a mano — por ejemplo, "espera 3 días tras el registro, envía un email; espera 7 días más y, si el cliente sigue sin reservar, envía otro". Se construye a partir de un desencadenante (un evento como un nuevo registro o una reserva, o una condición recurrente como "no ha reservado en 30 días"), una lista ordenada de pasos (cada uno con un retardo, un canal y una plantilla) y una condición de parada opcional. Un cliente se inscribe automáticamente cuando el desencadenante coincide y se inscribe como máximo una vez por automatización, nunca más. A diferencia de una Asignación de evento, que envía un único mensaje en el instante en que ocurre un evento, una Automatización de marketing reparte varios mensajes a lo largo del tiempo.
No: campaña de goteo, flujo de trabajo, secuencia (por sí sola, sin "automatización").
Clase en línea
Una clase programada que el studio manager ha marcado como "En línea (Zoom)", para la cual Agon crea y gestiona automáticamente una reunión de Zoom real mediante la cuenta de Zoom conectada del propio studio manager. Solo se puede marcar como en línea una clase individual (no recurrente). Los clientes ven un enlace para unirse orientado al cliente ("Unirse en Zoom") en la clase y en su reserva; el studio manager y el instructor ven por separado un enlace de inicio solo para el anfitrión ("iniciar reunión"), que nunca se muestra a los clientes. Disponible en cualquier plan de Zoom, incluido el gratuito.
No: clase virtual, clase de Zoom, clase retransmitida en directo.
Asistente de migración
La herramienta integrada para importar tus clientes, membresías y clases a Agon desde una exportación CSV, Excel o JSON de tu plataforma actual. Se accede desde Configuración → Migración y solo está disponible para los Managers. Cada tipo de dato se importa por separado, uno cada vez. Agon nunca se conecta a tu plataforma anterior ni pide sus credenciales: tú exportas tus propios datos y subes el archivo.
Componente de pago
Una única regla que define cómo gana su remuneración un miembro del personal — por horas, por clase, por comisión o salario fijo. Un miembro del personal puede tener varios componentes de pago activos de tipos distintos a la vez (por ejemplo, una tarifa por horas y una comisión juntas), pero nunca dos componentes activos del mismo tipo. Se gestiona en Nómina del personal; solo para el manager, sin interfaz orientada al cliente.
No: tarifa de pago, línea salarial, regla de remuneración.
Ejecución de nómina
Un cálculo generado por un studio manager de lo que se le debe a cada miembro del personal en un rango de fechas elegido, calculado a partir de sus componentes de pago activos. Una ejecución empieza como borrador, que se puede regenerar libremente, y pasa a estar finalizada cuando el studio manager la bloquea — los importes de una ejecución finalizada nunca cambian. Marcar las líneas de una ejecución finalizada como pagadas deja constancia de que el studio manager pagó al miembro del personal fuera de Agon; dentro de Agon no se mueve dinero.
No: periodo de nómina, tanda de pago, nómina (documento).
Rol
Un conjunto de permisos con nombre asignado a exactamente una cuenta de personal, que determina lo que esa cuenta puede ver y hacer en la aplicación de escritorio. Manager e Instructor son roles integrados que siempre existen y no se pueden renombrar ni eliminar. Un studio manager también puede definir cualquier número de roles personalizados (por ejemplo, "Recepción"), cada uno de los cuales concede Ver o Gestionar sobre alguna combinación de cinco áreas: Clases, Miembros, Reservas, Registros de entrada y Membresías. Se gestiona en Personal y Roles; solo para el manager, sin interfaz orientada al cliente.
No: grupo de permisos, nivel de acceso, tipo de usuario.
Permiso
Una única capacidad concedida dentro de un Rol — un área (Clases, Miembros, Reservas, Registros de entrada o Membresías) a un nivel (Ver o Gestionar). El conjunto completo de permisos de un rol determina qué elementos de la barra lateral izquierda ve una cuenta de personal y qué puede hacer en ellos. Todas las áreas de Agon fuera de esas cinco (pagos, informes, marketing, ajustes, personal/nómina, punto de venta, etc.) no tienen ningún permiso que pueda concederlas — esas siguen siendo exclusivas del manager, independientemente de los permisos de un rol.
No: ámbito, derecho, concesión de acceso.
Jurisdicción
Qué plantilla de factura usa Agon para una factura generada — eu_vat, us_sales_tax o generic — decidida por el país configurado del estudio en Configuración en el momento en que se genera la factura. Una jurisdicción de la UE produce una factura con IVA con los números de IVA del vendedor y del comprador y un desglose de IVA; la jurisdicción de EE. UU. produce un desglose de impuesto sobre las ventas sin campos de número de IVA; cualquier otro país produce una factura genérica sin ningún desglose de impuestos declarado. Consulta Factura.
No: región, zona fiscal, país (el país es el ajuste del estudio que determina la jurisdicción, no la jurisdicción en sí).
Factura
Un documento PDF con numeración secuencial generado para un pago de membresía completado o una venta de producto registrada, redactado y estructurado para la jurisdicción del estudio. Solo puede existir una factura por pago o por venta. La facturación de Agon es un generador de documentos, no un servicio automatizado de cumplimiento fiscal — los tipos impositivos siempre los introduce el studio manager (o, para los estudios de la UE, un tipo de IVA predeterminado configurado), y ninguna factura se envía nunca a la red de facturación electrónica de una autoridad fiscal. Se gestiona en Facturas; solo para el manager, sin interfaz orientada al cliente.
No: recibo, cuenta, extracto.
Comentarios
Un informe de error, una pregunta o una sugerencia que un miembro del personal envía por correo electrónico al desarrollador de Agon, desde la pantalla Comentarios de la aplicación de escritorio (el botón abre un borrador dirigido a support@agon-studio.dev) o desde cualquier cuenta de correo. El borrador incluye solo la versión de la aplicación y el sistema operativo; no se añade automáticamente nada sobre el estudio ni sus clientes.
No: ticket de soporte, ticket de error, queja.
Clave de proveedor de IA
Una clave API que pertenece al estudio, creada con un proveedor de IA (Google Gemini o Groq) y guardada por el studio manager en Configuración → Asistente IA. El asistente de IA la usa para comunicarse directamente con ese proveedor desde el ordenador del estudio. Se guarda cifrada en la base de datos local, no se vuelve a mostrar después de guardarla y se borra con Eliminar clave en la misma pestaña. Como alternativa, el asistente puede usar un modelo local (Ollama). Consulta Modo básico.
No: clave de licencia, clave de Agon, token.
Modo básico
Cómo funciona el asistente de IA cuando no hay configurada ninguna clave de proveedor de IA ni ningún modelo local: una búsqueda por palabras clave en la documentación de Agon que funciona íntegramente en el ordenador del estudio, sin IA y sin conexión de red. No puede responder preguntas abiertas, realizar acciones de IA ni dar consejos de negocio.
No: modo sin conexión, modo gratuito, modo lite.
Informes de errores
Un ajuste opcional en Configuración → Privacidad, desactivado por defecto, que permite a Agon enviar detalles técnicos de los errores (sin datos personales) al desarrollador de Agon a través de Sentry (UE) para ayudar a corregir fallos. Cada informe lleva el ID del estudio. La elección del studio manager se aplica también a la aplicación móvil y al widget del sitio web del estudio.
No: telemetría, analítica, registros de fallos.
Cohorte de mayores gastadores
El grupo de clientes de pago con el mayor gasto total en un periodo determinado — el 20 % superior de los clientes de pago por gasto, o los 5 primeros si el 20 % fuera menos que eso. Se usa en la página Estadísticas y en las preguntas de asesoría de negocio del asistente de IA para comparar cómo se comportan tus clientes que más gastan frente al resto. Siempre se informa como recuentos y promedios a nivel de grupo — Agon nunca identifica qué clientes concretos están en la cohorte.
No: clientes VIP, mejores clientes, clientes top (úsalos solo en conversación coloquial, no como el término técnico para este grupo concreto).