Le guide complet de VNS Program Builder.

Sommaire

01 · Introduction02 · Base d'exercices2.1 · Structure d'un exercice2.2 · Variantes d'exercices2.3 · Créer / modifier / supprimer2.4 · Plans libres2.5 · Export / import03 · Créer un programme3.1 · Étape 1 - Profil3.2 · Étape 2 - Séances3.3 · Étape 3 - Détail exos3.4 · Étape 4 - Analyse3.5 · Synthèse04 · Mes programmes4.1 · Suivi & follow-up05 · Mes clients5.1 · Fiche profil5.2 · Évolution5.3 · Mensurations5.4 · Rattacher / fusionner06 · Exporter6.1 · PDF6.2 · Journal d'entraînement6.3 · Application Android07 · Assistant IA7.1 · Chat intégré au wizard7.2 · Serveur MCP08 · Bonnes pratiques09 · FAQ

VNS Program Builder est une application de coaching sportif conçue pour les professionnels qui ont besoin de créer, gérer et partager des programmes d'entraînement personnalisés. Elle s'adresse aussi bien aux coachs travaillant avec des athlètes de haut niveau en Powerlifting, Haltérophilie ou CrossFit, qu'à ceux accompagnant des clients en remise en forme générale.

L'application couvre l'intégralité du flux de travail d'un coach :

VNS Program Builder fonctionne entièrement hors ligne. Toutes les données sont stockées localement sur l'appareil - aucune connexion internet n'est requise.

L'application s'organise autour de trois modules principaux accessibles depuis l'écran d'accueil :

La base d'exercices est le socle sur lequel repose l'ensemble de l'application. Elle regroupe plus de 400 exercices préconfigurés couvrant la Musculation, le CrossFit, l'Haltérophilie, le Powerlifting et la remise en forme. Chaque exercice peut être consulté, modifié ou enrichi directement par le coach sans restriction.

Chaque exercice est décrit par un ensemble de champs qui permettent de le caractériser précisément et de l'intégrer intelligemment dans les programmes générés.

Chaque exercice peut posséder zéro ou plusieurs variantes. Une variante est un exercice qui sollicite les mêmes muscles selon le même schéma biomécanique, mais avec une légère différence d'exécution ou de matériel. Par exemple, le Développé couché barre et le Développé couché haltères sont des variantes l'un de l'autre - même mouvement de poussée horizontale. En revanche, le Développé incliné n'est pas une variante car le sens du mouvement est différent.

Cette notion permet d'organiser la bibliothèque de façon cohérente et de retrouver rapidement les alternatives à un mouvement donné lors de la construction d'une séance.

Chaque exercice de la base peut être modifié, supprimé ou créé librement par le coach. Pour créer un nouvel exercice, il suffit de renseigner son nom dans la barre de création, puis de choisir de le rattacher ou non à un exercice existant pour le déclarer comme variante.

Une fois confirmé, la fenêtre d'édition complète s'ouvre automatiquement pour permettre d'assigner une photo anatomique, rédiger les consignes d'exécution, définir les groupes musculaires et tous les autres champs de la fiche.

Depuis la liste des exercices, un menu d'actions permet d'accéder rapidement à l'édition, à la duplication ou à la suppression d'un exercice. La gestion des variantes est également accessible depuis ce menu - il est possible de consulter toutes les variantes d'un mouvement ou d'en ajouter de nouvelles à tout moment.

En complément des exercices structurés, la base intègre la notion de plans libres - entrées non liées à un exercice spécifique de la bibliothèque. Ils permettent d'intégrer dans un programme des activités à décrire librement (footing, mobilité, gainage spécifique…) sans structure de séries et répétitions. Ces plans sont de type poids du corps ou temps.

La base d'exercices peut être exportée au format CSV depuis les options de gestion. Ce fichier contient l'intégralité des exercices personnalisés par le coach - noms, groupes musculaires, équipements, consignes, variantes. Il peut être réimporté à tout moment dans la même instance ou dans une autre installation de VNS Program Builder.

Cette fonctionnalité est particulièrement utile pour sauvegarder une base bien travaillée avant une réinstallation, ou pour partager sa bibliothèque d'exercices avec un autre coach disposant de l'application. Un seul fichier CSV suffit pour transférer des centaines d'exercices personnalisés en quelques secondes.

