Coach as Code — Plan Marathon
English version
Application web installable (PWA) qui affiche le plan d'entraînement hebdomadaire pour le Marathon du P'tit Train du Nord (04/10/2026, objectif 3h55–3h59). C'est une page unique, sans backend ni build, pensée pour être consultée depuis un téléphone, y compris hors connexion.
Démo en ligne : DEMO.
Fonctionnalités
- 16 semaines de plan (S1 à S16), regroupées par semaine, dépliables au clic.
- Chaque séance affiche : type d'effort (EF, seuil, fractionné, sortie longue…), statut (réalisée / à venir / substituée), distance, météo, répartition des segments, métriques (FC, cadence, D+…) et un commentaire d'analyse.
- Bouton « Tout déplier / Tout réduire » pour parcourir rapidement l'ensemble du plan.
- Interface responsive, optimisée mobile.
- Fonctionne hors ligne grâce à un service worker qui met en cache l'application après la première visite.
- Installable sur l'écran d'accueil (Android et iOS) comme une vraie app, sans passer par un store.
Structure du projet
.
├── index.html # Application complète (structure, style, données du plan, logique d'affichage)
├── manifest.json # Manifeste PWA (nom, icônes, couleurs, mode standalone)
├── service-worker.js # Mise en cache des fichiers pour le mode hors ligne
└── icons/
├── icon-192.png
├── icon-512.png
└── icon-512-maskable.png
Aucune dépendance, aucun build : tout est en HTML/CSS/JS natif dans index.html.
Déployer sur GitHub Pages
Le déploiement est automatisé par le workflow .github/workflows/deploy-pages.yml : à chaque push sur main, GitHub Actions publie le contenu du dépôt sur GitHub Pages (aucun build, la page est servie telle quelle).
- Au premier déploiement, GitHub configure automatiquement la source Pages sur « GitHub Actions » (visible ensuite dans Settings → Pages).
- Si ce n'est pas le cas, il suffit d'aller dans Settings → Pages → Build and deployment → Source et de sélectionner GitHub Actions.
- L'avancement du déploiement se suit dans l'onglet Actions du dépôt.
- Une fois terminé, l'app est disponible à l'adresse :
https://<ton-pseudo-github>.github.io/coach-as-code/
Installer l'app sur son téléphone
Une fois la page publiée, ouvre l'URL depuis le navigateur de ton téléphone puis :
Android (Chrome) :
Menu ⋮ → « Installer l'application » (ou « Ajouter à l'écran d'accueil »).
iPhone / iPad (Safari) :
Bouton Partager (icône carrée avec une flèche) → « Sur l'écran d'accueil ».
L'icône apparaît alors comme une app native, s'ouvre en plein écran (sans barre d'adresse) et reste consultable même sans réseau grâce au cache du service worker.
⚠️ Le PWA doit être servi en HTTPS pour être installable — c'est le cas par défaut avec GitHub Pages.
Développement / test en local
Comme un service worker exige un serveur (pas de file://), lance un petit serveur local à la racine du projet :
python3 -m http.server 8080
# puis ouvrir http://localhost:8080
Mettre à jour le plan
Les données de chaque semaine et séance sont définies directement dans le tableau weeks en JavaScript, dans index.html. Pour ajouter une séance réalisée ou ajuster une semaine à venir, il suffit d'éditer les entrées correspondantes (statut done/todo/warn, distance, métriques, commentaire) puis de committer/pousser — GitHub Pages republie automatiquement le changement.
Pense à incrémenter CACHE_NAME dans service-worker.js (ex. plan-marathon-v2) après une mise à jour du contenu, pour forcer le rafraîchissement du cache sur les appareils qui ont déjà installé l'app.
Licence
MIT — voir LICENSE.
