Pourquoi réessayer un paiement est dangereux — et la ligne qui résout tout.
La connexion d'un client se coupe en plein paiement, alors son application réessaie le débit —trois fois. Votre code naïf s'exécute trois fois. Le client est débité 3× pour une seule commande, et voilà que c'est vous qui êtes appelé à 3h du matin. Ce bug précis a coûté de l'argent à de vraies entreprises. Rendons-le impossible.
Idempotence : même requête, même effet — peu importe le nombre de fois.
Une opération est idempotent quand le faire une fois et le faire dix fois vous mènent au même endroit. L'astuce : donnez à chaque requête un identifiant clé, souvenez-vous des clés déjà traitées, et faites en sorte qu'une clé répétée soit sans effet. Les nouvelles tentatives deviennent sûres.
Voici le code cassé charge(). Exécutez-le — il facture trois fois. Puis ajoutez la protection pour qu'une clé répétée ne fasse rien, et exécutez à nouveau. Du vrai Python, qui s'exécute ici même.
Le vert signifie 3 nouvelles tentatives → 1 facturation. Vous n'avez pas lu sur l'idempotence — vous l'avez implémentée, et une vérification l'a confirmé. C'est chaque leçon Sage : un modèle mental, un diagramme, et une preuve qu'un sceptique peut exécuter. Pas de quiz auto-évalué, pas de « je pense avoir compris ».
C'était une leçon. Il y en a des centaines de plus.
Chacune se termine par une preuve comme celle-ci et s'accumule dans un portfolio qu'un responsable du recrutement peut exécuter.