Encodeur QR intégré en 522 lignes
Intégré dans le dépôt un encodeur QR — Reed‑Solomon sur GF(256),
disposition fixe des modules et huit masques — en 522 lignes plutôt
que d'ajouter une troisième dépendance d'exécution, puis relu la
matrice finale avec un décodeur écrit indépendamment.
août 2026

Situation. Les documents avaient besoin d'un QR code pointant vers
la version en ligne. Toutes les bibliothèques disponibles le font,
et en prendre une aurait ajouté une troisième dépendance d'exécution
à un projet délibérément limité à deux — un moteur de modèles et un
moteur de rendu PDF — selon l'argument qu'un générateur de documents
doit rester installable des années plus tard.

Tâche. Il fallait soit accepter la dépendance, soit implémenter le
format, et l'implémentation devait être vérifiée comme correcte
plutôt que produire simplement quelque chose de carré et de noir.

Action. L'encodeur compte 522 lignes et implémente les parties de la
spécification réellement nécessaires à cet usage : encodage en mode
octets, correction d'erreurs Reed‑Solomon sur le corps de Galois à
256 éléments avec le polynôme générateur construit au degré requis,
disposition fixe des modules avec motifs de repérage, de
synchronisation et d'alignement, informations de format et de
version, et les huit motifs de masque de données évalués selon les
quatre règles de pénalité de la spécification pour choisir le masque
au score le plus faible plutôt qu'un masque fixe. La vérification
est ce qui a rendu cette décision défendable. Tester un encodeur
contre sa propre logique ne prouve rien ; la matrice de modules
terminée est donc relue par un décodeur écrit indépendamment selon
l'ordre de lecture de la spécification, et le test vérifie que la
chaîne décodée égale l'entrée. Cela transforme « il produit une
image plausible » en « il produit un code qui se décode vers la
bonne URL », et c'est vérifié à chaque exécution plutôt qu'une seule
fois à l'œil avec un téléphone.

Résultat. Le nombre de dépendances d'exécution est resté à deux, et
l'encodeur est le seul composant dont le code est intégré
directement au projet. Il faut dire clairement qu'il ne s'agit pas
d'une implémentation généraliste — il prend en charge les modes et
versions utilisés par les documents, rien d'autre, et sa
justification honnête est le budget de dépendances plutôt qu'une
quelconque prétention à faire mieux qu'une bibliothèque éprouvée.

Catégories:
1Ingénierie backend	/fr/categories/backend/	engineer.company	70
1Optimisation des performances	/fr/categories/performance/	engineer.company	70
1Tests et assurance qualité	/fr/categories/testing/	engineer.company	70
1Python	/fr/categories/python/	engineer.company	70
1Documentation	/fr/categories/documentation/	engineer.company	70

Prestations:
1Architecture de plateformes et de solutions	/fr/services/platform-architecture/	engineer.company	70
1Développement backend et API	/fr/services/backend-development/	engineer.company	70

hCette page sur le Web	URL:https://engineer.company/fr/portfolio/vendored-a-qr-encoder-in-522-lines/	engineer.company	70
