Codificador QR propio en 522 líneas
Incorporé al repositorio un codificador QR — Reed‑Solomon sobre
GF(256), disposición fija de módulos y ocho patrones de máscara — en
522 líneas para evitar una tercera dependencia de ejecución, y lo
verifiqué leyendo la matriz final con un decodificador desarrollado
de forma independiente.
agosto 2026

Situación. Los documentos necesitaban un código QR que enlazara con
la versión en línea. Cualquier biblioteca disponible lo hace, y
adoptar una habría añadido una tercera dependencia en tiempo de
ejecución a un proyecto que se había limitado deliberadamente a dos
— un motor de plantillas y un generador de PDF — con el argumento de
que un generador de documentos debería poder seguir instalándose
dentro de varios años.

Tarea. Había que aceptar la dependencia o implementar el formato, y
verificar que la implementación fuera correcta en lugar de limitarse
a producir algo cuadrado y negro.

Acción. El codificador consta de 522 líneas e implementa las partes
de la especificación que este uso realmente necesita: codificación
en modo byte, corrección de errores Reed‑Solomon sobre el cuerpo de
Galois de 256 elementos con el polinomio generador construido con el
grado requerido, la disposición fija de módulos con sus patrones de
localización, temporización y alineación, la información de formato
y versión y los ocho patrones de máscara de datos evaluados frente a
las cuatro reglas de penalización de la especificación, para elegir
la máscara con menor puntuación y no una fija. La verificación es lo
que hizo defendible la decisión. Probar un codificador contra su
propia lógica no demuestra nada, por lo que la matriz de módulos
terminada vuelve a leerse mediante un decodificador escrito de forma
independiente a partir del orden de lectura de la especificación, y
la prueba verifica que la cadena decodificada sea igual a la
entrada. Eso convierte «produce una imagen plausible» en «produce un
código que se decodifica en la URL correcta», y se comprueba en cada
ejecución, no una sola vez a simple vista con un teléfono.

Resultado. El número de dependencias en tiempo de ejecución se
mantuvo en dos, y el codificador es el único componente incorporado
directamente al código del proyecto. Debe decirse con claridad que
no es una implementación de uso general: admite los modos y
versiones que utilizan los documentos y nada más, y la justificación
honesta es el presupuesto de dependencias, no una afirmación de que
el resultado sea mejor que una biblioteca madura.

Categorías:
1Ingeniería de backend	/es/categories/backend/	engineer.company	70
1Optimización del rendimiento	/es/categories/performance/	engineer.company	70
1Pruebas y control de calidad	/es/categories/testing/	engineer.company	70
1Python	/es/categories/python/	engineer.company	70
1Documentación	/es/categories/documentation/	engineer.company	70

Servicios:
1Arquitectura de plataformas y soluciones	/es/services/platform-architecture/	engineer.company	70
1Desarrollo de backend y API	/es/services/backend-development/	engineer.company	70

hEsta página en la web	URL:https://engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/	engineer.company	70
