# Notion de cycle (/docs/pro-analytics/cycles) ## Vue d'ensemble [#vue-densemble] Un **cycle** dans FormaPulse est une **période** (date début → date fin) qui sert de cadre logique à un bloc d'entraînement (préparation, compétition, transition…) ou à toute fenêtre temporelle qu'on veut analyser comme un tout. Concrètement : * Côté **planification** : un cycle s'affiche dans le calendrier sous forme de **barre horizontale** colorée qui s'étend du jour de début au jour de fin. * Côté **pro-analytics** : la page **Analyses des cycles** liste les cycles disponibles et les utilise pour analyser ce qui s'est passé pendant leur période (présences, expositions, tags…). Cette page explique : * Comment **créer** un cycle (depuis la planification, pas depuis pro-analytics) * Comment il est **utilisé** dans les autres pages ## Création — depuis la planification [#création--depuis-la-planification] ⚠️ **La création d'un cycle ne se passe pas dans pro-analytics.** Pro-analytics se contente de lister et d'analyser les cycles **déjà créés** dans la planification. ### Étapes [#étapes] 1. Aller sur **Planification**. 2. Dans la sidebar, ouvrir **Cycles de travail > Créer un cycle** (ou équivalent selon la version). 3. Renseigner : * **Titre** (ex: « Préparation championnat », « Récupération hiver », « Stage ») * **Date de début** et **date de fin** * **Couleur** (utilisée pour la barre du calendrier et la pastille dans pro-analytics) * Optionnellement : **équipe(s) concernée(s)**, **sportif(s) concerné(s)**, **tags** 4. Sauvegarder. Le cycle apparaît immédiatement comme une **barre colorée** dans le calendrier de planification, et devient disponible dans **pro-analytics > Analyses des cycles**. ### Modification / suppression [#modification--suppression] * **Modifier** : ouvrir la fiche du cycle depuis le calendrier (clic sur la barre) → édition des champs. * **Supprimer** : action depuis la fiche. ⚠️ Modifier les **dates** d'un cycle déjà analysé dans pro-analytics relance le calcul d'analyse à la prochaine ouverture. ## Comment pro-analytics liste les cycles [#comment-pro-analytics-liste-les-cycles] Dans la sidebar de **Analyses des cycles**, section **Cycles**. Chaque ligne : pastille couleur, titre, dates `dd MMM yyyy - dd MMM yyyy`. Cliquer sélectionne le cycle pour analyse. Les cycles affichés correspondent à l'entité (équipe ou sportif) sélectionnée dans la sidebar. ## Comment pro-analytics analyse un cycle [#comment-pro-analytics-analyse-un-cycle] Quand tu sélectionnes un cycle, FormaPulse : 1. Récupère tous les **événements** (séances, matchs, RDV extra, réunions) dont la date tombe dans la plage du cycle. 2. Filtre par l'entité (équipe ou sportif). 3. Calcule les **expositions** : pour chaque sportif, % de présence par statut, durée par statut, distribution par tag, distribution par type d'événement. 4. Construit la **timeline** : pour chaque sportif, séquence d'événements ordonnés avec leur statut. L'analyse peut prendre quelques secondes la première fois ; un suivi de progression apparaît en haut de l'écran si elle est longue. Les résultats sont mémorisés temporairement, donc rouvrir le même cycle est instantané. L'affichage se fait dans l'onglet **Expositions** de la page Analyses des cycles, voir [Analyses des cycles](/docs/pro-analytics/analyses-cycles) pour le détail des blocs (KPI, présences par statut, distribution des tags/types, timeline, récap). ## Comparaison de cycles A vs B [#comparaison-de-cycles-a-vs-b] ### Activation [#activation] Toggle **Comparer** dans la sidebar de la page Analyses des cycles. Désactivé tant qu'aucun cycle n'est sélectionné. Une fois activé : * Le cycle A reste sélectionné * Le clic suivant sélectionne le cycle B (badge orange) * Un troisième clic remplace B ### Calcul [#calcul] Comparaison automatique entre les expositions des deux cycles : * Variation du nombre total d'événements * Variation de la durée totale * Pour chaque statut : pourcentage A, pourcentage B, écart * Pour chaque sportif : présences par statut avec valeurs A/B et écart * Pour chaque tag : écart de pourcentage * Pour chaque type d'événement : écart de pourcentage ### Affichage [#affichage] 5 cartes KPI en haut — Événements, Durée totale, %Apte, %Adapté, etc. L'écart est **vert** si l'évolution est bonne, **rouge** sinon. Pour les statuts dits négatifs (Arrêt, Discipline, Absence), la convention est inversée (une augmentation de %Absence est rouge). Voir le détail dans [Analyses des cycles](/docs/pro-analytics/analyses-cycles). ## Cas d'usage typiques [#cas-dusage-typiques] ### Analyse d'une préparation [#analyse-dune-préparation] * Cycle : « Préparation championnat 2026 » (1er au 31 août) * Vérifier le **% d'aptes** sur la période, identifier les sportifs qui ont accumulé du temps en `Adapté` ou `Réhab`. * Comparer la distribution **Séances vs Matchs** : ratio attendu pour une prépa typique = beaucoup de séances, peu de matchs amicaux. ### Comparaison saison N vs saison N-1 [#comparaison-saison-n-vs-saison-n-1] * Cycle A : « Phase aller 2025-26 » * Cycle B : « Phase aller 2024-25 » * Voir le **delta de disponibilité** par joueur, le delta de **distribution des tags** (utile pour vérifier si la programmation a évolué comme prévu). ### Décision retour de blessure [#décision-retour-de-blessure] * Cycle « Retour à la compétition » (10 → 24 mars) * Vérifier que le sportif a bien suivi le **plan progressif** (% Adapté décroissant, % Apte croissant, types d'événements évoluant de RDV médical → séance individuelle → séance collective → match). ## Limites actuelles [#limites-actuelles] * Onglets **Questionnaires** et **GPS** de la page Analyses des cycles sont **désactivés** (libellé « Prochainement »). * La comparaison est limitée à **2 cycles** A vs B. * Pas d'export (PDF / Excel). * Pas de notion de **cycle composé** (un cycle parent qui contiendrait plusieurs sous-cycles). ## Aller plus loin [#aller-plus-loin]