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.

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 · 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 · 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é · 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 · 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.
-
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 · Que puis-je viser ?
VO2max estimée, temps prédits pour votre objectif, records au kilomètre — et toutes les hypothèses.
-
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 · 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 · 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 · Qu'en a conclu le coach ?
Bilans hebdomadaires, validations, comparaisons de parcours et analyses de course, lisibles sans ouvrir l'IDE.
-
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 — 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.
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=betafonctionne 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 — Visite guidée du tableau de bord local, en lecture seule : une question par vue (ancien design, avant la 1.4).
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.shn'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
localhostest 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, posezmap_tiles = ""dans la section[dashboard]deconfig/workspace.user.tomlet 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).












