Un bouton qui tourne à l'infini. Un message d'erreur affiché à côté du résultat. Un menu ouvert sur une page qui n'existe plus. Ces écrans ont une cause commune, et un remède plus vieux que le web. Voici comment L'Oûy, le viewer 3D du relief wallon architecturé par Alan Hortz, l'applique du premier au dernier écran.
Votre interface peut mentir
La plupart des interfaces sont pilotées par des drapeaux : isLoading, hasError, isOpen. Chacun paraît inoffensif. Ensemble, ils se multiplient : trois drapeaux donnent huit combinaisons, cinq en donnent trente-deux.
Vous n'en avez dessiné que quatre ou cinq. Les autres existent quand même : « en chargement » et « en erreur », « connecté » et « sans utilisateur ». Personne ne les a décidées, donc personne ne les a testées. C'est là que vivent les bugs que l'on n'arrive pas à reproduire.
Cinq drapeaux, c'est trente-deux écrans possibles. Vous n'en avez dessiné que quatre.
Un feu de signalisation n'est jamais rouge et vert
Une machine à états part du principe inverse. On ne décrit pas des drapeaux : on dresse la liste finie des situations possibles, et le système se trouve toujours dans une seule d'entre elles. Un feu est rouge, orange ou vert. Il n'existe pas de case « rouge et vert » à cocher par erreur.
Trois mots suffisent :
- Un état : une situation qui porte un nom. « En chargement », « affiché », « en panne ».
- Un événement : ce qui arrive. Un clic, une réponse du serveur, un délai écoulé.
- Une transition : la règle qui dit, depuis tel état, où mène tel événement.
Tout le reste en découle. Un événement que l'état courant n'attend pas est simplement ignoré. L'état impossible n'est pas interdit par un test : il n'a pas de nom, donc il n'existe pas.
Le terrain d'essai : la Wallonie entière, en 3D, dans un navigateur
L'Oûy (« l'œil », en wallon) dessine le relief de la Wallonie en nuage de points à partir des relevés LiDAR publics du Service public de Wallonie. On y survole le territoire, on compare deux campagnes de mesure, on consulte 211 caméras routières, on rejoint l'un des 2 928 sites touristiques, on partage la vue exacte que l'on a sous les yeux.
Derrière l'écran, presque tout est asynchrone et rien n'est garanti : des tuiles de relief qui arrivent dans le désordre, des services tiers qui saturent, un téléphone qui reprend la carte graphique sans prévenir. C'est le terrain idéal pour une soupe de drapeaux.
Alan Hortz a fait le choix inverse : toute la logique applicative tient dans 13 machines à états, écrites avec XState, soit environ 1 700 lignes. Une machine par responsabilité : la scène affichée, les caméras, la recherche de sites, le partage, le journal local, et ainsi de suite.
Une machine se lit comme une phrase
Prenons la plus récente, celle du calque « Imagerie 3D », qui pose sur la carte des lieux reconstruits à partir de vidéos de drone. Elle connaît quatre situations, et pas une de plus :
probing: le site publie-t-il des lieux en 3D ?absent: non. Le calque n'est même pas proposé.hidden: oui. Un marqueur les signale sur la carte.shown: ils sont affichés, la caméra tourne autour.
Et voici le code réel, tel qu'il tourne en production :
hidden: {
entry: 'markIdle',
on: {
'scans.toggled': { target: 'shown', actions: 'focusFirst' },
'scans.picked': { guard: 'picksKnownScan', target: 'shown', actions: 'focusPicked' },
},
},
shown: {
entry: ['show', 'markShown', 'fly'],
exit: 'hide',
on: {
'scans.toggled': 'hidden',
'scans.picked': { guard: 'picksKnownScan', actions: ['focusPicked', 'markShown', 'fly'] },
},
},
Lisez-le à voix haute. Depuis hidden, un clic sur un marqueur connu mène à shown. En entrant dans shown, on dessine, on marque, on emmène la caméra. En sortant, on efface. Aucun if (visible && loaded && !error).
Et dans absent ? Un clic ne fait rien. Pas parce que quelqu'un a pensé à l'interdire : parce que cet état n'écoute rien.
Un chef d'orchestre, et des musiciens qui ne se parlent pas
Treize machines qui s'appellent entre elles redeviendraient vite une pelote. La règle de L'Oûy est stricte : aucune machine n'en connaît une autre. Chacune annonce ce qui lui arrive à une machine parente, la machine applicative, qui décide qui doit être prévenu.
Quand la vue se pose sur un nouveau lieu, la machine applicative prévient les noms de lieux, les caméras et la datation du relief. Pour savoir ce qui se passe « quand le visiteur fait ceci », il y a un seul fichier à lire.
Chaque interaction se lit à un seul endroit.
Trois bénéfices obtenus presque gratuitement
1. Le téléphone qui reprend la carte graphique
Sur mobile, le système peut retirer le contexte graphique à une page passée en arrière-plan. La machine du viewer a un état pour cela, suspended. Elle y entre, attend, puis revient à live. Comme elle a mémorisé tout ce qu'on lui a demandé d'afficher, la scène, les calques et le point de vue reviennent tels quels.
2. Un journal complet, sans une ligne de journalisation
Puisque tout est événement, il suffit d'un seul observateur branché sur la machine racine pour tout voir passer. L'Oûy garde ainsi trente jours d'historique, compressé, dans le navigateur du visiteur et nulle part ailleurs. Aucune machine n'a eu à « penser à journaliser ».
3. Des tests qui racontent une histoire
Tester une machine, c'est lui envoyer des événements et regarder où elle arrive. Les 107 tests automatisés du projet portent des noms comme « un clic sur un marqueur affiche les scans et emmène la caméra à celui-là ». Ils se lisent comme un cahier des charges.
Ce que ça coûte, honnêtement
- Plus de code au départ. Pour un écran simple, un drapeau reste plus court. La machine devient rentable quand les situations se multiplient.
- Un vocabulaire à apprendre. État, événement, garde, acteur : toute l'équipe doit le partager.
- De la discipline sur les noms. Une situation mal nommée est une situation mal comprise.
- Tout n'est pas une machine. Dans L'Oûy, ce qui change à chaque image, comme l'altimètre ou le rendu, reste hors des machines. Elles décident, le moteur de rendu exécute.
Par où commencer lundi matin
- Choisissez l'écran qui vous vaut le plus de tickets.
- Listez ses situations et donnez un nom à chacune. Une situation que vous n'arrivez pas à nommer est probablement un bug.
- Pour chaque situation, notez les événements qu'elle accepte, et où ils mènent.
- Dessinez le tout avant d'écrire une ligne.
- Commencez par une machine, pas par treize.
Une interface qui ne peut plus mentir
Les machines à états ne rendent pas le code plus malin. Elles le rendent incapable de se trouver dans une situation que personne n'a décidée. C'est moins spectaculaire qu'un nouveau framework, et nettement plus reposant en production.
L'Oûy est un logiciel libre : son code est ouvert, machines comprises. Le résultat se juge à l'usage, sur louy.be. Et vous, quel écran de votre produit mériterait qu'on liste enfin ses états ?