Guide d'Utilisation Ekygai
User Guide
1. Introduction
Bienvenue sur Ekygai, la plateforme d'assistance à la prise de décision dans le domaine de la planification et la création de programmes et séances sportifs. Ce guide est destiné aux athlètes, coachs et administrateurs Teams, en offrant une expérience adaptée à chaque profil.
Ekygai est bien plus qu'un simple outil : c'est une solution intégrée qui vous accompagne dans vos décisions d'entraînement en s'adaptant aux besoins de chaque utilisateur. Le concept est inspiré de l'Ikigai japonais, représentant l'harmonie parfaite entre passion, talent, nécessité et motivation.
Nos valeurs sont Équilibre, Passion, Excellence. Nous croyons que le sport repose sur un développement global et durable. Ekygai offre un accompagnement personnalisé où le mental, le physique et la récupération s'alignent pour créer des athlètes plus forts, plus résilients et plus épanouis.
2. Premiers Pas
2.1 Création de votre compte
- •Accédez à la plateforme Ekygai via l'application ou le site web.
- •Inscrivez-vous avec votre e-mail et définissez un mot de passe sécurisé (minimum 12 caractères, avec majuscule, minuscule, chiffre et caractère spécial).
- •Confirmez votre adresse e-mail via le lien reçu.
- •Complétez votre profil : objectifs, niveau sportif, données biométriques.
2.2 Configuration du profil
Votre profil comprend plusieurs sections :
| Section | Contenu | Pour qui |
|---|---|---|
| Identité | Nom, prénom, photo, bio | Tous |
| Contact | E-mail, téléphone, localisation | Tous |
| Biométriques | Âge, sexe, poids, taille, FC repos, FC max, HRV baseline, formule FC | Athlètes |
| Professionnel | Spécialisations, expérience, certifications | Coachs |
| Paramètres | Thème (clair/sombre), langue, fuseau horaire, unités | Tous |
| Sécurité | Mot de passe, historique de connexion | Tous |
| Abonnement | Niveau actuel, mise à niveau | Coachs / Clubs |
2.3 Checklist des premiers pas
- •Configurer votre profil (objectifs, niveau sportif, préférences).
- •Connecter vos capteurs (BLE) et autoriser Apple Health ou Health Connect.
- •Explorer l'interface (Calendrier, Tableau de bord, Chat IA).
- •Créer votre premier objectif et générer un programme.
- •Commencer votre première séance et suivre vos indicateurs.
3. Interface et Navigation
3.1 Espace Athlète
L'interface athlète est organisée autour de plusieurs zones :
- •Dashboard : Vue d'ensemble de votre progression, indicateurs clés et programmes actifs.
- •Calendrier : Planifiez et visualisez vos séances, ajoutez des événements manuels, consultez les séances matérialisées.
- •Objectifs : Créez des objectifs (Performance, Compétition, Musculation) via le wizard de définition.
- •Chat IA : Assistant intelligent pour poser des questions sur votre entraînement et obtenir des recommandations.
- •Profil : Gérez vos informations personnelles, biométriques, paramètres et sécurité.
- •Mon Coach : Gérez votre relation coach-athlète et votre mode de gouvernance.
3.2 Espace Coach
L'interface coach ajoute des outils de supervision :
- •Mes Athlètes : Liste de tous vos athlètes avec statut, gouvernance et indicateurs.
- •Cockpit : Suivi détaillé d'un athlète avec courbes de performance, fatigue et compliance.
- •Coach Pilote : Wizard en 6 étapes pour créer des programmes personnalisés.
- •Groupes : Organisation de vos athlètes en sous-groupes (ex: prépa compétition, récupération).
- •Trajectoire : Visualisation prédictive de la progression basée sur des modèles scientifiquement valides.
3.3 Espace Club / Team
L'interface Club offre une supervision globale :
- •Dashboard Club : Statistiques globales (nombre de coachs, athlètes liés actifs).
- •Gestion Coachs : Inviter, superviser et gérer les coachs de votre structure.
- •Gestion Athlètes : Suivre les athlètes liés à votre structure.
- •Performances collectives : Comparaison des performances entre groupes et détection des tendances.
4. Créer un Objectif
4.1 Le wizard de création
Pour créer un objectif, suivez le wizard en plusieurs étapes :
- •Choisissez votre branche : Performance, Compétition ou Musculation.
- •Définissez les détails : discipline, cible, niveau d'ambition.
- •Configurez vos contraintes : jours disponibles, créneaux horaires, durée max par séance (30-120 min).
- •Définissez la durée du programme : 3 à 52 semaines.
- •Validez et lancez la génération automatique du programme.
4.2 Les 4 branches d'objectifs
| Branche | Exemples | Ce que vous définissez |
|---|---|---|
| Performance | 5K en 20 min, 100 km vélo | Discipline, distance, temps cible, niveau d'ambition |
| Compétition | Marathon en 3h30 | Nom de la compétition, date, temps cible, priorité |
| Musculation | Hypertrophie haut du corps | Sous-objectif, groupes musculaires, expérience |
5. Comprendre votre Programme
5.1 Comment l'IA crée votre programme
Votre programme est généré par plusieurs moteurs intelligents travaillant en synergie :
| Étape | Ce que fait l'IA | Ce que vous obtenez |
|---|---|---|
| Analyse de l'objectif | Décompose votre objectif en sous-objectifs hiérarchiques et détermine la meilleure stratégie | Vos priorités et zones d'intensité cibles |
| Planification | Ordonnance intelligemment vos étapes de progression en respectant les dépendances physiologiques | Un calendrier optimal avec les bonnes priorités au bon moment |
| Structuration | Organise le programme en phases progressives avec des cycles adaptés | Des phases claires avec alternance charge/récupération |
| Sélection des méthodes | Choisit les méthodes d'entraînement et génère les séances concrètes | Des séances détaillées avec exercices, durées et intensités |
| Protection | Applique des règles de sécurité intelligentes en continu | Une progression sûre, sans risque de surentraînement |
5.2 Prévisualisation et matérialisation
- •Après génération, le programme est présenté en prévisualisation avec le détail des phases et étapes.
- •Vous pouvez l'accepter ou demander des ajustements.
- •La matérialisation transforme les séances d'une semaine en événements concrets dans votre calendrier.
- •Chaque séance matérialisée contient : titre, phases (échauffement, coeur, retour au calme), exercices, métriques cibles.
5.3 Évaluation hebdomadaire
Chaque semaine, le système évalue automatiquement votre compliance :
- •Compare les séances planifiées aux séances réalisées.
- •Calcule votre taux de conformité.
- •Déclenche les règles d'ajustement automatiques si nécessaire.
- •Propose des modifications pour la semaine suivante.
6. Utiliser le Calendrier
6.1 Vue d'ensemble
Le calendrier est votre hub central. Il affiche :
- •Les séances planifiées de vos programmes actifs.
- •Les événements manuels que vous créez.
- •Les séances synchronisées depuis votre montre via Apple Health ou Health Connect.
- •Les compétitions et tests prévus.
6.2 Types d'événements
| Catégorie | Types |
|---|---|
| Endurance | Course, Vélo, Natation, Randonnée |
| Renforcement | Musculation, CrossFit, CrossTrain |
| Souplesse/Récupération | Stretching, Yoga, Recovery |
| Compétition | Compétition, Test |
| Autre | Session, PPG, PPS, Réunion, Personnalisé |
6.3 Le debrief de séance
Après chaque séance, remplissez votre debrief pour alimenter l'IA :
| Champ | Échelle | À quoi ça sert |
|---|---|---|
| RPE (Perception de l'effort) | 1-10 | Évaluer la charge réelle de la séance |
| Qualité du sommeil | 1-10 | Adapter votre charge si le sommeil est insuffisant |
| Niveau de stress | 1-10 | Proposer des pauses adaptées si nécessaire |
| Niveau de douleur | 1-10 | Réduire automatiquement la charge en cas de douleur |
| Completion | 0-100% | Mesurer votre taux de réalisation |
7. Modes de Gouvernance
7.1 Les 3 modes
| Mode | Qui décide | Rôle IA | Rôle Coach |
|---|---|---|---|
| IA Autonome | L'athlète + l'IA | Génère et ajuste automatiquement | Aucun (mode par défaut) |
| Collaboratif | Décisions partagées | Suggère des améliorations | Valide les transitions majeures |
| Coach Pilote | Le coach dirige | Calcule, simule, alerte | Crée les programmes, décide des ajustements |
7.2 Comment changer de mode
- •Accédez à la page Mon Coach depuis votre dashboard.
- •Utilisez le sélecteur de gouvernance pour choisir votre mode.
- •Le changement est enregistré dans l'historique d'audit (conformité RGPD).
- •Même en mode Coach Pilote, vous conservez toujours le droit de refuser toute modification.
8. Relation Coach-Athlète
8.1 Établir un lien
- •Le coach envoie une invitation (par e-mail ou ID athlète).
- •L'athlète reçoit l'invitation dans la section Mon Coach.
- •L'athlète accepte l'invitation (consentement RGPD enregistré).
- •Le lien est actif. L'athlète choisit son mode de gouvernance.
8.2 Le wizard Coach Pilote
En mode Coach Pilote, le coach dispose d'un wizard en 6 étapes :
| Étape | Description |
|---|---|
| 1. Confirmation Athlète | Vérification des infos de l'athlète (niveau, discipline) |
| 2. Definition des Phases | Structuration du programme en phases progressives |
| 3. Sélection des Méthodes | Choix des méthodes d'entraînement par phase |
| 4. Volume et Intensité | Definition de la distribution volume/intensité |
| 5. Prévisualisation Trajectoire | Visualisation prédictive basée sur des modèles scientifiquement valides |
| 6. Confirmation et Génération | Validation finale et lancement |
8.3 Terminer un lien
Si vous terminez le lien avec votre coach :
- •Votre gouvernance revient automatiquement à IA Autonome.
- •Vos programmes existants continuent normalement.
- •Le coach n'a plus accès à vos données.
9. Comprendre vos Indicateurs
| Indicateur | Description | Impact |
|---|---|---|
| Charge d'entraînement | Quantifie l'intensité et le volume | Détermine la progression et la charge cible |
| Indicateur de fatigue | Accumulation de fatigue sur plusieurs jours | Déclenche les règles de sécurité si trop élevé |
| RPE (Perception de l'effort) | Évaluation subjective (1-10) | Alimente le calcul de la charge réelle |
| HRV (Variabilité cardiaque) | État du système nerveux autonome | Indicateur de récupération |
| Fenêtre de progression | Moments optimaux pour progresser | Prédiction de votre trajectoire de performance |
| Compliance | Taux de réalisation (%) | Évaluation hebdomadaire et ajustements |
10. Intégrations
10.1 Apple Health / Health Connect
Pour synchroniser vos séances depuis votre montre (Garmin, Fitbit, Apple Watch, Polar, etc.) :
- •Sur Android : installer Health Connect (Play Store) et autoriser EKYGAI à lire les séances.
- •Sur iOS : autoriser EKYGAI à lire les séances depuis Apple Health.
- •Depuis l'app mobile, ouvrir Paramètres > Wearable et déclencher une synchronisation.
- •Les séances (distance, durée, allure, FC, GPS, splits) seront importées automatiquement.
- •Vous pouvez révoquer l'accès à tout moment depuis les réglages système.
10.2 Intégrations futures
L'architecture d'Ekygai est conçue pour accueillir d'autres intégrations : Garmin, Polar, Suunto, fichiers .fit. Ces intégrations seront ajoutées progressivement.
11. EkyBot — Assistant Conversationnel
11.1 Présentation
EkyBot est votre assistant conversationnel intelligent, alimenté par un modèle de langage (LLM) tiers (Anthropic Claude). EkyBot connaît votre contexte sportif — programme actif, objectif, discipline, semaine en cours — pour vous donner des réponses personnalisées.
11.2 Ce que vous pouvez faire avec EkyBot
- •Analyser une séance en détail : demandez à EkyBot de décortiquer une séance (contenu, charge, intensité, ressenti).
- •Faire le bilan d'une semaine : résumé des séances planifiées vs réalisées, compliance, ajustements proposés.
- •Discuter de votre programme : phases à venir, objectifs de chaque étape, logique de structuration.
- •Comprendre vos indicateurs : charge d'entraînement, fatigue, compliance, zones cardiaques.
- •Explorer votre progression : trajectoire, objectifs, stratégie d'entraînement.
- •Obtenir des recommandations : récupération, nutrition post-effort, étirements, ajustement d'objectifs.
11.3 L'interface EkyBot
| Élément | Description |
|---|---|
| Barre latérale | Liste de vos conversations, programmes actifs, et sélection d'athlètes (coachs) |
| Zone de chat | Affichage des messages avec rendu enrichi (listes, gras, titres, etc.) |
| Champ de saisie | Tapez vos messages. Le bouton bascule entre Envoyer et Arrêter pendant la génération |
| Archiver / Supprimer | Gérez vos conversations depuis la barre latérale |
| Exporter | Téléchargez l'intégralité de votre historique en format JSON |
11.4 Mode coach
Les coachs disposent d'un mode dédié pour accompagner leurs athlètes :
- •Sélectionnez un athlète depuis la barre latérale du chat.
- •EkyBot s'adapte automatiquement au contexte de l'athlète sélectionné (programme, progression, indicateurs).
- •Analysez les séances de l'athlète, faites le bilan d'une semaine, ou discutez de la stratégie d'entraînement.
- •L'accès est soumis au lien coach-athlète actif et à la gouvernance en place.
11.5 Confidentialité de vos conversations
- •Vos conversations sont stockées de manière sécurisée sur les serveurs d'Ekygai.
- •Les messages sont envoyés à l'API d'Anthropic pour traitement. Anthropic ne conserve pas vos données au-delà de la requête.
- •Vos conversations ne sont pas utilisées pour entraîner des modèles d'IA tiers.
- •Le contexte d'entraînement transmis ne contient pas de données personnelles identifiantes.
- •Vous pouvez supprimer, archiver ou exporter vos conversations à tout moment.
12. Notifications
Ekygai dispose d'un système de notifications en temps réel qui vous alerte sur :
- •Les invitations coach/club reçues.
- •Les évaluations hebdomadaires de vos programmes.
- •Les ajustements proposés par l'IA.
- •Les transitions de phase de vos programmes.
- •Les rappels de séances.
Configurez vos préférences depuis votre profil.
13. Sécurité et Confidentialité
- •Authentification : Tokens JWT signés avec expiration courte (10 min), renouvelés automatiquement.
- •Mots de passe : Hachage sécurisé selon les standards de l'industrie.
- •Consentement RGPD : Chaque lien coach-athlète enregistre un consentement explicite.
- •Historique d'audit : Les changements de gouvernance sont tracés dans un journal immuable.
- •Rate limiting : Protection contre les tentatives de connexion abusives.
- •Chiffrement : TLS 1.2+ en transit, données sensibles chiffrées au repos.
Pour plus de détails, consultez notre Politique de Confidentialité.
14. Support
14.1 En cas de problème technique
- •Vérifiez votre connexion Internet.
- •Essayez de vous déconnecter puis reconnecter.
- •Videz le cache de votre navigateur.
- •Si le problème persiste, contactez le support par e-mail.
14.2 Ressources complémentaires
- •Consultez la FAQ pour les questions fréquentes.
- •Utilisez le Chat IA pour poser vos questions directement.
- •Contactez le support : support@ekygai.com