home-tcl-dashboard

Un tableau de bord mural des prochains départs TCL (transports en commun de Lyon) pour les arrêts que vous utilisez, servi par un serveur à la maison et affiché en plein écran sur une tablette.

• Accueil : jusqu'à 6 arrêts favoris, avec les comptes à rebours, en temps réel ou d'après l'horaire prévu, et un bandeau pour les alertes trafic sur vos lignes.
• Détail d'un arrêt : les prochains départs et les arrêts suivants de la ligne.
• Alertes : les alertes trafic sur vos lignes, ou sur tout le réseau.
• Gérer mes arrêts : ajouter, réordonner et retirer des favoris, depuis n'importe quel appareil du réseau. Les favoris sont partagés : une seule liste pour toute la maison.
• Parcourir : n'importe quelle ligne sur une carte, avec les départs de chacun de ses arrêts.

Le métro et le funiculaire n'ont pas de temps réel : leurs départs viennent de l'horaire GTFS. Les trams et les bus utilisent le temps réel.

Prérequis

• pixi
• Un compte gratuit data.grandlyon.com avec accès aux jeux de données TCL (le temps réel et les alertes demandent un identifiant).

Installation

pixi install
cp .env.example .env   # puis remplir GDL_USER et GDL_PWD
pixi run serve         # http://localhost:8000

Lancez le serveur depuis la racine du dépôt : il range ses données dans data/ (ignoré par git) :

Le premier démarrage télécharge l'horaire et les pictogrammes, il prend donc un moment. Si Grand Lyon est en panne ensuite, le serveur continue avec ce qu'il a déjà.

La tablette

La cible est une vieille tablette Android avec Firefox 68. Ouvrez http://<serveur>:8000, puis « Ajouter à l'écran d'accueil » pour avoir une application en plein écran. L'affichage s'adapte à toutes les tailles (conçu pour 1024x768, avec une mise en page portrait) et passe en thème nuit de 20h à 7h.

À cause de Firefox 68, le frontend (src/home_tcl_dashboard/static/) est en JavaScript simple, sans étape de compilation, et évite la syntaxe et les API récentes : pas de ?., ??, replaceChildren, :has(), ni de CSS min()/clamp().

Développement

pixi run test          # pytest
pixi run lint          # ruff check
pixi run format-check  # ruff format --check
pixi run typecheck     # mypy
pre-commit install     # lance ruff à chaque commit

Organisation de src/home_tcl_dashboard/ :

Trois couches :

• app.py ne parle que HTTP : il traduit les requêtes en appels au Dashboard, et ses exceptions (NotFound, InvalidFavourites) en erreurs 404 et 422.
• Dashboard ne connaît pas HTTP. Il reçoit l'heure (now) et le client Grand Lyon en paramètres, ce qui permet de le tester sans serveur ni réseau, avec un faux client (tests/fakes.py).
• Les autres modules sont des fonctions pures, que le Dashboard appelle.

Crédits

• Données : SYTRAL Mobilités, via data.grandlyon.com.
• Cartes : Leaflet et les contributeurs d'OpenStreetMap.
• Police : Inter, licence SIL Open Font License (static/fonts/OFL.txt).