Aller au contenu principal

Glossaire

Cette page définit les termes canoniques utilisés dans l'ensemble d'Agon et de sa documentation. En cas de doute, employez exactement ces termes — et non des synonymes.

Studio manager​

Le propriétaire ou l'administrateur d'une installation Agon. Le studio manager crée les cours, gère les clients et les instructeurs, configure les abonnements et dispose d'un accès complet à tous les paramètres et rapports.

À éviter : admin, propriétaire, opérateur.

Client​

Une personne qui assiste aux cours du studio. Les clients utilisent l'application mobile Agon pour consulter le planning, réserver des cours et s'enregistrer.

À éviter : membre, élève, utilisateur, consommateur.

Instructeur​

Un membre du personnel qui donne des cours. Les instructeurs sont distincts des studio managers — ils peuvent consulter le planning des cours et la liste des participants, mais ne peuvent pas modifier les paramètres du studio ni accéder aux données financières.

À éviter : professeur, coach, entraîneur, membre du personnel.

Modèle de cours​

Une définition réutilisable d'un type de cours — son nom, sa durée par défaut, sa capacité par défaut et l'instructeur associé. Considérez-le comme le « type » de cours, et non une occurrence précise.

Exemple : « Yoga Flow » est un modèle de cours. Chaque mardi à 9 h correspond à un cours planifié distinct fondé sur ce modèle.

À éviter : type de cours, définition de cours, activité.

Cours planifié​

Une occurrence précise d'un modèle de cours à une date et une heure données, dans un lieu donné, avec un instructeur confirmé et une capacité. Les clients réservent des cours planifiés, et non des modèles. Un cours planifié est une activité de groupe à capacité partagée — voir Rendez-vous pour l'équivalent individuel.

À éviter : séance de cours, événement, créneau.

Réservation​

La réservation confirmée d'un client pour un cours planifié précis. Une réservation déduit un crédit de l'abonnement actif du client (le cas échéant) et donne au client la possibilité de s'enregistrer.

À éviter : réserve, inscription, enregistrement d'inscription.

Rendez-vous​

La réservation individuelle confirmée d'un client avec un instructeur précis pour une prestation de rendez-vous donnée (par exemple, coaching personnel, massage ou coaching privé) à une date et une heure précises. Contrairement à un cours planifié, un rendez-vous compte exactement un client et aucune capacité partagée. Réserver un rendez-vous déduit un crédit de l'abonnement actif du client, selon le même mécanisme que la réservation d'un cours — il n'existe pas de circuit de paiement distinct pour les rendez-vous. Un studio manager ou un instructeur peut ensuite marquer un rendez-vous confirmé comme terminé ou comme non-présentation, et la même politique de frais d'annulation tardive / de frais de non-présentation que pour les réservations de cours s'applique.

À éviter : séance, cours particulier, séance individuelle, réserve, cours.

Prestation de rendez-vous​

Un type de rendez-vous défini par le studio manager que les clients peuvent réserver (par exemple, « Coaching personnel » ou « Massage 60 minutes »), avec une durée fixe et un temps tampon facultatif — un intervalle imposé après chaque rendez-vous avant que le suivant puisse commencer pour le même instructeur. Désactiver une prestation est une suppression logique : elle cesse d'apparaître pour les nouvelles réservations, mais l'historique des rendez-vous qui y font référence est conservé. Il n'existe pas d'option de suppression définitive.

À éviter : type de service, type de séance, soin.

Disponibilité de l'instructeur​

Les plages horaires hebdomadaires récurrentes pendant lesquelles un instructeur peut être réservé pour des rendez-vous (par exemple, « mardis 09h00–13h00 »). La disponibilité est uniquement hebdomadaire récurrente — Agon ne prend pas encore en charge les exceptions à des dates précises ni les remplacements pour jours fériés. Les créneaux de rendez-vous disponibles sont calculés à partir de ces plages, moins les rendez-vous confirmés existants de l'instructeur et le temps tampon de la prestation réservée.

À éviter : horaires de travail, planning, poste.

Liste d'attente​

Si un cours planifié est complet, les clients peuvent rejoindre la liste d'attente. Lorsqu'une réservation est annulée, le premier client de la liste d'attente est automatiquement promu en réservation confirmée et averti.

Check-in​

La confirmation qu'un client a physiquement assisté à un cours. Le check-in peut être effectué par le client (via un QR code dans l'application mobile), par l'instructeur (en scannant le code du client) ou manuellement par le studio manager.

