Aller au contenu

Tableau de bord

Le coach écrit tout dans votre workspace : séances, nuits, météo, plans, rapports. Le tableau de bord met ces fichiers sous vos yeux : courbe de forme, bilan du matin, semaine planifiée face au réalisé, séances avec leurs splits, prédictions, calendrier — et le texte du coach à côté des chiffres.

Vue « Aujourd'hui » : verdict du coach, bilan du matin, séance du jour et forme

Captures du design roadbook, générées par scripts/docs_capture.py sur le workspace de démonstration d'une athlète fictive (Camille, mardi 29 septembre 2026, à 54 jours du Trail des Crêtes) : aucune donnée réelle.

Il ne remplace pas la conversation avec le coach : il vous montre ce qui est stocké, et c'est d'autant plus précieux quand le coach tourne sans vous — en mode headless, la synchronisation de chaque matin alimente le tableau sans que vous ouvriez une session.

Lancer

scripts/dashboard.sh

Le navigateur s'ouvre sur http://127.0.0.1:8765/. Ctrl+C arrête le serveur. Rien à installer : un serveur Python de la bibliothèque standard et une page HTML/CSS/JS, sans npm ni étape de build.

scripts/dashboard.sh --port 9000   # autre port (défaut : [dashboard].port)
scripts/dashboard.sh --no-open     # sans ouvrir le navigateur
scripts/dashboard.sh --memory      # index en mémoire : aucun fichier écrit
scripts/dashboard.sh --rebuild     # reconstruit l'index de zéro

L'index se met à jour tout seul : un fichier écrit par un agent — la synchronisation du matin, un rapport, un plan — apparaît en 30 secondes au plus, sans relancer le serveur. La réindexation tourne en arrière-plan, jamais pendant une requête : aucune page n'attend. Un passage sans changement ne recalcule pas les métriques, et un passage avec changement ne recalcule que les séances touchées. Au démarrage, la page s'ouvre tout de suite et les données arrivent dès la fin du premier index (une dizaine de secondes sur un long historique avec fichiers FIT).

Après une mise à jour du moteur

Vos données apparaissent seules, mais le code du tableau de bord est chargé au démarrage. Après un git pull du moteur, relancez scripts/dashboard.sh (ou systemctl --user restart arc-dashboard pour le service décrit dans Machine coach & mode headless) ; en conteneur, reconstruisez l'image (Mettre à jour).

Visite guidée

Chaque vue répond à une question. Un clic sur une carte ouvre sa description détaillée : comment la lire, d'où viennent ses données, que faire si elle est vide.

  • Aujourd'hui

    Aujourd'hui · Je cours, j'allège ou je me repose ?

    Le verdict du coach et sa raison, le bilan du matin situé sur votre référence, la séance du jour avec sa météo.

  • Forme & charge

    Forme & charge · Où en est ma forme ?

    Condition, fatigue et forme sur des mois, le ratio de charge, le volume de chaque semaine.

  • Analyse · Ma technique et ma durabilité progressent-elles ?

    Polarisation 80/20, découplage aérobie, VAM, efficacité en descente, durabilité et segments de montée — tout ce qui vient des échantillons FIT téléchargés par le skill fit-download.

  • Santé

    Santé · Comment mon corps encaisse-t-il ?

    HRV, FC de repos, readiness et sommeil en tendance, avec la frise des verdicts du coach jour par jour.

  • Semaine

    Semaine · Qu'est-ce qui était prévu, qu'est-ce qui a été fait ?

    Le plan du coach face au réalisé, jour par jour, statut et météo compris — et les semaines à venir.

  • Détail d'une séance

    Séances · Comment ça s'est passé ?

    Tout l'historique, triable ; pour chaque séance, les chiffres clés, les splits et l'analyse complète du coach.

  • Performance

    Performance · Que puis-je viser ?

    VO2max estimée, temps prédits pour votre objectif, records au kilomètre — et toutes les hypothèses.

  • Matériel

    Matériel · Mon matériel est-il en état ?

    Kilométrage de chaque paire, équipement et kits, inspections photo, et une fiche par paire (bilan de carrière, kilomètres par mois, séances).

  • Trail Shape

    Trail Shape · Suis-je prêt pour mon objectif ?

    Un score sur 100 : volume, plus longue sortie et D+ des huit dernières semaines face aux exigences de la course — chaque composante détaillée, jamais un verdict.

  • Calendrier

    Calendrier · Suis-je régulier ?

    L'année en carte de chaleur et le cumul de distance comparé d'une année à l'autre.

  • Décisions · Pourquoi cette séance a-t-elle changé ?

    Le journal de chaque ajustement du coach — bilan matinal, garde-fou, blessure, météo, demande de l'athlète — avec ce qui l'a justifié, filtrable par déclencheur.

  • Rapports

    Rapports · Qu'en a conclu le coach ?

    Bilans hebdomadaires, validations, comparaisons de parcours et analyses de course, lisibles sans ouvrir l'IDE.

  • Coach

    Coach · Je garde ma séance ?

    Le chat avec le coach, s'il est activé : mêmes agents et skills qu'en IDE, trace de chaque étape, et votre accord avant toute écriture sur Garmin.

