Aller au contenu
Documentation avancée

La référence détaillée

Les règles exactes appliquées par Gainz, pour les gérants, les responsables administratifs et les intégrateurs.

Rôles et matrice des permissions

Chaque compte de l'équipe a un rôle, et chaque rôle un ensemble de permissions. Le Propriétaire possède toujours toutes les permissions et ne peut pas être modifié. Le Manager a tout sauf « Abonnement Gainz » (billing.manage) et « Gérer les rôles & permissions » (roles.manage). Les tableaux ci-dessous montrent les permissions accordées par défaut ; vous pouvez les modifier dans Configuration › Rôles & permissions.

Pilotage

PermissionCléManagerRéceptionCoach
Voir les chiffres financiers du tableau de borddashboard.finance✓——
Rapportsreports.view✓——
Charges & rentabilité (lecture)finance.view✓——
Charges & rentabilité (gestion)finance.manage✓——
Exporter les donnéesexports.use✓——

Adhérents

PermissionCléManagerRéceptionCoach
Voir les adhérentsmembers.view✓✓✓
Créer des adhérentsmembers.create✓✓—
Modifier les adhérentsmembers.edit✓✓—
Suspendre / archivermembers.status✓——
Enrôler le visagemembers.biometrics✓✓—

Abonnements & paiements

PermissionCléManagerRéceptionCoach
Voir les abonnementssubscriptions.view✓✓—
Créer / renouvelersubscriptions.create✓✓—
Geler / annulersubscriptions.manage✓——
Accorder des remisessubscriptions.discount✓——
Voir les paiementspayments.view✓✓—
Encaisserpayments.collect✓✓—
Supprimer un paiementpayments.delete✓——

CRM & marketing

PermissionCléManagerRéceptionCoach
Voir les prospectscrm.view✓✓—
Gérer les prospectscrm.manage✓✓—
Envoyer des campagnesmarketing.send✓——
Automatisations & modèlesmarketing.manage✓——

Documents & espace adhérent

PermissionCléManagerRéceptionCoach
Voir les documentsdocuments.view✓✓—
Gérer les documentsdocuments.manage✓✓—
Gérer l'espace adhérentportal.manage✓✓—

Accès

PermissionCléManagerRéceptionCoach
Voir le journal des entréesaccess.view✓✓✓
Pointer une entrée / sortieaccess.checkin✓✓—
Ouvrir la bornekiosk.use✓✓—

Coaching

PermissionCléManagerRéceptionCoach
Voir le planningsessions.view✓✓✓
Gérer les séancessessions.manage✓—✓
Inscrire aux séancessessions.book✓✓✓
Voir les programmesprograms.view✓—✓
Gérer les programmesprograms.manage✓—✓
Voir les coachscoaches.view✓✓✓
Gérer les coachscoaches.manage✓——

Caisse & boutique

PermissionCléManagerRéceptionCoach
Utiliser la caissepos.sell✓✓—
Remises en caissepos.discount✓——
Ouvrir / clôturer la caissepos.cash✓✓—
Rembourser une ventepos.refund✓——
Gérer produits & stockproducts.manage✓——
Voir l'historique des ventessales.view✓✓—

Configuration

PermissionCléManagerRéceptionCoach
Gérer les formulesplans.manage✓——
Paramètres de la sallesettings.manage✓——
Gérer l'équipeteam.manage✓——
Gérer les rôles & permissionsroles.manage———
Abonnement Gainzbilling.manage———
Journal d'auditaudit.view✓——
Supportsupport.use✓——

Règles d'accès et logique de la borne

La même logique s'applique à la borne et au pointage manuel à l'accueil. Les contrôles sont effectués dans cet ordre ; le premier qui échoue détermine le motif de refus affiché.

