Cadence

Anciennement Allure : le dépôt, les clés de stockage local (allure_…) et les données Firebase gardent ce nom, rien n'est à migrer.

App sport (PWA installable sur iPhone) : courses, phases d'entraînement et mesures (poids, FTP vélo, mensurations).

Navigation : Zoom

Un seul calendrier, quatre échelles, choisies en haut (Année, Mois, Semaine, Jour) ou d'un geste : écarter deux doigts plonge vers l'endroit touché, pincer recule (sur ordinateur : pincement du trackpad). Toucher un mois, une semaine (S…) ou un jour l'ouvre ; glisser à gauche / à droite (ou ‹ ›, ou glissement horizontal au trackpad) passe à l'année, au mois, à la semaine ou au jour suivant / précédent ; « Aujourd'hui » y revient.

• Année : le bilan (une barre par mois, colorée par les phases, un point par mois avec course ; courses, à venir, terminées, km, € d'inscriptions ; répartition par sport ; liste des courses avec résultat ou J−).
• Mois : phase en cours et prochaine course (mois courant), jours colorés par phase, course en noir, aujourd'hui entouré ; phases du mois (modifier, supprimer) et courses.
• Semaine : conseil de la phase, une ligne par jour.
• Jour : fiche de la course (J−, chiffres, notes, Calendrier .ics, Modifier, Supprimer ; résultat pour une course passée) et de la phase (semaine x sur y, conseil, Modifier, Supprimer), mesures du jour.

Types de phase : le menu « Phase » de l'éditeur (lien « Modifier la liste ») et ⚙︎ › Réglages ouvrent la liste des types : ajouter, renommer (nom et nom court), changer la couleur, la charge (hauteur des barres de l'année) et le conseil, classer dans « Préparation spécifique », réordonner ou retirer. Un type retiré qui sert encore à des phases est seulement masqué du menu : ces phases gardent leur nom et leur couleur.

Barre du bas : Saison (le zoom), Suivi (courbes du poids et de la FTP, mensurations, historiques), Analyse (export RunGap) et Ajouter (course, phase, poids, test FTP, mensurations) : toute nouvelle mesure se saisit depuis Ajouter. Depuis l'échelle Jour, la course ou la phase ajoutée prend la date du jour affiché ; une course enregistrée s'ouvre sur son jour.

Analyse (export RunGap)

Onglet Analyse : « Importer l’export RunGap » lit le CSV complet exporté de RunGap (toutes les séances, tous sports). À chaque mise à jour, on redépose le fichier entier : seules les activités plus récentes que la dernière connue sont ajoutées ; les doublons Suunto / Garmin (départs à moins de 10 min) sont fusionnés. Les activités restent sur l’appareil (allure_activities, ~100 Ko pour 1 200 séances) : le nœud Firebase partagé avec Carnet n’accepte pas de nouvelle tranche.

Deux affichages : Bilan et Plan. En Bilan, la période (menu, ‹ ›) et le sport (menu) restent collés sous l'en-tête au défilement.

Bilan, périodes : Mois, 3 mois, 6 mois, 12 mois, Année, Saison (groupe de phases qui se suivent, coupé après une phase de transition), avec ‹ › pour remonter dans le temps.

• Forme (42 j), fatigue (7 j) et fraîcheur : charge de chaque séance en TRIMP de Banister, estimée depuis la FC moyenne et la durée (l’export ne donne pas le temps par zone). Phases de Cadence en bandeaux, courses en repères.
• Temps, distance, D+ et séances filtrables par sport (puces au-dessus des chiffres ; le graphique de volume suit le filtre). Volume par sport (heures par jour ou par semaine).
• Ski de fond et ski-roue (tous deux « Cross Country Skiing » dans l’export) : ski de fond de novembre à avril si le point le plus bas de la sortie est à 700 m ou plus, ski-roue sinon. Un export importé avant cette règle est remplacé en entier au prochain import (altitude ajoutée).
• Repos : une case par jour, jours de repos par semaine, alerte au-delà de N jours d’affilée sans repos.
• Bilan des phases (h/sem, repos, part en dur, évolution de la forme), jour des courses (forme et fraîcheur le matin), efficacité en course (m par battement), puissance / FC, records (★ record absolu).
• Réglages (bouton « FC ») : FC max, FC de repos, seuil d’alerte, volume de référence du plan, stockés dans objectives.analysis (synchronisés).