La création d'un programme s'effectue à travers un tunnel guidé en quatre étapes. Chaque étape est accessible séquentiellement et la progression est sauvegardée automatiquement - il est possible de quitter le tunnel à tout moment et de le reprendre là où il en était.

Formulaire en plusieurs sections qui collecte toutes les données nécessaires à la personnalisation du programme.

Optionnel

Le mode Force est une option activable indépendamment du type de programme. Lorsqu'il est coché, une section s'ouvre pour saisir les résultats des tests de force du client sur les mouvements fondamentaux. Pour chaque mouvement : charge (kg), répétitions effectuées, RPE estimé → 1RM calculé automatiquement.

Fréquence d'entraînement par semaine, durée totale en semaines, et points d'attention à prendre en compte - douleurs chroniques, limitations physiques ou contraintes particulières du client. Ces informations sont reprises dans la synthèse finale.

Sur la base de la fréquence et de la durée renseignées, l'application génère automatiquement la structure semaine par semaine. Pour chaque semaine, chaque jour peut être marqué Entraînement ou Repos.

Cœur de l'application. Chaque séance est construite exercice par exercice. Les séances sont organisées par semaine sous forme de blocs dépliables.

Chaque séance dispose de champs optionnels : objectif du jour, consigne globale, temps de repos par défaut, durée totale estimée et nombre de tours si la séance est en circuit global.

Un bouton dédié ouvre une fenêtre de sélection connectée à la base d'exercices. Le coach peut rechercher un mouvement par son nom ou affiner les résultats via des filtres combinables : groupe musculaire principal, zone du corps, équipement requis, type d'effort (poids ou temps) et discipline sportive.

Un exercice secondaire se rattache directement sous l'exercice principal. L'ensemble est délimité par un encadré bleu avec ses propres champs : consigne globale, nombre de tours, repos entre tours, durée totale.

Lorsqu'un exercice apparaît dans plusieurs séances, le champ Référence permet de récupérer en un clic les valeurs de charge et répétitions d'une occurrence précédente. Les champs sont préremplis automatiquement - il suffit d'ajuster légèrement pour appliquer une surcharge progressive, sans rescroller les séances antérieures.

Tableau récapitulatif de tous les exercices utilisés, en trois colonnes : Photo anatomique · Nom · Technique d'exécution. Données récupérées automatiquement depuis la base.

Le coach peut personnaliser photo et technique pour ce programme spécifiquement, sans modifier la fiche globale. Si l'exercice apparaît dans plusieurs séances, il est possible de définir une consigne différente par occurrence - utile lorsque la technique évolue intentionnellement au fil du programme.

Agrège toutes les données des exercices tagués Analyse. Tableau et graphe interactifs pour visualiser la progression semaine par semaine.

Le graphe permet de sélectionner les semaines à afficher et de choisir l'axe d'analyse. Plusieurs exercices peuvent être comparés simultanément.

Page récapitulative générée automatiquement après validation de l'étape 4. Un bouton flottant d'export est disponible en permanence.

Tableau central de tous les programmes créés, triable par nom, date, statut ou client.

Chaque programme peut être mis en favori ⭐ pour apparaître en tête de liste. Le paramètre est persistant entre sessions.

La section Suivi est accessible depuis la fiche du programme. Elle permet de constituer un historique chronologique du suivi client, en centralisant les retours terrain et les observations du coach.

Lorsque le client renvoie son journal complété, le coach l'importe via le bouton dédié. Le document est horodaté automatiquement et le coach peut y associer un commentaire libre. Chaque import s'ajoute à l'historique sans écraser les entrées précédentes.

En l'absence de journal HTML, le coach peut saisir directement une note dans l'éditeur HTML riche intégré - gras, italique, listes, etc. La note est horodatée automatiquement.

Une fiche par client : identité, profil administratif, et une timeline chronologique regroupant tous ses programmes publiés ainsi que les suivis renvoyés pour chacun. Un brouillon n'apparaît jamais ici - il reste visible normalement dans Mes programmes en attendant d'être publié, pour ne pas encombrer la fiche client avec du travail non finalisé.