#ContrôleRésultat en cas d'échec
1Identification (badge, n° d'adhérent, visage)« Badge inconnu », « Numéro d'adhérent inconnu », « Visage non reconnu »
2Sens du passage : en mode automatique, entrée ou sortie selon le dernier passage du jour—
3Anti-double passage : même sens dans le délai paramétré« Déjà enregistré » (autorisé, non compté)
4SortieToujours autorisée
5Fermeture exceptionnelle (toujours vérifiée)« Salle fermée aujourd'hui (motif) »
6Horaires d'ouverture, si « Appliquer les horaires à la borne » est activé« Salle fermée aujourd'hui » ou « Salle ouverte de … à … »
7Capacité maximale simultanée« Capacité maximale atteinte (N personnes) »
8Suspension pour impayé (posée par une règle de relance)« Accès suspendu : échéance impayée »
9Statut de l'adhérent« Compte suspendu » / « Compte archivé »
10Abonnement commencé et non expiré (tolérance comprise)« Aucun abonnement valide »
11Abonnement gelé« Abonnement gelé »
12Carnet décompté à l'entrée : séances restantes« Carnet de séances épuisé »
13Abonnement annulé« Abonnement annulé »
14Plage horaire de la formule« Accès autorisé de 07h00 à 12h00 »
15Quota de visites par semaine (semaine du lundi, jours distincts)« Quota hebdomadaire atteint (N visites) »

Avertissements (entrée autorisée)

  • « Abonnement expiré — période de grâce » : l'abonnement est expiré mais dans les jours de tolérance.
  • « Échéance de paiement en retard » : une échéance est en retard (statut À payer ou Partiel).
  • « Abonnement expire dans N jour(s) » : il reste 7 jours ou moins.

Pour un carnet décompté à l'entrée, chaque entrée autorisée (hors doublon anti-passage) consomme une séance. La présence en salle est calculée à partir du dernier passage de chaque adhérent dans la journée.

Un responsable disposant de « Paramètres de la salle » peut forcer l'entrée depuis l'accueil après un refus, avec un motif obligatoire, tracé dans le journal des accès et le journal d'audit.

Face ID : conformité CNDP et loi 09-08

Le visage est une donnée biométrique. Au Maroc, son traitement requiert l'autorisation préalable de la CNDP et le consentement explicite de la personne. Gainz applique ces règles techniquement :

  1. 1

    Blocage tant que l'autorisation n'est pas saisie

    L'enrôlement et la reconnaissance à la borne restent bloqués jusqu'à la saisie du n° d'autorisation CNDP (biométrie) dans Configuration › Conformité. La borne répond « Reconnaissance faciale non autorisée (conformité) ».

  2. 2

    Consentement explicite

    Avant chaque enrôlement, le texte de consentement est présenté ; le bouton Il accepte, lancer le Face ID déclenche la capture. Sans consentement, aucun gabarit n'est enregistré. La date du consentement est conservée et l'action tracée dans le journal d'audit.

  3. 3

    Alternative toujours disponible

    Badge, carte QR de l'espace adhérent et numéro d'adhérent restent utilisables : le Face ID n'est jamais une condition d'accès imposée par défaut.

  4. 4

    Droit de retrait

    La suppression des données biométriques depuis la fiche efface le gabarit et les captures associées.

RéglageEmplacementDéfaut
N° d'autorisation CNDP (biométrie)Configuration › ConformitéVide (Face ID bloqué)
N° de déclaration CNDP (fichier adhérents)Configuration › ConformitéVide
Seuil de reconnaissanceConfiguration › Règles d'accès0,50 (de 0,30 strict à 0,70 tolérant)
Face ID obligatoire à l'inscriptionConfiguration › Règles d'accèsDésactivé

Numérotation des reçus et mentions légales

SéquencePréfixe par défautFormat
Reçus de paiementRR-00042
Tickets de caisseParamétrablePRÉFIXE-00042
Numéros d'adhérentParamétrablePRÉFIXE-00042
Chaque séquence est indépendante, sur 5 chiffres minimum, et n'est jamais réinitialisée.

Identifiants légaux (Maroc)

IdentifiantSaisieImprimé sur le reçu
ICE (15 chiffres)Obligatoire✓
Identifiant fiscal (IF)Facultatif✓
Registre de commerce (RC)Facultatif—
Taxe professionnelle (patente)Facultatif—
N° CNSSFacultatif—

TVA

  • Assujetti à la TVA : activé par défaut, taux de 20 % (14 %, 10 %, 7 % ou personnalisé disponibles). Un produit de la boutique peut avoir son propre taux.
  • Prix affichés taxe comprise (TTC) : activé par défaut. Le montant HT et la TVA sont déduits du prix TTC ; le reçu indique « dont TVA 20 % sur … HT ».
  • Salle non assujettie : aucune taxe n'est calculée et le reçu porte la mention « Non assujetti à la taxe ».

Échéanciers et répartition des paiements

  • Total de l'abonnement = prix + frais d'inscription (premier abonnement uniquement) − remise − code promo, taxes selon les règles de la salle.
  • Découpage : parts égales, l'arrondi est porté par la première échéance. Première échéance à la date de début, suivantes selon l'intervalle de la formule. Options : comptant, 2× à 12× (selon la formule).
  • Date modifiable : dans la période de l'abonnement, jamais avant l'échéance précédente ; motif conservé dans le journal.

Ordre de répartition d'un paiement

  1. 1

    Échéance ciblée

    Si le paiement est saisi depuis une échéance précise, il lui est affecté en priorité.

  2. 2

    Échéances dues

    Sinon, il règle toutes les échéances dues aujourd'hui ou en retard, de la plus ancienne à la plus récente.

  3. 3

    Prochaine échéance

    S'il n'y a rien de dû, il règle la prochaine échéance ouverte.

  4. 4

    Excédent

    Un montant supérieur au dû est refusé, sauf si « Affecter l'excédent aux prochaines échéances » est coché : l'excédent règle alors les échéances suivantes par date. Il ne peut pas dépasser le total restant ; aucun avoir n'est créé.

Un seul numéro de reçu couvre l'ensemble du paiement, même réparti sur plusieurs échéances. Dès qu'il n'existe plus d'échéance en retard, une suspension d'accès pour impayé est levée automatiquement. La suppression d'un paiement rend l'échéance de nouveau due à hauteur du montant.

Renouvellements et renouvellement automatique

SituationComportement
Renouvellement manuelLe nouvel abonnement démarre le lendemain de la fin du précédent, ou aujourd'hui s'il est déjà expiré. La formule peut changer. Pas de frais d'inscription.
Renouvellement automatiqueÀ l'échéance, si l'option est active, que l'abonnement n'a pas déjà été renouvelé et que l'adhérent est actif, un nouvel abonnement est créé avec le même nombre d'échéances (comptant si la formule ne le propose plus).
ExpirationUn abonnement actif dont la date de fin est passée devient « Expiré ».
GelSeul un abonnement actif peut être gelé. Au dégel, la date de fin est prolongée du nombre de jours gelés.
AnnulationÉchéances non payées annulées, contrats en attente invalidés, renouvellement automatique désactivé. Paiements conservés, remboursement non automatique.

Automatisations

DéclencheurDécalageConsentement marketing
Bienvenue (nouvel adhérent)Jours après l'inscriptionNon requis
Fin d'abonnement procheJours avant la finNon requis
Abonnement expiré non renouveléJours après la finNon requis
Échéance impayéeJours de retardNon requis
Rappel de séanceHeures avant la séanceNon requis
Relance prospectJours sans contactNon requis
Anniversaire—Requis
Adhérent inactifJours sans visiteRequis

Chaque message part une seule fois par personne et par événement. Les règles s'exécutent automatiquement au fil de l'activité (au plus une fois par heure) et par tâche planifiée ; Tout exécuter maintenant force un passage. Variables disponibles dans les modèles : {{member.firstName}}, {{member.lastName}}, {{member.number}}, {{subscription.planName}}, {{subscription.endDate}}, {{installment.amount}}, {{installment.dueDate}}, {{session.title}}, {{session.startsAt}}, {{gym.name}}, {{gym.phone}}, {{portal.url}}.

Règles de relance des impayés

La séquence est une liste d'étapes. Chaque étape a un décalage signé en jours par rapport à la date d'échéance (par exemple −3 = trois jours avant, +7 = sept jours de retard) et une action :

ActionEffet
Envoyer un messageE-mail ou WhatsApp, avec un modèle ou le message par défaut.
Alerter l'équipeL'impayé apparaît dans « À traiter par l'équipe » et dans le journal d'audit.
Suspendre l'accès à la borneRefus « Accès suspendu : échéance impayée ». Levée automatique au paiement, ou manuelle.

Une étape manquée est rattrapée pendant 2 jours. Chaque étape peut être désactivée sans être supprimée.

Configuration WhatsApp

  • Un seul numéro par salle, associé comme appareil connecté (WhatsApp › Paramètres › Appareils connectés › Connecter un appareil, puis scan du QR code affiché dans CRM & Marketing › WhatsApp).
  • Aucune clé d'API à fournir : l'envoi passe par la passerelle de la plateforme Gainz.
  • Statuts de connexion : « En attente d'appairage », « Connecté », « Déconnecté ».
  • Envoi automatique désactivé ou numéro déconnecté : les messages sont journalisés « À envoyer » avec un lien d'envoi manuel, puis Marquer envoyé.
  • Les SMS sont toujours envoyés manuellement depuis votre téléphone, via un lien.

Import CSV des adhérents

ÉtapeDétail
1. FichierCSV, 5 Mo et 5 000 lignes maximum.
2. Correspondance des colonnesReconnaissance automatique par nom de colonne ; toute colonne peut être ignorée.
3. Aperçu & importLa vérification des doublons est obligatoire avant l'import.
ChampRemarque
Prénom, NomObligatoires.
E-mail, TéléphoneServent à la détection des doublons.
Date de naissance, Genre, N° CINFacultatifs.
Adresse, Code postal, VilleFacultatifs.
Code badgeFacultatif ; sinon un badge est généré.
NotesFacultatif.

Doublon : même e-mail ou même téléphone qu'un adhérent existant, ou qu'une ligne précédente du fichier. Les numéros d'adhérent sont attribués automatiquement. Les prospects s'importent séparément (CRM › Importer des prospects, séparateur « ; » ou « , », origine par défaut au choix). La reprise complète d'un ancien logiciel (formules, abonnements, échéances, paiements, passages) est réalisée par l'équipe Gainz.

Exports

Les exports sont au format CSV, séparateur point-virgule, encodage UTF-8 avec BOM : ils s'ouvrent directement dans Excel en français. Ils nécessitent la fonctionnalité « Exports CSV » et la permission « Exporter les données » (exports.use).

DomaineExports disponibles
TableauxAdhérents, abonnements, paiements, échéances, entrées-sorties, documents, ventes, produits, caisses, charges, investissements, journal d'audit.
FinancesCompte de résultat, CA et charges, résultat mensuel, répartition des charges.
RapportsEncaissements (par formule, par moyen), balance âgée, adhérents actifs, flux, cohortes de rétention, âge, genre, entrées, carte d'affluence, top assidus, remplissage et présences des cours, cours par coach, top produits, marges, stock par catégorie.

Conservation des données

DonnéeRéglage (Configuration › Conformité)Défaut
Photos prises à la bornePhotos prises à la borne (jours), de 1 à 3 65090 jours
Données des anciens adhérentsDonnées des anciens adhérents (mois), de 1 à 240, à compter de la fin du dernier abonnement36 mois

Le bouton Purger maintenant supprime les photos de passage plus anciennes que la durée choisie ; les lignes du journal des accès sont conservées. Les données biométriques d'un adhérent sont supprimées depuis sa fiche dès qu'il retire son consentement. L'archivage des anciens adhérents se fait manuellement depuis leur fiche.

Bornes multiples et association

ÉlémentFonctionnement
Code d'association6 caractères, sans caractères ambigus (0, O, 1, I, L). Adresse dédiée et QR code par borne.
AssociationPar l'adresse de la borne, par saisie du code sur l'écran « Associer cette borne », ou par un compte de l'équipe ayant « Ouvrir la borne ». Après 8 tentatives erronées en 10 minutes, la saisie est temporairement bloquée.
Sens de passageEntrée & sortie (automatique), Entrée seule, Sortie seule.
MéthodesBadge & carte QR, Reconnaissance faciale, Saisie du numéro d'adhérent (au moins une).
État« En ligne » si la borne a donné signe de vie depuis moins de 2 minutes, sinon « Hors ligne ».
Borne principaleLa première borne créée. Elle est intégrée à l'écran Accueil & check-in et ne peut pas être désactivée ou supprimée tant que d'autres bornes sont actives.
Régénérer le codeDissocie tous les appareils associés (appareil perdu ou volé).
SuppressionUne borne qui a déjà enregistré des passages peut seulement être désactivée.

Écran d'affluence

Chaque borne dispose d'un écran d'affluence (bouton « Écran d'affluence »), à afficher sur une télévision. Il ne demande aucune connexion, affiche le logo et la couleur de la salle et se rafraîchit toutes les 30 secondes.

ZoneContenu
Dans la salle maintenantNombre de présents / capacité, et niveau « Calme » (< 40 %), « Modérée » (< 75 %) ou « Forte » si une capacité est définie.
Aujourd'huiNombre d'entrées du jour, ou « Salle fermée aujourd'hui ».
Affluence prévue aujourd'huiMoyenne des entrées par heure, le même jour de la semaine sur les 8 dernières semaines, avec les heures creuses et de pointe.
Prochains coursJusqu'à 4 cours avec les places restantes ou « Complet ».
Dernières arrivées« Bienvenue Prénom N. ! » : prénom et initiale seulement.

Forfaits Gainz : limites et fonctionnalités

LimiteDécouverteStarterProBusiness
Adhérents (non archivés)30150600Illimité
Utilisateurs actifs2310Illimité
Coachs actifs1315Illimité
Essai gratuit14 jours14 jours14 jours30 jours
FonctionnalitéDécouverteStarterProBusiness
Reconnaissance faciale——✓✓
Borne d'accès✓✓✓✓
Séances & réservations✓✓✓✓
Programmes d'entraînement——✓✓
Boutique & stock——✓✓
Rapports avancés——✓✓
Paiement échelonné—✓✓✓
Journal d'audit——✓✓
Charges & rentabilité——✓✓
Rôles personnalisés——✓✓
Espace adhérent——✓✓
Marketing automation——✓✓
CRM prospects—✓✓✓
Contrats & signature—✓✓✓
Exports CSV—✓✓✓
Support prioritaire———✓
Offre standard. Le détail de votre forfait est visible dans Configuration › Forfait & factures (« Inclus dans votre forfait »).

Une limite atteinte bloque la création (« Limite de votre forfait atteinte (N adhérents). Passez à un forfait supérieur. »). Une fonctionnalité absente du forfait affiche « Cette fonctionnalité n'est pas incluse dans votre forfait ».