Plan (inspiré de Frive) : phase de la semaine choisie (semaine x sur y, objectif et J−, cible et réalisé), volume cible par semaine (référence × facteur de la phase, une semaine sur quatre allégée en foncier et en spécifique ; réalisé superposé, toucher une barre affiche la semaine) et liste des phases en cours et à venir : toucher une phase ouvre sa fiche (dates, type, note, suppression), « Ajouter une phase » en crée une à la main.

Import : séparateur (virgule, point-virgule, tabulation) et encodage (UTF-8, UTF-16) détectés. Une erreur d'affichage d'une vue n'interrompt jamais la synchronisation ni l'import.

Phases automatiques

Ajouter › Phases automatiques (ou ⚙︎ › Réglages) : chaque course à venir est classée Objectif, Préparation (défaut) ou Ne compte pas (aussi dans la fiche de la course, champ « Importance » ; stocké dans objectives.racePriority). Seuls les objectifs placent les phases, à rebours : foncier, spécifique volume puis intensité (6 semaines), affûtage de 7 à 14 jours selon distance et D+ (≥ 60 km ou ≥ 2 500 m D+ : 14 j ; ≥ 21 km ou ≥ 1 000 m : 10 j), récupération après chaque objectif (raccourcie si le suivant est proche) et coupure de 2 semaines après le dernier. « Recalculer à partir du » (aujourd'hui par défaut) : les phases d'avant cette date ne changent pas. Les phases faites à la main (champ origin: 'manual' ; les anciennes sans origin sont manuelles sauf note « Auto · … ») qui touchent la période sont listées, cochées par défaut : une phase cochée reste telle quelle et le plan se place autour (bout de moins d'une semaine rattaché à la phase précédente), une décochée est recalculée. « Appliquer ce plan » (confirmation) : la phase en cours s'arrête la veille ou est prolongée si le plan commence par le même type.

HTML / CSS / JavaScript purs (modules ES), sans build. Issue de la partie sport de Carnet.

Compte

Cadence utilise le même compte que Mon Garage, Ma Maison, Carnet et Mon budget (projet Firebase test-e27e9, connexion e-mail / mot de passe).

• Aucun écran bloquant au démarrage : l'app s'affiche tout de suite avec les données de l'appareil.
• Si aucun compte n'est connecté, l'écran de connexion s'affiche (connexion, « Mot de passe oublié ? », « Créer un compte »), avec « Continuer sans compte » : données sur l'appareil uniquement, sans synchronisation (pastille « Local »). Ce choix est gardé jusqu'à la fermeture de l'app (un rechargement ne redemande pas). Une saisie faite sans compte n'est jamais envoyée : à la connexion, les données du compte remplacent celles de l'appareil (comme dans Carnet).
• La session est partagée avec les autres apps ouvertes dans le même navigateur (même adresse) : connecté dans Mon Garage = connecté dans Cadence. Sur iPhone, chaque app installée sur l'écran d'accueil a son propre stockage : une connexion par app, une seule fois.
• Changement de compte sur l'appareil : les données locales sont vidées avant la synchronisation.
• Firebase injoignable (hors ligne, bloqueur…) : pas d'écran, mode local comme avant.
• Bouton ⚙︎ › Réglages : compte connecté et « Se déconnecter » (ou « Se connecter » sans compte).

Données partagées avec Carnet

Cadence partage le nœud de Carnet users/<uid>/carnet et n'y lit / n'écrit que trois tranches :

• races : courses ;
• objectives.seasonPhases : phases de la saison ;
• objectives.phaseTypes : liste des types de phase, si elle a été modifiée (sinon la liste d'origine) ;
• bodyMetrics : poids, FTP, mensurations.

Les autres données (agenda, tâches, planning de la semaine, garage_alerts, maison_alerts, marqueur migrated…) appartiennent à Carnet et aux autres apps et ne sont jamais réécrites. Une course ou une phase créée dans Cadence apparaît donc aussitôt dans le planning de Carnet.

Reprise de l'ancienne base (automatique, une seule fois)

Au premier instantané du nœud après connexion :

1. le nœud porte le marqueur migrated → fonctionnement normal ;
2. sinon, Cadence lit l'ancienne base publique de Carnet (dashboard---projet, nœud app, délai max 8 s) et copie dans le nouveau nœud toutes les tranches de Carnet (dashboard, notes, theme, families, plans, objectives, races, bodyMetrics) qui n'y sont pas déjà, avec migrated: { from, at, by: 'allure' } ; comme le fait Carnet, l'ancien thème par défaut dark de Carnet est transféré en auto ;
3. ancienne base vide ou injoignable → Cadence n'amorce rien (il ne connaît pas les tranches de Carnet) : les modifications sont refusées avec le message « Ouvrez Carnet une fois pour transférer vos données. », et un nouvel essai a lieu au prochain instantané (dès que Carnet a migré le nœud) ou au retour dans l'app.

Garde-fou d'écriture

Tant que cet appareil n'a pas reçu le nœud (migré) du compte connecté, l'état local peut être vide ou périmé : enregistrer une seule course écraserait la liste complète partagée avec Carnet. Les modifications sont donc refusées, sauf :

• nœud reçu (synchronisation active) ;
• sans compte (données de l'appareil uniquement) ;
• Firebase injoignable sur un appareil déjà synchronisé (rien n'est envoyé) ;
• compte déjà synchronisé sur cet appareil (clé allure_synced_once = uid du compte) : les modifications hors ligne sont envoyées à la reconnexion.

Règles Firebase

Aucune règle à publier : le projet test-e27e9 autorise déjà chaque compte à lire et écrire users/<son uid>/… (tout nouveau nœud y est couvert). database.rules.json contient désormais le verrou de l'ancienne base publique dashboard---projet (.read / .write à false), identique à celui du dépôt Carnet : à publier dans la console Firebase de dashboard---projet une fois que Carnet et Cadence ont migré les données sur tous les appareils. Ne jamais republier l'ancienne version de ce fichier (base lisible et modifiable par n'importe qui).

Apparence

Style minimaliste (anthracite, cartes pleines), couleur Braise (dégradé orangé → rouge vif), également couleur des courses dans le calendrier ; chaque type de phase a sa propre teinte franche (bleu, indigo, violet, magenta, jaune, vert, gris par défaut, modifiable). Bouton ⚙︎ › Réglages : thème Auto (suit le réglage clair / sombre de l'iPhone, par défaut), Sombre ou Clair, mémorisé sur l'appareil. Un ancien choix « Sombre » (ancien défaut) devient « Auto » une seule fois ; « Clair » est conservé. Le thème est appliqué avant le premier rendu (pas de flash). Icône Cadence (icon.svg, déclinée en PNG ; aussi logos/cadence.svg) : trois barres qui montent comme la charge d'entraînement, la blanche pour la coupure avant la course.

Structure

index.html          vue Zoom, Suivi, barre du bas, connexion, feuilles de saisie et Réglages
css/                jetons, composants, vues, allure.css (style, palettes, connexion)
js/core/            store (3 tranches), schéma, saison, dates
js/services/        Firebase (compte, synchro par tranche, migration), stockage local
js/ui/              thème, connexion, modales, pastille de synchro, toasts
js/views/           zoom (calendrier 4 échelles), races, season et phase-types (éditeurs), metrics (Suivi)
js/features/        export calendrier .ics, mannequin des mensurations

Test local

python3 -m http.server 8000

puis http://localhost:8000.