Les choix d’ingénierie4 min de lecture
Études de cas techniques
Onze problèmes d’ingénierie rencontrés sur le projet, de la pièce unique vendue sur deux canaux à l’assistant qui ne doit inventer aucun chiffre. Pour chacun, je donne la solution retenue, ce qu’elle a donné et ses limites.
Les autres rubriques décrivent le code tel qu’il est. Ici, je raconte comment on en est arrivé là. Chaque étude part d’un problème où la solution évidente ne suffisait pas. Elles suivent toutes le même plan : le problème, les contraintes, les alternatives, la décision, l’implémentation, les résultats, puis les limites.
Les études
| Étude | Le problème | La décision |
|---|---|---|
| Tenir une pièce pendant un paiement | une pièce unique se vendait deux fois, au magasin et en ligne, pendant que Stripe encaissait | une réservation déduite des commandes en attente, sans table à expirer ni à nettoyer |
| Une date promise qu’on peut tenir | la date de livraison n’était pas calculée pareil d’un écran à l’autre, et ensuite elle bougeait avec les fournisseurs | une règle, la borne haute, une promesse figée au paiement et une vue du maillon qui la menace |
| Des encaissements qui ne se retouchent pas | la loi veut qu’une retouche de caisse se voie, même faite avec tous les droits | une chaîne d’empreintes calculée par la base, vérifiée chaque matin et à chaque migration jouée |
| Un effacement qui survit à une restauration | quand on restaurait une copie, les clients effacés revenaient | un registre d’empreintes hors de la base, rejoué quand on restaure une copie |
| Le site n’a que les droits qu’il lui faut | le site est ouvert à tout Internet et il partage la base de l’ERP | un rôle Postgres dédié, des droits par colonne et des triggers qui vérifient ce qu’il écrit |
| Un ordre dont on ne sait pas s’il est parti | un remboursement sans réponse restait en attente pour toujours, et une relecture périmée écrasait un état plus récent | l’issue inconnue gardée comme un état, des clés tirées du fait annoncé, des états qui ne reculent pas |
| Une veille qui dit ce qu’elle n’a pas pu lire | une commande payée jamais expédiée ou un remboursement oublié ne lèvent aucune erreur | des lectures d’anomalies chaque matin, une rubrique « aveugle » quand une lecture échoue, un témoin extérieur |
| Un assistant qui n’apporte pas les faits | un modèle de langage écrit des chiffres plausibles là où un chiffre engage le magasin | retirer au modèle la possibilité de porter les faits, puis recouper chaque nombre qu’il écrit encore |
| Deux applications nées d’un fork | deux copies d’une même règle de calcul divergeaient sans que rien le signale | des paquets partagés, sortis morceau par morceau, et un contrôle des jumeaux au push |
| Des tests qui lisent le code à la place du relecteur | une action sans garde ou un cache jamais périmé passent le compilateur et les tests ordinaires | des tests qui lisent le code source, portent leurs exceptions écrites et tournent à chaque push |
| Un ERP trop lourd à maintenir | l’ERP grossissait quatre fois plus vite qu’il ne maigrissait | changer la règle d’écriture plutôt que lancer un grand nettoyage |
Comment les lire
- Je cite mes sources. Un fichier ou un symbole (
fichier.ts#SYMBOLE) dit où est la règle. Un commit (git show <hash>) dit quand elle est arrivée et pourquoi. Les extraits de code sont lus dans le dépôt au build de cette doc, comme ceux des pages Compétences et preuves. - Je ne dis qu’une alternative a été écartée que si une trace le montre : un message de commit, un commentaire du code, une décision datée. Les autres, ce sont celles qu’un lecteur se poserait. Elles servent à situer la décision, et je ne prétends pas qu’elles ont été débattues.
- Les chiffres sont datés. Ils décrivent le projet au moment de l’étude, et je donne la méthode de comptage quand elle compte.
- Les limites font partie du résultat. Chaque étude dit ce que la solution ne règle pas et ce qu’il reste à faire.
- Tenir une pièce pendant un paiementLe site et le magasin vendent le même stock, et l’argent arrive par Stripe des minutes ou des jours plus tard. Je raconte comment on évite qu’une pièce unique se vende deux fois, sans table de réservations à faire expirer ni à nettoyer.
- Une date promise qu’on peut tenirUne pièce fabriquée à la commande met plusieurs semaines à arriver. Sa date s’affiche du site au devis, et ensuite elle bouge avec les fournisseurs. Je raconte comment la promesse reste la même partout, se fige au paiement et dit d’avance quel maillon la menace.
- Des encaissements qui ne se retouchent pasLa loi veut qu’un logiciel de caisse rende visible la moindre retouche. Du coup, la base chaîne chaque encaissement au précédent, et voici comment.
- Un effacement qui survit à une restaurationLe droit à l’effacement, la conservation des pièces comptables et la reprise après incident ne vont pas dans le même sens. Il fallait qu’une personne effacée ne revienne pas avec une copie de la base, sans garder son adresse nulle part.
- Le site n’a que les droits qu’il lui fautDeux applications sur la même base, dont une ouverte à tout Internet. Je raconte comment on limite ce qu’une faille du site pourrait faire.
- Un ordre dont on ne sait pas s’il est partiUn remboursement envoyé à Stripe qui reste sans réponse, un e-mail dont Resend n’a rien dit, une vente envoyée deux fois au magasin. Je raconte comment l’ERP traite l’issue inconnue comme un état à part, avec des clés tirées du fait annoncé et des états qui ne reculent pas.
- Une veille qui dit ce qu’elle n’a pas pu lireIl n’y a ni file d’attente ni astreinte, donc rien ne garantit qu’une commande payée soit expédiée ou qu’un remboursement parte. Chaque matin, l’ERP cherche dans ses données ce qui ne devrait pas durer, et il fait la différence entre « rien à signaler » et « je n’ai pas pu regarder ».
- Un assistant qui n’apporte pas les faitsUn modèle de langage écrit des chiffres plausibles. Dans un ERP, un chiffre engage l’argent, la loi ou une promesse faite au client. Du coup, Fisher rédige, lit et répond sans que le modèle fournisse un seul fait.
- Deux applications nées d’un forkLe site est parti d’une copie allégée de l’ERP. Je raconte comment on empêche deux copies d’une même règle de calcul de diverger, sans tout réécrire d’un coup.
- Des tests qui lisent le code à la place du relecteurUne action serveur sans garde, une écriture qui oublie de périmer son cache, un état écrasé par un geste concurrent. Un test ordinaire ne voit aucune de ces erreurs. Du coup, des règles d’architecture sont devenues des tests qui lisent le code source et bloquent le push.
- Un ERP trop lourd à maintenirUn ERP de 600 000 lignes, dont la moitié de tests, construit vite avec l’IA. Il grossissait quatre fois plus vite qu’il ne maigrissait. Il n’y a pas eu de grand nettoyage, c’est la règle d’écriture qui a changé.