À l'étape 1 du créateur de programme, un champ « Client » permet de rechercher un client déjà connu. Le sélectionner pré-remplit automatiquement prénom, nom, taille, sexe et âge - modifiables ensuite comme n'importe quel champ.

Si le prénom/nom tapé correspond à un client déjà connu (sans passer par la recherche), un bandeau propose de consulter son historique dans un nouvel onglet. Pour le cas rare de deux personnes différentes portant le même nom, une case « Créer un profil distinct » force la création d'une fiche séparée plutôt que le rattachement automatique.

Depuis la fiche d'un client, trois onglets : « Historique » (timeline des programmes publiés et de leurs suivis), « Profil », qui centralise les informations qui ne concernent pas un programme en particulier, et « Évolution » (voir section 5.2).

La timeline regroupe, dans l'ordre chronologique inverse, tous les programmes publiés du client et les suivis renvoyés pour chacun. Un bouton permet d'ouvrir directement un programme dans un nouvel onglet.

Graphes construits à partir de l'historique des programmes publiés du client, un point par programme (dans l'ordre chronologique de création). Un programme où une valeur n'a pas été renseignée n'ajoute simplement pas de point à cette série-là (pas de zéro trompeur) - la ligne montre alors un vrai trou plutôt que de recoller les points voisins.

Chaque exercice se coche/décoche individuellement (puces sous « Charge par exercice ») pour être superposé aux autres sur le même graphe - pratique pour comparer la progression de plusieurs mouvements d'un coup d'œil. Chaque exercice coché a son propre réglage Poids max / Tonnage, indépendant des autres.

Les données sont chargées au premier clic sur l'onglet, puis conservées le temps de la consultation de cette fiche. Sans historique suffisant (poids, NAP et charges tous vides), un message l'indique à la place des graphes.

Option distincte de l'onglet Évolution (qui se construit à partir des programmes publiés) : à activer par client depuis l'onglet Profil (« Activer le suivi des mensurations pour ce client »). Une fois activée, un 4e onglet « Mensurations » apparaît pour saisir des relevés indépendants de tout programme - une date, un commentaire libre, et jusqu'à 11 mesures.

Depuis Mes programmes, le menu d'actions d'un programme propose « Rattacher à un client » : recherche parmi les clients existants, ou saisie d'un nouveau nom pour en créer un. Utile pour corriger un programme resté isolé (faute de frappe sur le nom à la création, par exemple).

Si deux fiches client correspondent en réalité à la même personne (variante orthographique du nom, par exemple), le bouton « Fusionner avec… » sur la fiche d'un client permet de tout regrouper dans une seule fiche : tous les programmes de l'autre fiche lui sont rattachés, puis elle est supprimée.

Comme sur Mes programmes et la Synthèse, une bulle 💬 permet de piloter cette page en langage naturel - filtrer la liste, renommer un client, ou proposer une fusion. Périmètre volontairement étroit : l'assistant ne peut ni créer de client ni modifier le contenu d'un programme, et ne fusionne jamais deux fiches sans confirmation explicite.

L'export est accessible depuis le bouton flottant de la synthèse ou le menu d'actions dans Mes programmes.

Document complet et imprimable : infos client, planification, séances détaillées et annexes. Avec annexes → fichier ZIP contenant plusieurs PDF séparés.

Fichier HTML autonome, lisible dans un navigateur sur Windows, Android et iOS, sans connexion. Le client y renseigne ses charges réelles, ses répétitions et son ressenti, puis utilise le bouton intégré pour partager le fichier complété avec son coach.

Journal HTML conditionné en application Android native, avec les annexes PDF directement intégrées et accessibles hors ligne.

La version APK offre la même expérience que le fichier HTML, avec les annexes PDF directement intégrées dans l'application et accessibles depuis un onglet dédié. L'application s'installe comme n'importe quelle app Android, avec une icône sur l'écran d'accueil.

Deux façons de créer et modifier un programme en langage naturel plutôt qu'en remplissant chaque champ à la main : un chat intégré directement au wizard, et un serveur MCP pour les coachs qui utilisent déjà Claude Desktop ou Claude Code.

Une bulle 💬 flottante en bas à droite de l'écran de création de programme, disponible aux quatre étapes du wizard. Elle ouvre un panneau de discussion : décrivez ce que vous voulez en une phrase, l'assistant propose les modifications correspondantes.