À éviter : connexion, présence, pointage.

Abonnement​

Un forfait qui donne à un client accès aux cours sur une période donnée. Il en existe deux types :

  • Abonnement récurrent — actif pendant un nombre de jours défini (par exemple 30 jours) et renouvelé automatiquement via Stripe.
  • Pack de crédits — un nombre fixe de crédits consommés un par réservation, sans limite de durée.

À éviter : souscription, plan, pack (comme synonyme d'abonnement), pass.

Crédit​

Une unité unique d'accès à un cours, incluse dans un abonnement de type pack de crédits. Chaque réservation déduit un crédit. Les crédits n'expirent pas, sauf si l'abonnement lui-même a une date d'expiration.

À éviter : jeton, point, crédit de séance, pass de cours.

Crédit reporté​

Un crédit inutilisé qui est reporté sur la période de facturation suivante du client au lieu d'être perdu, lorsqu'un type d'abonnement récurrent a le report de crédits activé. Un type d'abonnement peut éventuellement plafonner le nombre de crédits reportables par période.

À éviter : crédit transféré, crédit mis en réserve.

Offre d'introduction​

Un tarif de premier achat réduit et/ou une fenêtre de validité sur un type d'abonnement, présenté automatiquement à un client la première fois qu'il achète ce type d'abonnement (ou tout autre type d'abonnement à offre d'introduction dans le même studio). Le tarif normal s'applique à tous les achats ultérieurs.

À éviter : offre d'essai, remise de bienvenue, remise première inscription.

Frais d'annulation tardive / Frais de non-présentation​

Un montant enregistré à la charge d'un client lorsqu'il annule une réservation à l'intérieur de la fenêtre d'annulation (une annulation tardive, uniquement si « l'annulation déduit un crédit » est activé) ou lorsqu'il est marqué comme non-présentation lors du check-in. Résolu par client selon l'ordre suivant : la valeur spécifique au type d'abonnement du client, puis la valeur par défaut du studio, puis aucun frais. Enregistré comme une ligne Payment plutôt que comme un débit automatique sur carte — le studio doit tout de même l'encaisser via son propre processus.

À éviter : pénalité, frais d'annulation (en tant que concept distinct des frais eux-mêmes).

Code promo​

Un code qu'un client saisit au moment du paiement d'un abonnement pour bénéficier d'une remise en pourcentage ou d'un montant fixe. Configuré par le studio manager avec une limite d'utilisation facultative, une restriction à une utilisation par client et une fenêtre de validité.

À éviter : code de réduction, coupon.

Carte cadeau​

Un solde prépayé identifié par un code (au format GC-XXXXXXXX) qu'un client peut utiliser pour l'achat d'un abonnement, ou qu'un studio manager émet manuellement pour une vente par téléphone ou en personne. Un client peut également acheter lui-même une carte cadeau pour l'offrir à quelqu'un d'autre.

À éviter : bon d'achat, avoir.

Tag​

Une étiquette courte et colorée qu'un studio manager attache à un client pour organiser et filtrer la liste des clients (par exemple, « VIP », « Risque de blessure »). Les tags peuvent être attribués manuellement ou automatiquement via une règle de tag automatique. Les clients voient leurs propres tags en lecture seule dans l'application mobile.

À éviter : libellé (en tant que concept distinct), catégorie.

Produit​

Un article de vente au détail qu'un studio manager tient dans le catalogue pour la vente en personne — par exemple une barre protéinée ou une bouteille d'eau — avec un nom, un SKU facultatif, un prix et une quantité de stock suivie. Géré sous Produits dans le back-office de bureau ; réservé au manager, sans interface côté client.

À éviter : article, SKU (un SKU est un champ d'un produit, pas le produit lui-même).

Vente de produit​

L'enregistrement d'une vente en personne finalisée d'un ou plusieurs produits, consignée par un studio manager après que le paiement a déjà été encaissé en espèces, par carte ou par un autre moyen en dehors d'Agon. Rattachée en option à un client, ou laissée comme vente sans compte. Enregistrer une vente déduit les quantités vendues du stock de chaque produit.

À éviter : commande, transaction, achat (réservé aux achats d'abonnement / de carte cadeau traités via Stripe).

Règle de tag automatique​

Une règle qui attribue automatiquement un tag à un client chaque fois qu'un événement déclencheur choisi se produit pour lui (par exemple, une non-présentation ou une réservation annulée). Configurée par le studio manager ; s'exécute automatiquement, sans aucune action manuelle une fois créée.

Décharge​

Un document (par exemple, une décharge de responsabilité ou un règlement intérieur du studio) qu'un studio manager rédige et dont il peut exiger la signature numérique par les clients avant toute réservation. Modifier le corps d'une décharge crée une nouvelle version et impose à chaque client de la signer à nouveau, y compris à ceux qui avaient signé une version antérieure. La signature est toujours effectuée par le client lui-même — il n'existe aucun moyen pour un studio manager ou un instructeur de signer à la place d'un client.

À éviter : formulaire de consentement (à utiliser uniquement pour le registre de consentement RGPD distinct), quittance, accord.

Jeton de synchronisation du calendrier​

Un secret à longue durée de vie intégré à l'URL du flux de calendrier personnel d'un client, nécessaire parce que les applications de calendrier (Google, Apple, Outlook) interrogent une URL statique et ne peuvent pas effectuer de connexion applicative. Le jeton présent dans l'URL est lui-même l'identifiant. Un client ou un studio manager peut le régénérer, ce qui invalide l'ancien lien et impose de se réabonner.

Emplacement​

Un lieu physique où se déroulent les cours. En V1, Agon prend en charge un seul emplacement. La prise en charge multi-emplacements est prévue pour la V2. Le champ location_id est déjà présent dans le schéma de la base de données.

À éviter : succursale, salle, studio (n'employez « studio » que pour désigner l'ensemble de l'activité, et non une pièce ou un bâtiment précis).

Tunnel​

Une URL HTTPS publique et sécurisée créée via Cloudflare Tunnel qui permet à vos clients de connecter l'application mobile à votre instance Agon depuis n'importe où, sans exposer votre réseau local.

À éviter : URL, connexion, lien, proxy.

QR code du studio​

Un QR code affiché dans Paramètres → Connectivité qui encode l'URL du Tunnel. Les clients scannent ce code une seule fois, lors de la configuration de l'application mobile, pour se connecter à votre studio.

Widget de site web​

Un panneau de planning des cours intégrable et en lecture seule qu'un studio manager colle sur son propre site web public sous forme d'<iframe> (extrait d'intégration disponible dans Paramètres → Widget de site web). Il affiche les prochains cours planifiés avec l'instructeur et les places disponibles, aux couleurs de la marque du studio — jamais les tarifs, les abonnements, les listes de clients ni les coordonnées des instructeurs. Il ne permet pas encore de réserver un cours depuis le widget ; les clients réservent toujours via l'application mobile. Le widget est servi depuis l'URL du Tunnel du studio, si bien que son extrait d'intégration doit être recopié chaque fois que l'adresse du tunnel change (par exemple, après un redémarrage du backend Agon).

À éviter : widget de planning, widget de réservation, embed, iframe.

Jeton d'invitation​

Un jeton à durée limitée envoyé par e-mail à un client nouvellement créé. Le client suit le lien pour définir son mot de passe et activer son compte. Il expire au bout de 7 jours.

Jeton de réinitialisation​

Un jeton à durée limitée envoyé par e-mail lorsqu'un client demande une réinitialisation de mot de passe. Il expire au bout de 2 heures.

Smart List​

Un filtre enregistré qui identifie un sous-ensemble de clients en fonction du statut d'abonnement, de la récence des réservations, de la date d'inscription ou du type d'abonnement. Utilisé pour envoyer des e-mails ciblés.

Bloc​

Un élément unique du canevas de l'éditeur d'e-mails visuel — texte, image, bouton, séparateur, espaceur ou HTML brut — qu'un studio manager ajoute, agence et configure pour construire un modèle d'e-mail. Les blocs s'empilent de haut en bas et chacun possède ses propres réglages (alignement, couleur, taille, etc.) affichés lorsque le bloc est sélectionné ; le canevas restitue l'e-mail exactement tel qu'il sera envoyé, en direct, sans étape d'aperçu distincte. Un modèle construit ou modifié avant cette fonctionnalité n'a aucun bloc — l'ouvrir propose « Convertir en canevas », qui enveloppe son HTML existant dans un unique bloc de départ afin que rien ne soit perdu.

À éviter : élément, composant, widget, module.

Affectation d'événement​

Une configuration qui associe un événement Agon (par exemple, « nouveau client invité », « réservation confirmée ») à un modèle d'e-mail ou de SMS précis. Lorsque l'événement se produit, le modèle affecté est envoyé automatiquement — à condition que cet événement soit effectivement câblé pour envoyer des messages (actuellement, seuls « nouveau client invité » et « réinitialisation de mot de passe » déclenchent un envoi, pour l'e-mail comme pour le SMS).

Automatisation marketing​

Une séquence multi-étapes et différée d'e-mails et/ou de SMS qu'un studio manager construit une fois et qu'il n'envoie plus jamais à la main — par exemple, « attendre 3 jours après l'inscription, envoyer un e-mail ; attendre 7 jours de plus, et si le client n'a toujours pas réservé, en envoyer un autre. » Construite à partir d'un déclencheur (un événement comme une nouvelle inscription ou une réservation, ou une condition récurrente comme « n'a pas réservé depuis 30 jours »), d'une liste ordonnée d'étapes (chacune constituée d'un délai, d'un canal et d'un modèle) et d'une condition d'arrêt facultative. Un client est inscrit automatiquement lorsque le déclencheur correspond, et il est inscrit au plus une fois par automatisation, à vie. Contrairement à une Affectation d'événement, qui envoie un message unique dès qu'un événement se produit, une Automatisation marketing étale plusieurs messages dans le temps.

À éviter : campagne goutte-à-goutte, workflow, séquence (seul, sans « automatisation »).

Cours en ligne​

Un cours planifié que le studio manager a marqué « En ligne (Zoom) », pour lequel Agon crée et gère automatiquement une véritable réunion Zoom via le compte Zoom connecté du studio manager. Seul un cours unique (non récurrent) peut être marqué en ligne. Les clients voient un lien de participation destiné aux clients (« Rejoindre sur Zoom ») sur le cours et sur leur réservation ; le studio manager et l'instructeur voient séparément un lien de démarrage réservé à l'hôte (« démarrer la réunion »), qui n'est jamais montré aux clients. Disponible avec n'importe quelle formule Zoom, y compris la formule gratuite.

À éviter : cours virtuel, cours Zoom, cours diffusé en direct.

Assistant de migration​

L'outil intégré permettant d'importer vos clients, abonnements et cours dans Agon à partir d'un export CSV, Excel ou JSON de votre plateforme actuelle. Accessible depuis Paramètres → Migration et réservé aux Managers. Chaque type de données s'importe séparément, l'un après l'autre. Agon ne se connecte jamais à votre ancienne plateforme et ne demande pas ses identifiants : vous exportez vous-même vos données et importez le fichier.

Composante de rémunération​

Une règle unique définissant la façon dont un membre du personnel est rémunéré — Horaire, Par cours, Commission ou Salaire fixe. Un membre du personnel peut avoir plusieurs composantes de rémunération actives de types différents à la fois (par exemple, un taux horaire et une commission ensemble), mais jamais deux composantes actives du même type. Géré sous Paie du personnel ; réservé au manager, sans interface côté client.

À éviter : taux de rémunération, ligne de salaire, règle de rémunération.

Traitement de paie​

Un calcul, généré par un studio manager, de ce qui est dû à chaque membre du personnel pour une plage de dates choisie, calculé à partir de ses composantes de rémunération actives. Un traitement commence à l'état de brouillon, qui peut être régénéré librement, et devient finalisé une fois que le studio manager le verrouille — les montants d'un traitement finalisé ne changent plus jamais. Marquer les lignes d'un traitement finalisé comme payées consigne que le studio manager a payé le membre du personnel en dehors d'Agon ; aucun argent ne circule à l'intérieur d'Agon.

À éviter : période de paie, cycle de paie, bulletin de paie.

Rôle​

Un ensemble nommé de permissions attribué à exactement un compte du personnel, déterminant ce que ce compte peut voir et faire dans l'application de bureau. Manager et Instructeur sont des rôles intégrés qui existent toujours et ne peuvent être ni renommés ni supprimés. Un studio manager peut également définir un nombre quelconque de rôles personnalisés (par exemple, « Accueil »), chacun accordant Consultation et/ou Gestion sur une combinaison de cinq domaines : Cours, Membres, Réservations, Check-ins et Abonnements. Géré sous Personnel et rôles ; réservé au manager, sans interface côté client.

À éviter : groupe de permissions, niveau d'accès, type d'utilisateur.

Permission​

Une capacité unique accordée au sein d'un Rôle — un domaine (Cours, Membres, Réservations, Check-ins ou Abonnements) à un niveau (Consultation ou Gestion). L'ensemble des permissions d'un rôle détermine quels éléments de la barre latérale gauche un compte du personnel voit et ce qu'il peut y faire. Tout domaine d'Agon en dehors de ces cinq (paiements, rapports, marketing, paramètres, personnel/paie, point de vente, etc.) n'a aucune permission susceptible de l'accorder — ces domaines restent réservés au Manager, quelles que soient les permissions d'un rôle.

À éviter : portée, droit, octroi d'accès.

Juridiction​

Le modèle de facture qu'Agon utilise pour une facture générée — eu_vat, us_sales_tax ou generic — déterminé par le pays configuré du studio dans les Paramètres au moment où la facture est générée. Une juridiction de l'UE produit une facture avec TVA comportant les numéros de TVA du vendeur et de l'acheteur et une ventilation de la TVA ; la juridiction des États-Unis produit une ventilation de la taxe sur les ventes sans champs de numéro de TVA ; tout autre pays produit une facture générique sans ventilation fiscale revendiquée. Voir Facture.

À éviter : région, zone fiscale, pays (le pays est le paramètre du studio qui détermine la juridiction, et non la juridiction elle-même).

Facture​

Un document PDF à numérotation séquentielle généré pour un paiement d'abonnement finalisé ou une vente de produit enregistrée, formulé et structuré selon la juridiction du studio. Une seule facture peut exister par paiement ou par vente. La facturation d'Agon est un générateur de documents, et non un service automatisé de conformité fiscale — les taux de taxe sont toujours saisis par le studio manager (ou, pour les studios de l'UE, un taux de TVA par défaut configuré), et aucune facture n'est jamais transmise au réseau de facturation électronique d'une administration fiscale. Géré sous Factures ; réservé au manager, sans interface côté client.

À éviter : reçu, note, relevé.

Feedback​

Un signalement de bug, une question ou une suggestion qu'un membre du personnel envoie par e-mail au développeur d'Agon, depuis l'écran Retours de l'application de bureau (le bouton ouvre un brouillon adressé à support@agon-studio.dev) ou depuis n'importe quelle adresse e-mail. Le brouillon ne contient que la version de l'application et le système d'exploitation ; rien sur le studio ou ses clients n'est ajouté automatiquement.

À éviter : ticket de support, ticket de bug, réclamation.

Clé de fournisseur d'IA​

Une clé API qui appartient au studio, créée auprès d'un fournisseur d'IA (Google Gemini ou Groq) et enregistrée par le studio manager dans Paramètres → Assistant IA. L'assistant IA l'utilise pour joindre ce fournisseur directement depuis l'ordinateur du studio. Stockée chiffrée dans la base de données locale, jamais réaffichée après l'enregistrement, et effacée avec Supprimer la clé dans le même onglet. L'assistant peut aussi utiliser un modèle local (Ollama). Voir Mode de base.

À éviter : clé de licence, clé Agon, jeton.

Mode de base​

Le fonctionnement de l'assistant IA lorsqu'aucune clé de fournisseur d'IA ni aucun modèle local n'est configuré : une recherche par mots-clés dans la documentation d'Agon qui s'exécute entièrement sur l'ordinateur du studio, sans IA et sans appel réseau. Il ne peut ni répondre à des questions libres, ni effectuer des actions IA, ni donner de conseils de gestion.

À éviter : mode hors ligne, mode gratuit, mode allégé.

Rapports d'erreurs​

Un paramètre facultatif dans Paramètres → Confidentialité, désactivé par défaut, qui permet à Agon d'envoyer les détails techniques des erreurs (sans données personnelles) au développeur d'Agon via Sentry (UE) pour aider à corriger les bugs. Chaque rapport contient l'identifiant du studio. Le choix du studio manager s'applique aussi à l'application mobile et au widget de site web du studio.

À éviter : télémétrie, statistiques d'usage, journaux de plantage.

Cohorte des plus gros dépensiers​

Le groupe de clients payants dont la dépense totale est la plus élevée sur une période donnée — les 20 % de clients payants les plus dépensiers, ou les 5 premiers si 20 % représentent un nombre inférieur. Utilisée sur la page Analyses et par les questions de conseil aux entreprises de l'assistant IA pour comparer le comportement de vos clients les plus dépensiers à celui des autres. Toujours restituée sous forme de comptages et de moyennes au niveau du groupe — Agon n'identifie jamais quels clients précis composent la cohorte.

À éviter : clients VIP, meilleurs clients, top clients (à n'employer que dans une conversation courante, pas comme terme technique pour ce groupe précis).