S'y ajoutent la vue Nutrition, si le nutritionniste fait partie du staff, et la liste des fichiers hors contrat. Toutes les vues suivent le thème sombre et tiennent sur un téléphone : captures.

Au quotidien

Le tableau de bord ne pose pas de questions : il montre ce que le coach a écrit. Quelques habitudes suffisent pour qu'il soit toujours à jour.

Quand Ouvrir Ce qu'on y cherche
Le matin Aujourd'hui Le verdict et la séance du jour. Pas de verdict ? Demandez au coach « je cours aujourd'hui ? » : il fait le bilan, tranche et l'écrit.
Après une séance Séances → détail Les splits, la FC, l'analyse du coach — une fois la séance synchronisée.
Le dimanche Semaine, Forme & charge Le réalisé face au plan, la tendance de forme. Puis, avec le coach, le plan de la semaine suivante.
Quand le coach planifie Semaine Que chaque semaine du plan est bien lisible : un fichier planning/Semaine_<lundi>.md par semaine, ou un seul fichier multi-semaines (weeks[], #69) — les deux formes s'affichent semaine par semaine.
Avant une course Performance, Rapports Les temps prédits, le plan de course du stratège.

Avec une machine coach, la synchronisation de chaque matin fait le premier pas pour vous : le bilan et la séance de la veille sont déjà là quand vous ouvrez la page.

Le détail de chaque vue, captures à l'appui : Les vues.

Il suit votre configuration : sur route, le dénivelé disparaît et le volume se compte en kilomètres ; avec [health].morning_check = "off", la vue Santé l'indique au lieu d'afficher des trous ; sans nutritionniste dans le staff, la vue Nutrition n'apparaît pas ; en unités impériales, tout s'affiche en miles.

Le design roadbook

Depuis la version 1.4, le tableau de bord s'ouvre sur le design roadbook : la saison s'y lit comme le roadbook d'une course. En haut, le profil du bloc : une colonne par semaine jusqu'au jour de course, la hauteur pour le volume prévu, le plein pour le réalisé, les phases en sections et un repère « vous êtes ici ». Survolez ou parcourez-le au clavier : chaque semaine se raconte, un clic l'ouvre. Dessous, le jour se lit comme une feuille de ravito : le verdict du coach en grand, la séance remplacée barrée, puis le bilan du matin en lignes de barrière (valeur, référence, état en forme et en mot, jamais la couleur seule).

Le nouveau roadbook

En vidéo · Étape 24 · 1 min 43

Le nouveau roadbook — Le tableau de bord se lit comme le roadbook d'une course : profil du bloc, feuille de ravito du jour avec le verdict en grand, semaine sur une ligne par séance, navigation rail ou barre du bas, application installable, données qui restent chez vous.

Regarder · English · Toutes les vidéos

Dans la vue Semaine, prévu et réalisé tiennent sur une ligne par séance : la séance planifiée, l'activité qui lui a été appariée juste dessous (lien, distance, D+, FC moyenne), la durée « prévu → réalisé » et un statut — Faite, Écourtée (moins de 80 % de la durée prévue), Allongée (plus de 125 %), Manquée, À faire, Prévue. Une activité qu'aucune séance n'a appariée apparaît à part, Hors plan. L'appariement est celui de la conformité, calculé par le serveur : la vue et le bloc Conformité ne peuvent pas se contredire. Les seuils sont une approximation du projet.

  • Par défaut : tout le monde est passé au roadbook, y compris ceux qui avaient choisi l'ancien design pendant l'essai.
  • Revenir temporairement à l'ancien design : « Ancien design (jusqu'à la 1.5) », en bas du menu des sections, ou ajoutez ?design=classic à l'adresse. Un avis rappelle alors que l'ancien design disparaîtra avec la version 1.5.
  • Retrouver le roadbook : le lien de cet avis, ou ?design=roadbook (l'ancien ?design=beta fonctionne aussi) ; le choix de l'ancien design est alors oublié.
  • Le choix de l'ancien design est mémorisé par navigateur : votre téléphone et votre ordinateur peuvent avoir chacun le leur.
  • Suppression : l'ancien design et son lien disparaîtront avec la version 1.5.

Les vues Aujourd'hui et Semaine sont redessinées ; les autres gardent leur contenu et prennent l'habillage du roadbook. Sur téléphone, une barre en bas donne Aujourd'hui, Semaine, Santé, Coach (ou Course, sans le chat) et toutes les sections ; sur ordinateur, un rail les range par groupes.

L'ancien design en vidéo : la visite de l'étape 05, tournée avant la 1.4, montre le tableau de bord tel qu'il était avant le roadbook.

Tour du propriétaire

En vidéo · Étape 05 · 1 min 29

Tour du propriétaire — Visite guidée du tableau de bord local, en lecture seule : une question par vue (ancien design, avant la 1.4).

Regarder · English · Toutes les vidéos

Installer l'application (PWA)

Le tableau de bord s'installe comme une application : icône sur l'écran d'accueil, plein écran, sans barre d'adresse. Avec le roadbook comme avec l'ancien design.

  • Sur l'ordinateur : scripts/dashboard.sh, puis l'icône d'installation de la barre d'adresse (Chrome, Edge) ou Fichier → Ajouter au Dock (Safari).
  • Sur le téléphone : il faut l'adresse HTTPS du déploiement derrière un reverse proxy — le serveur local n'écoute que sur 127.0.0.1, que le téléphone n'atteint pas. Puis Partager → Sur l'écran d'accueil (iPhone) ou Installer l'application (Android).

Hors ligne, l'application s'ouvre encore, mais sans données : le cache ne garde que la coque (pages, styles, scripts, icônes). Les données de santé et de séances ne sont jamais mises en cache par le navigateur ; elles sont relues au serveur à chaque ouverture. Derrière Authentik, une page de connexion n'est jamais gardée à la place de l'application.

D'où viennent les chiffres

Les agents ouvrent chaque fichier par un petit bloc de données — le contrat de données. Le tableau de bord lit ces blocs, jamais la prose, et les range dans une base SQLite dérivée : .arc/coach.db dans votre workspace. Elle est jetable : la supprimer ne perd rien, elle se reconstruit depuis vos fichiers. Elle est ignorée par git.

Les indicateurs de forme sont calculés, pas demandés au modèle : le coach observe et juge, le code compte.

  • Charge d'une séance : TRIMP de Banister (FC moyenne, FC max et FC de repos du profil), ou effort perçu faute de fréquence cardiaque.
  • Condition, fatigue, forme : la condition et la fatigue sont des moyennes exponentielles de la charge sur 42 et 7 jours ; la forme est leur écart.
  • VO2max effective et prédictions : estimées à partir de l'allure et de la FC moyennes des séances de course. Des ordres de grandeur, pas des mesures ; la vue Performance liste toutes les hypothèses.

Renseignez votre profil

Sans FC max ni FC de repos de référence dans planning/Runner_Profile.md, la charge est estimée d'après l'effort perçu. Ajoutez-les (et la FC au seuil si vous la connaissez) : toutes les courbes en profitent.

Vos fichiers d'avant

Si votre workspace existait avant le contrat, le tableau de bord lit déjà vos anciens fichiers, au mieux, et signale ceux qu'il comprend mal (« fichiers hors contrat » dans le menu). Pour tout remettre d'aplomb : Migrer vos fichiers.

Sécurité

  • Le serveur n'écoute que sur 127.0.0.1 : rien n'est visible depuis le réseau. scripts/dashboard.sh n'offre aucun moyen d'en changer.
  • Lecture seule : il n'écrit que sa propre base, dans .arc/.
  • Une page tierce qui tenterait de l'atteindre en se faisant passer pour localhost est refusée (protection contre le DNS rebinding).
  • Vos données ne quittent pas la machine. Les polices de caractères (Inter, Sora, et Barlow Condensed pour le roadbook) sont servies par le tableau de bord lui-même, depuis web/fonts/ (licence SIL OFL 1.1) : aucun appel à Google Fonts, et l'application installée les garde hors ligne. Une seule ressource vient de l'extérieur : les tuiles du fond de carte de la page séance (OpenTopoMap par défaut) : le serveur de tuiles voit la zone affichée, jamais la trace ni la séance. Pour n'en charger aucune, posez map_tiles = "" dans la section [dashboard] de config/workspace.user.toml et relancez le tableau de bord : la trace s'affiche alors sur un fond uni.

Pour le consulter depuis une autre machine, passez par un tunnel SSH plutôt que d'ouvrir un port : voir Machine coach & mode headless. Si votre serveur a déjà un reverse proxy avec authentification, le tableau de bord peut s'y ranger en conteneur, workspace en lecture seule : Derrière un reverse proxy (Docker).