La même bulle 💬 existe aussi sur la page Synthèse d'un programme et sur Mes programmes - avec un périmètre volontairement plus étroit : ces deux pages ne permettent pas de modifier le contenu d'un programme (séances/exercices, réservé au wizard), seulement les actions déjà possibles manuellement à cet endroit.

Le chat a besoin d'une clé API pour fonctionner. Ouvrez le panneau (bulle 💬), puis l'icône ⚙️ en haut à droite pour renseigner votre fournisseur et votre clé.

Deux usages très différents en consommation : demander une ou deux modifications ponctuelles (mode Assistant), ou faire générer un programme entier en un seul échange, par exemple à partir d'une photo (mode Génération). Mesures réelles sur gpt-4o-mini :

Chaque fournisseur IA plafonne le nombre de tokens traités par minute selon le palier (« tier ») de votre compte - lié au montant total déjà payé et à l'ancienneté du compte, pas à un forfait VNS Coaching. Une génération complète (surtout depuis une photo) peut à elle seule approcher cette limite sur un compte récent ou peu utilisé.

Pour les coachs qui utilisent déjà un outil IA en ligne de commande ou de bureau (Claude Code, Claude Desktop, OpenAI Codex...) : un serveur MCP permet de créer et modifier des programmes directement depuis cet outil, en langage naturel, avec votre propre abonnement - sans passer par le wizard ni configurer de clé API séparée dans VNS Program Builder.

Le serveur MCP tourne dans son propre environnement Python, séparé du backend VNS. Depuis le dossier d'installation de VNS Program Builder :

cd backend\mcp_server
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

Remplacez <chemin-absolu> par le chemin réel du dossier VNS Program Builder sur votre machine, puis suivez les instructions de l'outil que vous utilisez.

Claude Code - commande à lancer une fois dans un terminal :

claude mcp add vns-program-builder -- "<chemin-absolu>\backend\mcp_server\.venv\Scripts\python.exe" "<chemin-absolu>\backend\mcp_server\server.py"

Claude Desktop - à ajouter dans le fichier de config (claude_desktop_config.json) :

{
  "mcpServers": {
    "vns-program-builder": {
      "command": "<chemin-absolu>\\backend\\mcp_server\\.venv\\Scripts\\python.exe",
      "args": ["<chemin-absolu>\\backend\\mcp_server\\server.py"]
    }
  }
}

OpenAI Codex (CLI) - à ajouter dans le fichier de config (~/.codex/config.toml) :

[mcp_servers.vns-program-builder]
command = "<chemin-absolu>\\backend\\mcp_server\\.venv\\Scripts\\python.exe"
args = ["<chemin-absolu>\\backend\\mcp_server\\server.py"]

Une fois connecté, demandez simplement à votre outil IA de créer ou modifier un programme (« crée un programme hypertrophie 4x/semaine pour Julie, 8 semaines »...) - il utilise les outils exposés par le serveur MCP pour chercher de vrais exercices dans la base VNS et construire le programme via l'API locale. Le résultat apparaît directement dans Mes programmes.

Gmail et Outlook bloquent automatiquement les fichiers .apk. Alternatives recommandées : WhatsApp, Telegram, WeTransfer, Google Drive ou iCloud. Le fichier HTML du journal peut être envoyé par email sans restriction.

Lorsqu'une ou deux annexes sont activées, l'export produit un ZIP. Prévenez le client qu'il doit décompresser l'archive avant d'ouvrir les documents, notamment sur mobile.

Sur Android 8+, la demande d'autorisation des sources inconnues apparaît automatiquement à l'ouverture du fichier APK. Sur les versions antérieures : Paramètres → Sécurité → Sources inconnues.

Pour adapter un programme à un nouveau client, dupliquer depuis Mes programmes plutôt que modifier directement. La copie passe en Brouillon, l'original reste intact et publié.

L'export template exporte la structure (séances, exercices, semaines, consignes) sans données personnelles. L'import est possible dans une autre instance de VNS Program Builder à condition que la base d'exercices soit alignée, sinon certains mouvements peuvent ne pas correspondre correctement.

La base personnalisée est stockée localement. Exportez-la régulièrement depuis les paramètres - en cas de réinstallation, elle serait perdue sans sauvegarde préalable.